Method: spreadsheets.batchUpdate

스프레드시트에 하나 이상의 업데이트를 적용합니다.

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

일부 요청에는 적용되는 방식에 관한 정보를 제공하는 replies가 있습니다. 응답은 요청을 미러링합니다. 예를 들어 4개의 업데이트를 적용했는데 3번째 업데이트에 답장이 있으면 응답에 2개의 빈 답장(실제 답장 및 다른 답장)이 순서대로 표시됩니다.

스프레드시트의 공동작업으로 인해, 변경사항이 완료된 후에도 스프레드시트에 변경사항이 정확히 반영되는 것은 아니며 요청의 업데이트가 원자적으로 함께 적용됩니다. 공동작업자의 변경사항은 변경될 수 있습니다. 공동작업자가 없으면 스프레드시트에 변경사항이 반영되어야 합니다.

HTTP 요청

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate

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

경로 매개변수

매개변수
spreadsheetId

string

업데이트를 적용할 스프레드시트입니다.

요청 본문

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

JSON 표현 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "includeSpreadsheetInResponse": boolean,
  "responseRanges": [
    string
  ],
  "responseIncludeGridData": boolean
}
필드
requests[]

object (Request)

스프레드시트에 적용할 업데이트 목록입니다. 요청은 지정된 순서대로 적용됩니다. 유효하지 않은 요청이 있으면 요청이 적용되지 않습니다.
includeSpreadsheetInResponse

boolean

업데이트 응답에 스프레드시트 리소스를 포함할지 여부를 결정합니다.
responseRanges[]

string

응답 스프레드시트에 포함된 범위를 제한합니다. includeSpreadsheetInResponse가 'true'인 경우에만 중요합니다.
responseIncludeGridData

boolean

그리드 데이터를 반환해야 하는 경우 참입니다. includeSpreadsheetInResponse가 'true'인 경우에만 중요합니다. 요청에 필드 마스크가 설정된 경우 이 매개변수는 무시됩니다.

응답 본문

스프레드시트 일괄 업데이트에 대한 답장입니다.

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

JSON 표현 
{
  "spreadsheetId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "updatedSpreadsheet": {
    object (Spreadsheet)
  }
}
필드
spreadsheetId

string

업데이트가 적용된 스프레드시트입니다.
replies[]

object (Response)

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

object (Spreadsheet)

업데이트가 적용된 후의 스프레드시트입니다. BatchUpdateSpreadsheetRequest.include_spreadsheet_in_response이 true인 경우에만 설정됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

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