Method: spreadsheets.values.batchGet

스프레드시트에서 하나 이상의 값 범위를 반환합니다. 호출자는 스프레드시트 ID와 하나 이상의 범위를 지정해야 합니다.

HTTP 요청

GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet

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

경로 매개변수

매개변수
spreadsheetId

string

데이터를 가져올 스프레드시트의 ID입니다.

쿼리 매개변수

매개변수
ranges[]

string

값을 검색할 범위의 A1 표기법 또는 R1C1 표기법입니다.

majorDimension

enum (Dimension)

결과가 사용해야 하는 주요 측정기준입니다.

예를 들어 스프레드시트 데이터가 A1=1,B1=2,A2=3,B2=4인 경우 ranges=["A1:B2"],majorDimension=ROWS을 요청하면 [[1,2],[3,4]]를 반환하지만 ranges=["A1:B2"],majorDimension=COLUMNS를 요청하면 [[1,3],[2,4]]를 반환합니다.

valueRenderOption

enum (ValueRenderOption)

출력에 값이 표시되는 방식 기본 렌더링 옵션은 ValueRenderOption.FORMATTED_VALUE입니다.

dateTimeRenderOption

enum (DateTimeRenderOption)

날짜, 시간, 지속 시간이 출력에 표시되는 방식 valueRenderOptionFORMATTED_VALUE이면 무시됩니다. 기본 dateTime 렌더링 옵션은 SERIAL_NUMBER입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

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

스프레드시트에서 두 개 이상의 값 범위를 가져올 때의 응답입니다.

JSON 표현
{
  "spreadsheetId": string,
  "valueRanges": [
    {
      object (ValueRange)
    }
  ]
}
필드
spreadsheetId

string

데이터를 가져온 스프레드시트의 ID입니다.

valueRanges[]

object (ValueRange)

요청된 값입니다. ValueRanges의 순서는 요청된 범위의 순서와 동일합니다.

승인 범위

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

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

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