Sheets API v3에서 이전

v3 API

Sheets API v3는 단일 인증 범위로 작동합니다.

https://spreadsheets.google.com/feeds

이는 다음의 별칭입니다.

https://www.googleapis.com/auth/spreadsheets

두 범위 형식 중 하나를 사용할 수 있습니다.

v4 API

Sheets API v4에서는 다음과 같은 범위 세트 중에서 하나 이상을 사용합니다.

https://www.googleapis.com/auth/spreadsheets.readonly
https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

애플리케이션이 사용자의 시트나 시트 속성을 수정할 필요가 없는 경우에는 읽기 전용 범위를 사용하세요. 애플리케이션에서 일반적인 Drive 액세스가 필요없는 경우에는 Drive 범위 대신 스프레드시트 범위를 사용하세요.

v3 API

Sheets API v3는 가시성을 엔드포인트에 직접 표현합니다. public 스프레드시트는 '웹에 게시'되었으므로 승인 없이도 API에서 액세스할 수 있지만 private 스프레드시트는 인증이 필요합니다. 가시성은 스프레드시트 ID 뒤의 엔드포인트에 지정됩니다.

https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full

v4 API

새로운 버전의 Sheets API v4에서는 명시적인 가시성 선언이 없습니다. API 호출은 스프레드시트 ID를 사용하여 수행됩니다. 지정된 스프레드시트에 액세스하기 위한 권한이 애플리케이션에 없는 경우 오류가 반환됩니다. 그렇지 않으면 호출이 진행됩니다.

v3 API

Sheets API v3에서는 두 가지 프로젝션 설정만 가능합니다. full 프로젝션은 사용 가능한 모든 정보를 반환하는 반면 basic은 더 작은 고정된 데이터 하위 집합을 반환합니다 (워크시트, 목록, 셀 피드의 경우). 가시성과 마찬가지로 프로젝션은 API 엔드포인트(가시성 설정 뒤)에서 지정되어야 합니다.

https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/public/basic

더 작은 데이터 하위 집합을 제공하는 basic 프로젝션은 보다 효율적인 코드를 만들기에는 유용하지만, 사용자 지정은 불가능합니다.

v4 API

Sheets API v4는 전체 데이터 집합을 반환할 수 있는 반면, Sheets API v3의 basic 가시성 설정과 유사한 고정된 하위 집합을 정의하지는 못합니다. spreadsheet 컬렉션의 메서드는 fields 쿼리 매개변수를 통해 반환되는 데이터의 양을 제한합니다.

예를 들어 다음 쿼리는 특정 스프레드시트에 있는 모든 시트의 제목만 반환합니다.

GET https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId?fields=sheets.properties.title

v3 API

Sheets API v3에는 새 스프레드시트를 만드는 방법이 없습니다. 그 대신 Drive API Files.create 메서드를 사용하여 새 스프레드시트 파일을 만들 수 있습니다. 이렇게 하려면 애플리케이션에서 https://www.googleapis.com/auth/drive 범위를 선언해야 합니다.

v4 API

Drive API Files.create 메서드는 Sheets API v4에서도 사용할 수 있지만, 애플리케이션이 https://www.googleapis.com/auth/drive 범위를 제공해야 합니다.

그에 상응하는 대안으로 Sheets API v4에서는 spreadsheets.create 메서드를 제공하며, 선택적으로 시트를 추가하고, 스프레드시트 및 시트 속성을 설정하고, 명명된 범위를 추가할 수도 있습니다. 예를 들어 다음은 새 스프레드시트를 만들고 'NewTitle'이라는 이름을 지정합니다.

POST https://sheets.googleapis.com/v4/spreadsheets

{
 "properties": {"title": "NewTitle"}
}

v3 API

Sheets API v3 피드에서는 인증된 사용자가 액세스할 수 있는 모든 스프레드시트 목록을 애플리케이션이 검색하도록 허용합니다. 스프레드시트 피드 엔드포인트는 다음과 같습니다.

GET https://spreadsheets.google.com/feeds/spreadsheets/private/full

v4 API

이 특정 작업은 Sheets API v4에서 제공하지 않습니다. 스프레드시트 선택을 위해 Google 선택 도구와 함께 drive.file 범위를 사용하도록 앱을 이전하는 것이 좋습니다.

