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입니다. 요청에서 필드 마스크가 설정된 경우 이 매개변수는 무시됩니다.

요청 본문

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

응답 본문

성공한 경우 응답 본문에 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

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