- HTTP リクエスト
- パスパラメータ
- リクエストの本文
- レスポンスの本文
- 認可スコープ
- リクエスト
- CreateSlideRequest
- LayoutReference
- 事前定義レイアウト
- LayoutPlaceholdIdMapping
- CreateShapeRequest
- PageElementProperties
- CreateTableRequest
- InsertTextRequest
- InsertTableRowsRequest
- InsertTableColumnsRequest
- DeleteTableRowRequest
- DeleteTableColumnRequest
- ReplaceAllTextRequest
- SubstringMatchCriteria
- DeleteObjectRequest
- UpdatePageElementTransformRequest
- ApplyMode
- UpdateSlidesPositionRequest
- DeleteTextRequest
- 範囲
- 型
- CreateImageRequest
- CreateVideoRequest
- CreateSheetsChartRequest
- リンクモード
- CreateLineRequest
- カテゴリ
- RefreshSheetsChartRequest
- UpdateShapePropertiesRequest
- UpdateImagePropertiesRequest
- UpdateVideoPropertiesRequest
- UpdatePagePropertiesRequest
- UpdateTableCellPropertiesRequest
- TableRange
- UpdateLinePropertiesRequest
- CreateParagraphBulletsRequest
- BulletGlyph プリセット
- ReplaceAllShapesWithImageRequest
- ReplaceMethod
- ImageReplaceMethod
- DuplicateObjectRequest
- UpdateTextStyleRequest
- ReplaceAllShapesWithSheetsChartRequest
- リンクモード
- DeleteParagraphBulletsRequest
- UpdateParagraphStyleRequest
- UpdateTableBorderPropertiesRequest
- BorderPosition
- UpdateTableColumnPropertiesRequest
- UpdateTableRowPropertiesRequest
- MergeTableCellsRequest
- UnmergeTableCellsRequest
- GroupObjectsRequest
- UngroupObjectsRequest
- UpdatePageElementAltTextRequest
- ReplaceImageRequest
- UpdateSlidePropertiesRequest
- UpdatePageElementsZOrderRequest
- ZOrderOperation
- UpdateLineCategoryRequest
- RerouteLineRequest
- WriteControl
- レスポンス
- CreateSlideResponse
- CreateShapeResponse
- CreateTableResponse
- ReplaceAllTextResponse
- CreateImageResponse
- CreateVideoResponse
- CreateSheetsChartResponse
- CreateLineResponse
- ReplaceAllShapesWithImageResponse
- DuplicateObjectResponse
- ReplaceAllShapesWithSheetsChartResponse
- GroupObjectsResponse
- 試してみる
プレゼンテーションに 1 つ以上の更新を適用します。
各 request
は、適用前に検証されます。リクエストのいずれかが有効でない場合、リクエスト全体が失敗し、何も適用されません。
一部のリクエストには、その適用方法に関する情報を提供する replies
が含まれています。それ以外のリクエストに対して情報を返す必要はありません。どのリクエストも空の返信を返します。返信の順序は、リクエストの順番と一致します。
たとえば、batchUpdate で 4 つの更新を行い、3 つ目のみに情報を返すとします。このレスポンスでは、2 つの空の返信が返されます。3 番目のリクエストに対する返信、もう 1 つの空の返信です。
他のユーザーがプレゼンテーションを編集しているため、プレゼンテーションに自分の変更内容が正確に反映されない場合があります。たとえば、共同編集者による変更内容が変更されることがあります。共同編集者がいない場合は、プレゼンテーションに変更が反映されます。いずれの場合も、リクエストの更新はアトミックに適用されることが保証されます。
HTTP リクエスト
POST https://slides.googleapis.com/v1/presentations/{presentationId}:batchUpdate
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
presentationId |
更新を適用するプレゼンテーション。 |
リクエスト本文
リクエストの本文には次の構造のデータが含まれます。
JSON 表現 |
---|
{ "requests": [ { object ( |
フィールド | |
---|---|
requests[] |
プレゼンテーションに適用する更新のリスト。 |
writeControl |
書き込みリクエストの実行方法を制御します。 |
レスポンスの本文
バッチ アップデートからのレスポンス メッセージ。
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{ "presentationId": string, "replies": [ { object ( |
フィールド | |
---|---|
presentationId |
更新が適用されたプレゼンテーション。 |
replies[] |
更新情報の返信。これにより、1 対 1 の更新でマッピングされますが、一部のリクエストへの応答は空になる場合があります。 |
writeControl |
リクエストの適用後に更新された書き込みコントロール。 |
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/presentations
https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/spreadsheets.readonly
詳しくは、認可ガイドをご覧ください。
書き込み管理
書き込みリクエストの実行方法を制御します。
JSON 表現 |
---|
{ "requiredRevisionId": string } |
フィールド | |
---|---|
requiredRevisionId |
書き込みリクエストに必要なプレゼンテーションの 必要なリビジョン ID がレスポンスで返されると、リクエスト適用後のドキュメントのリビジョン ID が示されます。 |