스프레드시트를 나열해야 하는 경우 mimeType 쿼리를 사용하여 Drive API Files.list 메서드를 통해 복제할 수 있습니다.

GET https://www.googleapis.com/drive/v3/files
             ?q=mimeType='application/vnd.google-apps.spreadsheet'

Drive API files.list 메서드를 사용하여 사용자의 모든 스프레드시트를 나열하려면 제한된 범위가 필요합니다.

v3 API

워크시트 피드는 이 API 엔드포인트로부터 액세스가 가능합니다 (적절한 인증 헤더 사용).

GET https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full

이 요청에 대한 응답은 다음과 유사한 구조를 가지며, 각 시트의 데이터가 별도의 <entry>에 포함됩니다.

<feed xmlns="http://www.w3.org/2005/Atom"
    xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/"
    xmlns:gs="http://schemas.google.com/spreadsheets/2006"
    xmlns:gd="http://schemas.google.com/g/2005"
    gd:etag='W/"D0cERnk-eip7ImA9WBBXGEg."'>
  <id>https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full</id>
  <updated>2006-11-17T18:23:45.173Z</updated>
  <title type="text">Groceries R Us</title>
  <link rel="alternate" type="text/html"
      href="https://spreadsheets.google.com/ccc?key=spreadsheetId"/>
  <link rel="http://schemas.google.com/g/2005#feed"
      type="application/atom+xml"
      href="https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full"/>
  <link rel="self" type="application/atom+xml"
      href="https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full"/>
  <link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml"
      href="https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full"/>
  <author>
    <name>Fitzwilliam Darcy</name>
    <email>fitz@example.com</email>
  </author>
  <openSearch:totalResults>1</openSearch:totalResults>
  <openSearch:startIndex>1</openSearch:startIndex>
  <openSearch:itemsPerPage>1</openSearch:itemsPerPage>
  <entry gd:etag='"YDwqeyI."'>
    <id>https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId</id>
    <updated>2006-11-17T18:23:45.173Z</updated>
    <title type="text">Sheet1</title>
    <content type="text">Sheet1</content>
    <link rel="http://schemas.google.com/spreadsheets/2006#listfeed"
        type="application/atom+xml"
        href="https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full"/>
    <link rel="http://schemas.google.com/spreadsheets/2006#cellsfeed"
        type="application/atom+xml"
        href="https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full"/>
    <link rel="self" type="application/atom+xml"
        href="https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId"/>
    <link rel="edit" type="application/atom+xml"
        href="https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId/version"/>
    <gs:rowCount>100</gs:rowCount>
    <gs:colCount>20</gs:colCount>
  </entry>
</feed>

v4 API

spreadsheets.get 메서드를 사용하면 Sheets API v3를 사용할 때보다 훨씬 더 많은 시트 속성과 기타 메타데이터를 얻을 수 있습니다. 시트 속성만 읽으려면 includeGridData 쿼리 매개변수를 false로 설정하여 스프레드시트 셀 데이터가 포함되지 않도록 합니다.

GET https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId?includeGridData=false

Spreadsheet 응답에는 Sheet 객체의 배열이 포함되며, 시트 제목과 크기 정보는 이러한 객체의 SheetProperties 요소 아래에서 찾을 수 있습니다. 예를 들면 다음과 같습니다.

{
  "spreadsheetId": spreadsheetId,
  "sheets": [
      {"properties": {
          "sheetId": sheetId,
          "title": "Sheet1",
          "index": 0,
          "gridProperties": {
              "rowCount": 100,
              "columnCount": 20,
              "frozenRowCount": 1,
              "frozenColumnCount": 0,
              "hideGridlines": false
          },
          ...
       },
       ...
      },
      ...
  ],
  ...
}

v3 API

Sheets API v3에서는 다음과 같은 (인증된) POST 요청을 수행하여 새 워크시트를 스프레드시트에 추가할 수 있습니다. 새 시트의 크기를 지정할 수 있습니다.

POST https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full

<entry xmlns="http://www.w3.org/2005/Atom"
    xmlns:gs="http://schemas.google.com/spreadsheets/2006">
  <title>Expenses</title>
  <gs:rowCount>50</gs:rowCount>
  <gs:colCount>10</gs:colCount>
