Method: spreadsheets.values.get

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

HTTP 요청

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

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

경로 매개변수

매개변수
spreadsheetId

string

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

string

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

쿼리 매개변수

매개변수
majorDimension

enum (Dimension)

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

예를 들어 Sheet1의 스프레드시트 데이터가 A1=1,B1=2,A2=3,B2=4인 경우 range=Sheet1!A1:B2?majorDimension=ROWS를 요청하면 [[1,2],[3,4]]가 반환되지만 range=Sheet1!A1:B2?majorDimension=COLUMNS를 요청하면 [[1,3],[2,4]]가 반환됩니다.
valueRenderOption

enum (ValueRenderOption)

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

enum (DateTimeRenderOption)

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

요청 본문

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

응답 본문

성공한 경우 응답 본문에 ValueRange의 인스턴스가 포함됩니다.

승인 범위

다음 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

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