기본 읽기

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": [
        [...],
        [...]
      ]
    }
  ]
}