</entry>

v4 API

spreadsheets.batchUpdate 메서드에서 AddSheet 요청을 실행하여 새 시트를 추가할 수 있습니다. 요청 본문의 일부로 새 시트의 시트 속성을 지정할 수 있으며 모든 속성은 선택 항목입니다. 기존 시트에 사용되는 제목을 제공하면 오류가 발생합니다.

POST https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId:batchUpdate

{
  "requests": [{
      "addSheet": {
          "properties": {
            "title": "Expenses",
            "sheetType": "GRID",
            "gridProperties": {
              "rowCount": 50,
              "columnCount": 10
            }
          }
      }
  }],
}

v3 API

워크시트의 제목이나 크기를 변경하려면 먼저 워크시트 피드를 검색하고 edit URL이 포함된 원하는 워크시트 항목을 찾습니다. 워크시트의 메타데이터를 업데이트하고 이 메타데이터를 PUT 요청의 본문으로 edit URL에 보냅니다. 예를 들면 다음과 같습니다.

PUT https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId/version

<entry>
  <id>
    https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId
  </id>
  <updated>2007-07-30T18:51:30.666Z</updated>
  <category scheme="http://schemas.google.com/spreadsheets/2006"
    term="http://schemas.google.com/spreadsheets/2006#worksheet"/>
  <title type="text">Expenses</title>
  <content type="text">Expenses</content>
  <link rel="http://schemas.google.com/spreadsheets/2006#listfeed"
    type="application/atom+xml" href="https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full"/>
  <link rel="http://schemas.google.com/spreadsheets/2006#cellsfeed"
    type="application/atom+xml" href="https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full"/>
  <link rel="self" type="application/atom+xml"
    href="https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId"/>
  <link rel="edit" type="application/atom+xml"
    href="https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId/version"/>
  <gs:rowCount>45</gs:rowCount>
  <gs:colCount>15</gs:colCount>
</entry>

v4 API

크기, 제목, 기타 시트 속성을 업데이트하려면 spreadsheets.batchUpdate 메서드에서 updateSheetProperties 요청을 실행합니다. POST 요청 본문에는 변경하려는 속성이 포함되어야 하며, fields 매개변수에는 이러한 속성이 명시적으로 나열되어야 합니다(모든 속성을 업데이트하려면 모든 속성을 나열하기 위해 간단히 fields:"*"를 사용합니다). 예를 들어 다음은 지정된 ID가 있는 시트에 대해 시트 제목과 크기 속성을 업데이트해야 함을 지정합니다.

POST https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId:batchUpdate

{
  "requests": [
    {
      "updateSheetProperties": {
          "properties": {
            "sheetId": sheetId,
            "title": "Expenses",
            "gridProperties": {
              "rowCount": 45,
              "columnCount": 15,
            }
          },
          "fields": "title,gridProperties(rowCount,columnCount)"
     }
   }
  ],
}

시트의 sheetId를 가져오려면 스프레드시트 spreadsheets.get 메서드를 사용합니다.

v3 API

워크시트를 삭제하려면 먼저 워크시트 피드를 가져온 다음 대상 워크시트 항목의 edit URL에 DELETE 요청을 보냅니다.

DELETE https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId/version

v4 API

시트를 삭제하려면 spreadsheets.batchUpdate 메서드에서 DeleteSheet 요청을 실행합니다. POST 요청 본문에는 삭제하려는 시트의 sheetId만 포함되어야 합니다. 예를 들면 다음과 같습니다.

POST https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId:batchUpdate

{
  "requests": [
    {
      "deleteSheet": {
        "sheetId": sheetId
      }
    }
  ],
}

개별 시트의 sheetId를 검색하려면 스프레드시트 spreadsheets.get 메서드를 사용합니다.

v3 API

지정된 워크시트에 대해 목록 기반 피드의 URL을 판별하려면 워크시트 피드를 검색하고 원하는 워크시트 항목에서 목록 피드 URL을 찾습니다.

목록 기반 피드를 검색하려면 적절한 인증 헤더를 사용하여 GET 요청을 목록 피드 URL로 보냅니다. 예를 들면 다음과 같습니다.

