Method: presentations.batchUpdate

프레젠테이션에 하나 이상의 업데이트를 적용합니다.

각 request는 적용 전에 검증됩니다. 유효하지 않은 요청이 있으면 전체 요청이 실패하고 아무 것도 적용되지 않습니다.

일부 요청에는 적용 방식에 관한 정보를 제공하는 replies가 있습니다. 정보를 반환할 필요가 없는 요청도 있습니다. 각각 빈 답장을 반환합니다. 응답 순서는 요청의 순서와 일치합니다.

예를 들어 4개의 업데이트로 batchUpdate를 호출했는데 세 번째 항목만 정보를 반환한다고 가정해 보겠습니다. 응답에는 두 개의 빈 답장(세 번째 요청에 대한 답장과 이 순서대로 답장)이 있습니다.

다른 사용자가 프리젠테이션을 수정하고 있을 수 있으므로 변경사항이 프리젠테이션에 정확히 반영되지 않을 수 있습니다. 즉, 공동작업자의 변경사항과 관련하여 변경사항이 변경될 수 있습니다. 공동작업자가 없는 경우 프레젠테이션에 변경사항이 반영되어야 합니다. 어떤 경우든 요청의 업데이트는 원자적으로 함께 적용됩니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
presentationId

string

업데이트를 적용할 프레젠테이션입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
필드
requests[]

object (Request)

프레젠테이션에 적용할 업데이트 목록입니다.
writeControl

object (WriteControl)

쓰기 요청 실행 방법을 제어할 수 있습니다.

응답 본문

일괄 업데이트의 응답 메시지입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "presentationId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
필드
presentationId

string

업데이트가 적용된 프레젠테이션입니다.
replies[]

object (Response)

업데이트의 답장입니다. 이렇게 하면 업데이트와 1:1로 매핑되지만 일부 요청에 대한 응답은 비어 있을 수 있습니다.
writeControl

object (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

자세한 내용은 승인 가이드를 참조하세요.

WriteControl

쓰기 요청 실행 방법을 제어할 수 있습니다.

JSON 표현 
{
  "requiredRevisionId": string
}
필드
requiredRevisionId

string

쓰기 요청에 필요한 프레젠테이션의 revision ID입니다. 지정하면 필수 버전 ID가 프레젠테이션의 현재 버전 ID와 일치하지 않으면 요청이 처리되지 않고 400 잘못된 요청 오류가 반환됩니다.

응답에서 필수 버전 ID가 반환되면 요청이 적용된 후 문서의 버전 ID를 나타냅니다.