- HTTP リクエスト
- パスパラメータ
- リクエストの本文
- レスポンスの本文
- 認可スコープ
- リクエスト
- ReplaceAllTextRequest
- SubstringMatchCriteria
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- TabsCriteria
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- InsertTextRequest
- ロケーション
- EndOfSegmentLocation
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- UpdateTextStyleRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- CreateParagraphBulletsRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- BulletGlyphPreset
- DeleteParagraphBulletsRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- CreateNamedRangeRequest
- DeleteNamedRangeRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- UpdateParagraphStyleRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- DeleteContentRangeRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- InsertInlineImageRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- InsertTableRequest
- InsertTableRowRequest
- TableCellLocation
- InsertTableColumnRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- DeleteTableRowRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- DeleteTableColumnRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- InsertPageBreakRequest
- DeletePositionedObjectRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- UpdateTableColumnPropertiesRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- UpdateTableCellStyleRequest
- TableRange
- UpdateTableRowStyleRequest
- ReplaceImageRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- ImageReplaceMethod
- UpdateDocumentStyleRequest
- MergeTableCellsRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- UnmergeTableCellsRequest
- CreateHeaderRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- HeaderFooterType
- CreateFooterRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- CreateFootnoteRequest
- ReplaceNamedRangeContentRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- UpdateSectionStyleRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- InsertSectionBreakRequest
- DeleteHeaderRequest
- DeleteFooterRequest
- PinTableHeaderRowsRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- WriteControl
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- レスポンス
- ReplaceAllTextResponse
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- CreateNamedRangeResponse
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- InsertInlineImageResponse
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- InsertInlineSheetsChartResponse
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- CreateHeaderResponse
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- CreateFooterResponse
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- CreateFootnoteResponse
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- 試してみる
ドキュメントに 1 つ以上の更新を適用します。
各 request
は、適用される前に検証されます。いずれかのリクエストが有効でない場合、リクエスト全体が失敗し、何も適用されません。
一部のリクエストには replies
が含まれており、適用方法に関する情報を提供します。その他のリクエストで情報を返す必要はありません。それぞれ空の応答が返されます。返信の順序はリクエストの順序と同じです。
たとえば、4 回の更新を指定して batchUpdate を呼び出し、3 番目の更新のみが情報を返すとします。レスポンスには、3 番目のリクエストに対する返信と別の空の返信がこの順序で 2 つ含まれています。
他のユーザーがドキュメントを編集している可能性があるため、変更内容がドキュメントに正確に反映されていない可能性があります。共同編集者による変更にともない、変更内容も変更されることがあります。共同編集者がいない場合は、変更内容がドキュメントに反映されます。いずれの場合も、リクエスト内の更新はアトミックに同時に適用されます。
HTTP リクエスト
POST https://docs.googleapis.com/v1/documents/{documentId}:batchUpdate
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
documentId |
更新するドキュメントの ID。 |
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{ "requests": [ { object ( |
フィールド | |
---|---|
requests[] |
ドキュメントに適用する更新のリスト。 |
writeControl |
書き込みリクエストの実行方法を制御します。 |
レスポンスの本文
documents.batchUpdate
リクエストからのレスポンス メッセージ。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
JSON 表現 |
---|
{ "documentId": string, "replies": [ { object ( |
フィールド | |
---|---|
documentId |
更新が適用されたドキュメントの ID。 |
replies[] |
更新の返信。これは更新と 1 対 1 で対応しますが、一部のリクエストへの返信は空になる場合があります。 |
writeControl |
リクエストの適用後に更新された書き込みコントロール。 |
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
詳細については、承認ガイドをご覧ください。
WriteControl
書き込みリクエストの実行方法を制御します。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド control 。書き込み先となるドキュメントのリビジョンと、そのリビジョンがドキュメントの現在のリビジョンでない場合のリクエストの動作を指定します。どちらのフィールドも指定しない場合、更新は最新のリビジョンに適用されます。control は次のいずれかになります。 |
|
requiredRevisionId |
書き込みリクエストが適用されるドキュメントの 必要なリビジョン ID がレスポンスで返された場合、これはリクエストが適用された後のドキュメントのリビジョン ID を示します。 |
targetRevisionId |
書き込みリクエストが適用されるドキュメントのターゲット API を使用してドキュメントが読み取られた後に共同編集者が変更を加えた場合は、この書き込みリクエストによって生成された変更が共同編集者の変更に対して適用されます。その結果、ドキュメントの新しいリビジョンが作成され、共同編集者による変更とリクエストの変更の両方が組み込まれ、ドキュメント サーバーで競合する変更が解決されます。ターゲット リビジョン ID を使用する場合、API クライアントはドキュメントの別の共同編集者と考えることができます。 ターゲット リビジョン ID は、ドキュメントの最近の版に書き込む場合にのみ使用できます。ターゲット リビジョンが最新のリビジョンから大きく遅れている場合、リクエストは処理されず、400 不正なリクエスト エラーが返されます。ドキュメントの最新バージョンを取得してから、リクエストを再試行する必要があります。通常、リビジョン ID は読み取られてから数分間、ターゲット リビジョンとして有効なままになりますが、頻繁に編集されるドキュメントの場合は、この期間が短くなる可能性があります。 |