Method: spreadsheets.get

지정된 ID의 스프레드시트를 반환합니다. 호출자가 스프레드시트 ID를 지정해야 합니다.

기본적으로 그리드 내 데이터는 반환되지 않습니다. 다음 두 가지 방법 중 하나로 그리드 데이터를 포함할 수 있습니다.

  • HTTP에서 fields URL 매개변수를 사용하여 원하는 필드를 나열하는 필드 마스크를 지정합니다.

  • includeGridData URL 매개변수를 true로 설정합니다. 필드 마스크가 설정되면 includeGridData 매개변수가 무시됩니다.

대용량 스프레드시트의 경우 원하는 특정 스프레드시트 필드만 검색하는 것이 좋습니다.

스프레드시트 데이터의 하위 집합만 검색하려면 ranges URL 매개변수를 사용합니다. 범위는 A1 표기법을 사용하여 지정합니다. 단일 셀 (예: A1) 또는 여러 셀 (예: A1:D5)을 정의할 수 있습니다. 동일한 스프레드시트 내의 다른 시트에서 셀을 가져오거나 (예: Sheet2!A1:C4) 한 번에 여러 범위를 검색할 수도 있습니다 (예: ?ranges=A1:D5&ranges=Sheet2!A1:C4). 범위를 제한하면 요청된 범위와 교차하는 스프레드시트의 부분만 반환됩니다.

HTTP 요청

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

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

경로 매개변수

매개변수
spreadsheetId

string

요청할 스프레드시트입니다.

쿼리 매개변수

매개변수
ranges[]

string

스프레드시트에서 가져올 범위입니다.
includeGridData

boolean

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

boolean

밴딩된 범위에서 테이블을 제외해야 하는 경우 true입니다. 설정되지 않은 경우 false입니다.

요청 본문

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

응답 본문

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

승인 범위

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

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