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
자세한 내용은 승인 가이드를 참조하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-09-05(UTC)
[null,null,["최종 업데이트: 2024-09-05(UTC)"],[[["This Google Sheets API endpoint retrieves a range of values from a specified spreadsheet and range using an HTTP GET request."],["Users need to provide the `spreadsheetId` and `range` as path parameters in the request URL."],["Optional query parameters allow customization of the output, including `majorDimension`, `valueRenderOption`, and `dateTimeRenderOption`."],["The response body, upon successful execution, will contain a `ValueRange` object with the requested data."],["Authorization is required using one of the specified OAuth scopes related to Google Drive or Google Sheets access."]]],["This describes retrieving data from a spreadsheet using a `GET` HTTP request. The request URL includes the `spreadsheetId` and `range` as path parameters. Optional query parameters, like `majorDimension`, `valueRenderOption`, and `dateTimeRenderOption`, allow customization of the returned data. The request body must be empty. The response contains the spreadsheet data in `ValueRange` format if the request is successful. Authentication requires specific OAuth scopes for access.\n"]]