GET https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full

이 요청에 대한 응답에는 특정 행에 해당하는 항목이 포함됩니다. 개별 셀은 (필수) 시트 헤더 행에 제공되는 이름별로 참조됩니다. 예를 들어 다음은 단일 행 항목을 나타냅니다.

<entry gd:etag='"S0wCTlpIIip7ImA0X0QI"'>
  <id>rowId</id>
  <updated>2006-11-17T18:23:45.173Z</updated>
  <category scheme="http://schemas.google.com/spreadsheets/2006"
      term="http://schemas.google.com/spreadsheets/2006#list"/>
  <title type="text">Bingley</title>
  <content type="text">Hours: 10, Items: 2, IPM: 0.0033</content>
  <link rel="self" type="application/atom+xml"
      href="https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full/rowId"/>
  <link rel="edit" type="application/atom+xml"
      href="https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full/rowId/version"/>
  <gsx:name>Bingley</gsx:name>
  <gsx:hours>10</gsx:hours>
  <gsx:items>2</gsx:items>
  <gsx:ipm>0.0033</gsx:ipm>
</entry>

기본적으로 목록 피드에 반환되는 행은 행 순서대로 반환됩니다. Sheets API v3는 이 순서를 변경하는 쿼리 매개변수를 제공합니다.

역순:

GET https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full?reverse=true

특정 열별 순서:

GET https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full
             ?orderby=column:lastname

Sheets API v3는 또한 (열 헤더별로 참조되는) 구조적 쿼리를 통해 특정 행을 필터링할 수 있습니다.

GET https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full
             ?sq=age>25%20and%20height<175

v4 API

Sheets API v4에서는 spreadsheets.values.get 또는 spreadsheets.values.batchGet 메서드를 사용하여 범위별로 행을 검색할 수 있습니다. 예를 들어 다음은 'Sheet1'의 모든 행을 반환합니다.

GET https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId/values/Sheet1

이 요청에 대한 응답은 다음과 유사한 구조를 가집니다.

{
  "range": "Sheet1",
  "majorDimension": "ROWS",
  "values": [["Name", "Hours", "Items", "IPM"],
             ["Bingley", "10", "2", "0.0033"],
             ["Darcy", "14", "6", "0.0071"]]
}

전체 행, 열 또는 시트를 검색할 경우 후행 빈 셀은 응답에 포함되지 않습니다.

Sheets API v4에는 Sheets API v3에서 제공하는 행 순서 쿼리 매개변수에 상응하는 매개변수가 없습니다. 역순은 간단하며, 반환된 values 배열을 역순으로 처리하면 됩니다. 열별 순서는 읽기에는 지원되지 않지만, SortRange 요청을 사용하여 시트에서 데이터를 정렬한 다음 읽는 것은 가능합니다.

현재 Sheets API v4에는 Sheets API v3 구조적 쿼리에 직접 상응하는 것이 없습니다. 그러나 애플리케이션에서 필요할 때 관련 데이터를 검색하고 정렬할 수 있습니다.

v3 API

지정된 워크시트에 대해 목록 기반 피드의 URL을 판별하려면 워크시트 피드를 검색하고 원하는 워크시트 항목에서 게시물 URL을 찾습니다.

데이터 행을 추가하려면 적절한 인증 헤더를 사용하여 POST 요청을 post URL에 보냅니다. 예를 들면 다음과 같습니다.

POST https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full

POST 요청의 본문에는 추가할 행 데이터의 항목이 포함되어야 하며, 개별 셀은 열 헤더별로 참조됩니다.

<entry xmlns="http://www.w3.org/2005/Atom"
       xmlns:gsx="http://schemas.google.com/spreadsheets/2006/extended">
  <gsx:hours>2</gsx:hours>
  <gsx:ipm>0.5</gsx:ipm>
  <gsx:items>60</gsx:items>
  <gsx:name>Elizabeth</gsx:name>
</entry>

지정된 시트 끝에 새 행이 추가됩니다.

v4 API

Sheets API v4에서는 spreadsheets.values.append 메서드를 사용하여 행을 추가할 수 있습니다. 다음 예에서는 스프레드시트의 'Sheet1'에 있는 마지막 테이블 아래에 새 데이터 행을 씁니다.

