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

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