Method: presentations.batchUpdate

プレゼンテーションに 1 つ以上の更新を適用します。

各 request は、適用される前に検証されます。リクエストが無効な場合、リクエスト全体が失敗し、何も適用されません。

一部のリクエストには、適用方法に関する情報を提供する replies があります。他のリクエストは情報を返す必要がなく、それぞれ空の返信を返します。返信の順序はリクエストの順序と一致します。

たとえば、4 つの更新で batchUpdate を呼び出し、3 つ目の更新のみが情報を返すとします。レスポンスには、3 番目のリクエストへの返信と別の空の返信の 2 つの空の返信がこの順序で含まれます。

他のユーザーがプレゼンテーションを編集している場合があるため、プレゼンテーションに自分の変更内容が正確に反映されないことがあります。共同編集者の変更内容に応じて、自分の変更内容が変更されることがあります。共同編集者がいない場合は、プレゼンテーションに自分の変更が反映されます。いずれの場合も、リクエスト内の更新はアトミックにまとめて適用されます。

HTTP リクエスト

POST https://slides.googleapis.com/v1/presentations/{presentationId}:batchUpdate

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
presentationId

string

更新を適用するプレゼンテーション。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
フィールド
requests[]

object (Request)

プレゼンテーションに適用する更新のリスト。
writeControl

object (WriteControl)

書き込みリクエストの実行方法を制御します。

レスポンスの本文

一括更新からのレスポンス メッセージ。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "presentationId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "writeControl": {
    object (WriteControl)
  },
  "commentUpdateState": enum (CommentUpdateState)
}
フィールド
presentationId

string

更新が適用されたプレゼンテーション。
replies[]

object (Response)

更新の返信。これは更新と 1 対 1 でマッピングされますが、一部のリクエストへの返信は空になることがあります。
writeControl

object (WriteControl)

リクエストの適用後に更新された書き込み制御。
commentUpdateState

enum (CommentUpdateState)

コメントの更新がバッチ リクエストで適用されたかどうか。

認可スコープ

次の 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

詳しくは、承認ガイドをご覧ください。

WriteControl

書き込みリクエストの実行方法を制御します。

JSON 表現 
{
  "requiredRevisionId": string
}
フィールド
requiredRevisionId

string

書き込みリクエストに必要なプレゼンテーションの revision ID。指定された場合、必要なリビジョン ID がプレゼンテーションの現在のリビジョン ID と一致しないと、リクエストは処理されず、400 Bad Request エラーが返されます。

レスポンスで必要なリビジョン ID が返された場合、それはリクエストが適用された後のドキュメントのリビジョン ID を示します。

CommentUpdateState

バッチ リクエストでのコメント更新のステータス。

列挙型
COMMENT_UPDATE_STATE_UNSPECIFIED コメント更新のステータスが指定されていません。
NO_UPDATES_REQUESTED バッチ リクエストでコメントの更新がリクエストされていませんでした。
ALL_SAVED リクエストされたコメントの更新はすべてバッチ リクエストで適用されました。
ALL_FAILED_UNKNOWN_REASON リクエストされたコメントの更新がすべて失敗しました。