POST https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId/append/Sheet1

{
   "values": [["Elizabeth", "2", "0.5", "60"]]
}

또한 Sheets API v4에서는 spreadsheets.batchUpdate에서 AppendCells 요청을 사용하여 특정 속성과 서식을 가진 셀을 추가할 수 있습니다.

v3 API

데이터 행을 수정하려면 목록 피드를 검사하여 업데이트하려는 행의 항목을 찾습니다. 필요에 따라 해당 항목의 내용을 업데이트합니다. 사용 중인 항목의 ID 값이 기존 항목의 ID와 정확히 일치하는지 확인합니다.

항목이 업데이트되었다면 적절한 인증 헤더를 사용하여 이 항목과 함께 PUT 요청을 해당 행 항목에서 제공되는 edit URL에 요청 본문으로 보냅니다. 예를 들면 다음과 같습니다.

PUT https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full/rowId/version

<entry gd:etag='"S0wCTlpIIip7ImA0X0QI"'>
  <id>rowId</id>
  <updated>2006-11-17T18:23:45.173Z</updated>
  <category scheme="http://schemas.google.com/spreadsheets/2006"
    term="http://schemas.google.com/spreadsheets/2006#list"/>
  <title type="text">Bingley</title>
  <content type="text">Hours: 10, Items: 2, IPM: 0.0033</content>
  <link rel="self" type="application/atom+xml"
    href="https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full/rowId"/>
  <link rel="edit" type="application/atom+xml"
    href="https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full/rowId/version"/>
  <gsx:name>Bingley</gsx:name>
  <gsx:hours>20</gsx:hours>
  <gsx:items>4</gsx:items>
  <gsx:ipm>0.0033</gsx:ipm>
</entry>

v4 API

Sheets API v4를 사용하면 수정하려는 행의 A1 표기법을 사용하여 행을 수정하고 spreadsheets.values.update 요청을 실행하여 이 행을 덮어쓸 수 있습니다. 지정된 범위는 행의 첫 셀만을 참조하면 됩니다. API는 요청과 함께 제공된 값을 기반으로 업데이트할 셀을 유추합니다. 그 대신 다중 셀 범위를 지정하는 경우에는, 제공하는 값이 해당 범위 내에 있어야 합니다. 그렇지 않으면 API가 오류를 반환합니다.

다음 예시 요청과 요청 본문은 'Sheet1'의 네 번째 행에 데이터를 추가합니다.

PUT https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId/values/Sheet1!A4

{
   "values": [["Elizabeth", "2", "0.5", "60"]]
}

spreadsheet.values.batchUpdate 메서드에서 행 데이터를 업데이트할 수도 있습니다. 행 또는 셀을 여러 번 업데이트하는 경우에는 이 메서드를 사용하는 것이 더 효율적입니다.

또한 Sheets API v4에서는 spreadsheets.batchUpdate에서 UpdateCells 또는 RepeatCell 요청을 사용하여 셀 속성과 셀 서식을 수정할 수도 있습니다.

v3 API

행을 삭제하려면 먼저 목록 피드에서 삭제할 행을 검색한 다음 행의 항목에 제공된 edit URL로 DELETE 요청을 보냅니다. 이는 행 업데이트에 사용되는 URL과 동일합니다.

DELETE https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full/rowId/version

행을 검색한 이후 다른 클라이언트에 의해 변경된 행을 삭제하지 않도록 하려면, 원본 행의 ETag 값이 포함된 HTTP If-Match 헤더를 포함합니다. 항목 요소의 gd:etag 속성을 검사하여 원본 행의 ETag 값을 확인할 수 있습니다.

행을 검색한 이후 누군가가 행을 업데이트했는지 여부에 상관없이 이 행을 삭제하려면, If-Match: * 를 사용하고 ETag는 포함하지 마세요. (이 경우 행을 삭제하기 전에 검색할 필요가 없습니다.)

v4 API

