Google Sheets API를 사용하면 셀, 범위, 범위 집합,
할 수 있습니다. 이 페이지의 예시는 일반적인
사용하여
spreadsheets.values
드림
리소스도 제공합니다 또한
spreadsheets.get
메서드를 지원하지만
보통
spreadsheets.values.get
또는
spreadsheets.values.batchGet
더 쉽습니다.
이 예는 언어적 표현인 HTTP 요청의 형식으로 중립적입니다. Google Cloud API를 사용하여 다양한 언어로 읽기를 구현하는 자세한 내용은 읽기 및 셀 쓰기 값을 참조하세요.
다음 예에서 자리표시자 SPREADSHEET_ID는 스프레드시트 ID를 제공합니다. 스프레드시트 URL에서 찾을 수 있습니다. 읽을 범위는 요청에 A1 표기법을 사용하여 지정됩니다. URL입니다. 예시 범위는 Sheet1!A1:D5입니다.
소스 데이터
이 예에서는 읽는 스프레드시트의 소스가 다음과 같다고 가정합니다. 첫 번째 시트('Sheet1')에 첫 번째 행의 문자열은 변경할 수 있습니다. 다른 시트에서 읽는 방법에 대한 예를 보려면 A1 표기법을 참고하세요.
A | B | C | D | |
1 | 항목 | 비용 | 재고 있음 | 배송 날짜 |
2 | 휠 | 20.50달러 | 4 | 2016년 3월 1일 |
3 | 문 | $15 | 2 | 2016년 3월 15일 |
4 | 엔진 | $100 | 1 | 2016년 3월 20일 |
5 | 총계 | 135.5달러 | 7 | 2016년 3월 20일 |
단일 범위 읽기
다음
spreadsheets.values.get
드림
Sheet1!A1:D5 범위에서 값을 읽고
포함할 수 있습니다. 비어있는 후행 행과 열은 생략됩니다.
요청 프로토콜은 다음과 같습니다.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D5
응답은
ValueRange
드림
범위 값을 설명하는 객체입니다. 이
majorDimension
필드
는 배열이 행으로 구성된 값 목록임을 나타냅니다.
{ "range": "Sheet1!A1:D5", "majorDimension": "ROWS", "values": [ ["Item", "Cost", "Stocked", "Ship Date"], ["Wheel", "$20.50", "4", "3/1/2016"], ["Door", "$15", "2", "3/15/2016"], ["Engine", "$100", "1", "30/20/2016"], ["Totals", "$135.5", "7", "3/20/2016"] ], }
열별로 그룹화된 단일 범위 읽기
다음
spreadsheets.values.get
드림
Sheet1!A1:D3 범위에서 값을 읽고
열별로 그룹화합니다. 후행 행과 열이 비어 있음
생략했습니다.
요청 프로토콜은 다음과 같습니다.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D3?majorDimension=COLUMNS
응답은
ValueRange
드림
범위 값을 설명하는 객체입니다. 이
majorDimension
필드
는 배열이 열로 구성된 값 목록임을 나타냅니다.
{ "range": "Sheet1!A1:D3", "majorDimension": "COLUMNS", "values": [ ["Item", "Wheel", "Door"], ["Cost", "$20.50", "$15"], ["Stocked", "4", "2"], ["Ship Date", "3/1/2016", "3/15/2016"] ], }
렌더링 옵션으로 단일 범위 읽기
다음
spreadsheets.values.get
드림
Sheet1!A1:D5 범위에서 값을 읽고
렌더링 옵션을 사용하여 해당 정보가 입력되는 방식을
반환됩니다. 이
ValueRenderOption
설정
의 FORMULA
는
계산된 값과
DateTimeRenderOption
SERIAL_NUMBER
는 날짜를 숫자로 반환해야 함을 나타냅니다.
다른 설정도 가능합니다. 후행 행과 열이 비어 있음
생략했습니다.
요청 프로토콜은 다음과 같습니다.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D5? valueRenderOption=FORMULA&dateTimeRenderOption=SERIAL_NUMBER
응답은
ValueRange
드림
범위 값을 설명하는 객체입니다. 이
majorDimension
필드
는 배열이 행으로 구성된 값 목록임을 나타냅니다.
{ "range": "Sheet1!A1:D5", "majorDimension": "ROWS", "values": [ ["Item", "Cost", "Stocked", "Ship Date"], ["Wheel", "$20.50", "4", "42430"], ["Door", "$15", "2", "42444"], ["Engine", "$100", "1", "42449"], ["Totals", "=SUM(B2:B4)", "=SUM(C2:C4)", "=MAX(D2:D4)"] ], }
여러 범위 읽기
다음
spreadsheets.values.batchGet
드림
Sheet1!B:B 및 Sheet1!D:D 범위에서 값을 읽는 방법과
응답으로 반환합니다. 이
ValueRenderOption
설정
의 UNFORMATTED_VALUE
는 값이 계산되지만 형식이 지정되지는 않음을 나타냅니다.
을 입력합니다. 비어있는 후행 행과 열은 생략됩니다.
요청 프로토콜은 다음과 같습니다.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values:batchGet? ranges=Sheet1!B:B&ranges=Sheet1!D:D&valueRenderOption=UNFORMATTED_VALUE&majorDimension=COLUMNS
이 메서드 호출에 대한 응답은
및
ValueRange
드림
각 요청된 범위에 해당하는 객체로서, 정렬된 순서로 나열됨
있습니다. 이
majorDimension
필드
는 배열이 열로 구성된 값 목록임을 나타냅니다. 예를 들면 다음과 같습니다.
{ "spreadsheetId": SPREADSHEET_ID, "valueRanges": [ { "range": "Sheet1!B1:B1000", "majorDimension": "COLUMNS", "values": [ ["Cost",20.5,15,100,135.5] ] }, { "range": "Sheet1!D1:D1000", "majorDimension": "COLUMNS", "values": [ ["Ship Date",42430,42444,42449,42449] ]s } ] }
여러 시트에서 여러 범위 읽기
다음
spreadsheets.values.batchGet
드림
Sheet1!A1:D5, 시트 내 범위에서 값을 읽는 방법을 보여주는
Products!D1:D100 및 Sales!E4:F6를 만들고 응답으로 반환합니다. 이
ValueRenderOption
설정
의 UNFORMATTED_VALUE
는 값이 계산되지만 형식이 지정되지는 않음을 나타냅니다.
을 입력합니다. 비어있는 후행 행과 열은 생략됩니다.
요청 프로토콜은 다음과 같습니다.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values:batchGet? ranges=Sheet1!A1:D5&ranges=Products!D1:D100&ranges=Sales!E4:F6&valueRenderOption=UNFORMATTED_VALUE&majorDimension=COLUMNS
이 메서드 호출에 대한 응답은
및
ValueRange
드림
각 요청된 범위에 해당하는 객체로서, 정렬된 순서로 나열됨
있습니다. 이
majorDimension
필드
는 배열이 열로 구성된 값 목록임을 나타냅니다. 예를 들면 다음과 같습니다.
{ "spreadsheetId": SPREADSHEET_ID, "valueRanges": [ { "range": "Sheet1!A1:D5", "majorDimension": "COLUMNS", "values": [ [...], [...] ] }, { "range": "Products!D1:D100", "majorDimension": "COLUMNS", "values": [ [...] ] }, { "range": "Sales!E4:F6", "majorDimension": "COLUMNS", "values": [ [...], [...] ] } ] }