書き込みオペレーションのバッチを適用します。
document.batchWrite メソッドは書き込みオペレーションをアトミックに適用せず、順番どおりに適用されない場合があります。このメソッドでは、1 つのドキュメントに複数の書き込みを行うことはできません。各書き込みは独立して成功または失敗します。各書き込みの成功ステータスについては、BatchWriteResponse
をご覧ください。
アトミックに適用される一連の書き込みが必要な場合は、代わりに documents.commit
を使用してください。
HTTP リクエスト
POST https://firestore.googleapis.com/v1/{database=projects/*/databases/*}/documents:batchWrite
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
database |
必須。データベース名。形式は |
リクエストの本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{
"writes": [
{
object ( |
フィールド | |
---|---|
writes[] |
適用する書き込み。 このメソッドは、書き込みをアトミックに適用せず、順序を保証するものではありません。各書き込みは独立して成功または失敗します。1 回のリクエストで複数回、同じドキュメントに書き込むことはできません。 |
labels |
このバッチ書き込みに関連付けられているラベル。
|
レスポンスの本文
Firestore.BatchWrite
からのレスポンス。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
JSON 表現 |
---|
{ "writeResults": [ { object ( |
フィールド | |
---|---|
writeResults[] |
書き込みを適用した結果。 この i 番目の書き込み結果は、リクエストの i 番目の書き込みに対応します。 |
status[] |
書き込みの適用のステータス。 この i 番目の書き込みステータスは、リクエストの i 番目の書き込みに対応しています。 |
認可スコープ
以下のいずれかの OAuth スコープが必要です。
https://www.googleapis.com/auth/datastore
https://www.googleapis.com/auth/cloud-platform
詳細については、認証の概要をご覧ください。