Sheets API v4에서 행 삭제는 DeleteDimension 요청을 사용하여 spreadsheet.batchUpdate 메서드 호출에 의해 처리됩니다. 이 요청은 열을 삭제하는 데 사용될 수 있으며, 개발자가 행 또는 열의 일부만 삭제하도록 선택할 수도 있습니다. 예를 들어 다음은 지정된 ID가 있는 시트의 6번째 행을 삭제합니다. 행 인덱스는 0부터 시작하며 startIndex는 포함하고 endIndex는 제외합니다.

POST https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId:batchUpdate

{
  "requests": [
    {
      "deleteDimension": {
        "range": {
          "sheetId": sheetId,
          "dimension": "ROWS",
          "startIndex": 5,
          "endIndex": 6
        }
      }
    }
  ],
}

spreadsheet.get 메서드를 사용하여 시트의 sheetId를 가져올 수 있습니다.

v3 API

지정된 워크시트에 대해 셀 기반 피드의 URL을 판별하려면 워크시트 피드를 검사하고 원하는 워크시트 항목에서 셀 피드 URL을 찾습니다.

셀 기반 피드를 검색하려면 적절한 인증 헤더를 사용하여 셀 피드 URL에 GET 요청을 보냅니다. 예를 들면 다음과 같습니다.

GET https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full

셀은 행 및 열 번호를 사용하여 참조됩니다. 특정한 단일 범위를 가져오려면 max-row, min-row, max-col, min-col 쿼리 매개변수를 사용하면 됩니다. 예를 들어 다음은 행 2부터 시작하여 열 4 (D)의 모든 셀을 검색합니다.

GET https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full
             ?min-row=2&min-col=4&max-col=4

Sheets API v3는 검색된 셀의 inputValue를 반환합니다. 그렇지 않으면 사용자가 셀 조작을 위해 Google Sheets 사용자 인터페이스에 이 값을 입력해야 합니다. inputValue은 리터럴 값이나 수식이 될 수 있습니다. 때로는 이 API가 numericValue를 반환하기도 합니다(예: 수식에서 숫자가 생기는 경우). 예를 들어 구조가 다음과 유사한 셀 항목이 응답에 포함될 수도 있습니다.

<entry gd:etag='"ImB5CBYSRCp7"'>
  <id>https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R9C4</id>
  <updated>2006-11-17T18:27:32.543Z</updated>
  <category scheme="http://schemas.google.com/spreadsheets/2006"
    term="http://schemas.google.com/spreadsheets/2006#cell"/>
  <title type="text">D4</title>
  <content type="text">5</content>
  <link rel="self" type="application/atom+xml"
    href="https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R9C4"/>
  <link rel="edit" type="application/atom+xml"
    href="https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R9C4/srevc"/>
  <gs:cell row="4" col="4" inputValue="=FLOOR(C4/(B4*60),.0001)"
    numericValue="5.0">5</gs:cell>
</entry>

v4 API

원하는 범위에 대해 각각 spreadsheets.values.get 또는 spreadsheets.values.batchGet 메서드를 호출하여 셀 데이터를 검색합니다. 예를 들어, 다음은 행 2부터 시작하여 'Sheet2'의 열 D에 있는 셀을 열 우선 순서로 반환하고 입력된 수식을 반환합니다 (후행 빈 셀은 생략됨).

GET https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId/values/Sheet2!D2:D?majorDimension=COLUMNS&valueRenderOption=FORMULA

이 요청에 대한 응답은 다음과 유사한 구조입니다.

{
  "spreadsheetId": spreadsheetId,
  "valueRanges": [
      {"range": "Sheet2!D2:D",
       "majorDimension": "COLUMNS",
       "values": [["Widget", 234, "=FLOOR(C4/(B4*60),.0001)", "=D4\*1000"]]
      }]
}

여러 범위의 셀 데이터를 검색하려는 경우에는 spreadsheet.values.batchGet을 사용하는 것이 더 효율적입니다. 서식 등의 셀 속성에 액세스하려면 spreadsheet.get 메서드가 필요합니다.

v3 API

단일 셀의 내용을 수정하려면 먼저 셀 피드에서 셀의 항목을 찾습니다. 항목에는 수정 URL이 포함됩니다. 셀의 내용을 반영하려면 항목을 업데이트한 다음, 업데이트된 셀 항목을 요청 본문으로 사용하여 수정 URL에 대해 PUT 요청을 실행합니다. 예를 들어 다음은 SUM 수식을 포함하도록 셀 D2 (R2C4)를 업데이트합니다.

PUT https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full//R2C4/srevc

<entry xmlns="http://www.w3.org/2005/Atom"
    xmlns:gs="http://schemas.google.com/spreadsheets/2006">
  <id>https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R2C4</id>
  <link rel="edit" type="application/atom+xml"
    href="https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R2C4"/>
  <gs:cell row="2" col="4" inputValue="=SUM(A1:B6)"/>
</entry>

v4 API

Sheets API v4에서 단일 셀 편집은 spreadsheets.values.update 메서드를 사용하여 수행할 수 있습니다. 이 메서드에는 입력 데이터가 Sheets UI에 입력된 것처럼 처리되는지 (USER_ENTERED) 아니면 파싱되지 않고 그대로 유지되는지 (RAW) 지정하는 ValueInputOption 쿼리 매개변수가 필요합니다. 예를 들어 다음은 셀 D2를 수식으로 업데이트합니다.

PUT https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId/values/D2?valueInputOption=USER_ENTERED

{"values": [["=SUM(A1:B6)"]]}

여러 셀을 수정하는 경우 spreadsheets.values.batchUpdate 메서드를 사용하여 한 번의 요청으로 실행할 수 있습니다.

v3 API

여러 셀을 수정하려면 먼저 해당 워크시트의 셀 피드를 가져옵니다. 항목에는 일괄처리 URL이 포함됩니다. 업데이트하려는 셀을 설명하는 요청 본문 및 새 셀 콘텐츠와 함께 POST 요청을 이 URL로 보냅니다. POST 요청과 요청 본문은 다음과 유사한 구조를 가집니다.

POST https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/batch

<feed xmlns="http://www.w3.org/2005/Atom"
      xmlns:batch="http://schemas.google.com/gdata/batch"
      xmlns:gs="http://schemas.google.com/spreadsheets/2006">
  <id>https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full</id>
  <entry>
    <batch:id>request1</batch:id>
    <batch:operation type="update"/>
    <id>https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R2C4</id>
    <link rel="edit" type="application/atom+xml"
      href="https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R2C4/version"/>
    <gs:cell row="2" col="4" inputValue="newData"/>
  </entry>
  ...
  <entry>
    <batch:id>request2</batch:id>
    <batch:operation type="update"/>
    <id>https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R2C5</id>
    <link rel="edit" type="application/atom+xml"
      href="https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R2C5/version"/>
    <gs:cell row="5" col="2" inputValue="moreInfo"/>
  </entry>
</feed>

batch:id 필드는 일괄 요청 내에서 요청을 고유하게 식별해야 합니다. 셀 편집의 경우 batch:operation 필드는 update여야 합니다. gs:cell는 행 및 열 번호로 셀을 식별하며, 셀에 삽입할 새 데이터를 제공합니다. id에는 업데이트할 셀의 전체 URL이 포함됩니다. link에는 셀 ID의 전체 경로가 포함된 href 속성이 있어야 합니다. 이 모든 필드는 각 항목에 필수입니다.

v4 API

Sheets API v4는 spreadsheets.values.batchUpdate 메서드를 통해 셀 값을 일괄 편집하는 기능을 제공합니다.

요청 본문에 지정된 데이터 변경사항과 함께 POST 요청을 실행하여 다중 셀 편집을 수행할 수 있습니다. 예를 들면 다음과 같습니다.

POST https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId/values:batchUpdate

{
  "valueInputOption": "USER_ENTERED"
  "data": [
       {"range": "D4",
        "majorDimension": "ROWS",
        "values": [["newData"]]
       },
       {"range": "B5",
        "majorDimension": "ROWS",
        "values": [["moreInfo"]]
       }
  ]
}

범위를 단일 셀로 지정한 경우에는, 해당 셀부터 시작하여 제공된 모든 값이 시트에 왼쪽 상단 좌표로 기록됩니다. 그 대신 다중 셀 범위를 지정하는 경우에는, 제공하는 값이 해당 범위와 정확하게 일치해야 합니다. 그렇지 않으면 API가 오류를 반환합니다.