Migrar da API Sheets v3

API v3

A API Sheets v3 opera com um único escopo de autorização:

https://spreadsheets.google.com/feeds

que é um alias de

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

É possível usar qualquer formato de escopo.

API v4

A API Sheets v4 usa um ou mais dos seguintes conjuntos de escopos:

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

Use escopos somente leitura se o aplicativo não precisar fazer edições nas folhas ou propriedades de um usuário. Use os escopos de planilhas em vez de escopos do Drive se o aplicativo não precisar de acesso geral ao Drive.

API v3

A API Sheets v3 expressa a visibilidade diretamente nos endpoints. Uma planilha public foi "Publicada na Web" e, portanto, pode ser acessada pela API sem autorização. Já uma planilha private exige autenticação. A visibilidade é especificada no endpoint após o ID da planilha:

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

API v4

Na nova API Sheets v4, não há uma declaração explícita de visibilidade. As chamadas de API são feitas usando IDs de planilhas. Se o aplicativo não tiver permissão para acessar a planilha especificada, um erro será retornado. Caso contrário, a chamada continua.

API v3

Há apenas duas configurações de projeção possíveis na API Sheets v3. A projeção full retorna todas as informações disponíveis, enquanto basic retorna um subconjunto de dados menor e fixo (para os feeds de planilhas, listas e células). Assim como a visibilidade, a projeção precisa ser especificada no endpoint da API (após a configuração de visibilidade):

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

O subconjunto menor de dados fornecido pela projeção basic é valioso para tornar o código mais eficiente, mas não pode ser personalizado.

API v4

Embora a API Sheets v4 possa retornar um conjunto de dados completo, ela não define subconjuntos fixos análogos à configuração de visibilidade basic da API Sheets v3. Os métodos na coleção de planilhas restringem a quantidade de dados retornados usando um parâmetro de consulta fields.

Por exemplo, a consulta a seguir retorna apenas os títulos de todas as planilhas em uma planilha específica:

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

API v3

A API Sheets v3 não oferece uma forma de criar novas planilhas. Em vez disso, o método Drive API Files.create pode ser usado para criar novos arquivos de planilha. Isso exige que o aplicativo declare o escopo https://www.googleapis.com/auth/drive.

API v4

O método Files.create da API Drive também pode ser usado com a API Sheets v4, mas exige que o aplicativo forneça o escopo https://www.googleapis.com/auth/drive.

Como alternativa equivalente, a API Sheets v4 oferece um método spreadsheets.create, que também pode adicionar planilhas, definir as propriedades da planilha e da planilha e adicionar intervalos nomeados. Por exemplo, o comando a seguir cria uma nova planilha e dá a ela o nome "NewTitle":

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

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

API v3

O feed da API Sheets v3 permite que um aplicativo extraia uma lista de todas as planilhas acessíveis pelo usuário autenticado. O endpoint do feed de planilha é:

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

API v4

A API Sheets v4 não oferece essa operação específica. Recomendamos que você migre seu app para usar o escopo drive.file em combinação com o Google Picker para seleção de planilhas.

Nos casos em que a listagem de planilhas é necessária, ela pode ser replicada pelo método Files.list da API Drive, usando uma consulta mimeType:

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

O uso do método files.list da API Drive para listar todas as planilhas de um usuário requer um escopo restrito.

API v3

O feed da planilha pode ser acessado neste endpoint da API (usando um cabeçalho de autorização apropriado):

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

A resposta a essa solicitação tem uma estrutura semelhante a esta, com os dados de cada planilha contidos em um <entry> separado:

<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>

API v4

O método spreadsheets.get pode ser usado para adquirir propriedades de planilha e outros metadados, muito mais do que o que está disponível usando a API Sheets v3. Se você quiser apenas ler as propriedades da planilha, defina o parâmetro de consulta includeGridData como false para impedir a inclusão dos dados da célula da planilha:

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

A resposta Spreadsheet contém uma matriz de objetos Sheet. Os títulos da planilha e as informações de tamanho podem ser encontrados no elemento SheetProperties desses objetos. Exemplo:

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

API v3

A API Sheets v3 pode adicionar novas planilhas a uma planilha fazendo a solicitação POST (autenticada) a seguir. É possível especificar o tamanho da nova planilha:

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>

API v4

Para adicionar novas planilhas, faça uma solicitação AddSheet no método spreadsheets.batchUpdate. Como parte do corpo da solicitação, é possível especificar as propriedades da nova página. Todas as propriedades são opcionais. É um erro fornecer um título usado para uma planilha existente.

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

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

API v3

Para mudar o título ou o tamanho de uma planilha, comece extraindo o feed de planilhas e encontre a entrada de planilha desejada, que contém um URL edit. Atualize os metadados da planilha e os envie como o corpo de uma solicitação PUT para o URL de edição. Exemplo:

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>

API v4

Para atualizar o tamanho, o título e outras propriedades da planilha, faça uma solicitação updateSheetProperties no método spreadsheets.batchUpdate. O corpo da solicitação POST precisa conter as propriedades a serem alteradas, e o parâmetro fields precisa listar essas propriedades explicitamente. Se você quiser atualizar todas as propriedades, use fields:"*" como uma abreviação para listar todas elas. Por exemplo, o exemplo a seguir especifica que as propriedades de título e tamanho da planilha precisam ser atualizadas para a planilha com o ID fornecido:

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)"
     }
   }
  ],
}

Para recuperar o sheetId de uma planilha, use o método spreadsheets.get.

API v3

Para excluir uma planilha, comece recuperando o feed de planilha e, em seguida, envie uma solicitação DELETE no URL edit da entrada da planilha de destino.

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

API v4

Para excluir uma planilha, faça uma solicitação DeleteSheet no método spreadsheets.batchUpdate. O corpo da solicitação POST precisa conter apenas o sheetId para que a folha seja excluída. Exemplo:

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

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

Para recuperar o sheetId de uma planilha, use o método spreadsheets.get da planilha.

API v3

Para determinar o URL de um feed baseado em lista para uma determinada planilha, extraia o feed de planilha e encontre o URL do feed de lista na entrada de planilha de interesse.

Para recuperar um feed baseado em lista, envie uma solicitação GET para o URL do feed de lista, usando um cabeçalho de autorização adequado. Exemplo:

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

A resposta a essa solicitação contém, entre outras coisas, entradas correspondentes a linhas específicas. As células individuais são referenciadas pelos nomes fornecidos na linha de cabeçalho da planilha (obrigatória). Por exemplo, aqui está uma entrada de linha única:

<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>

Por padrão, as linhas retornadas no feed de lista são retornadas na ordem das linhas. A API Sheets v3 oferece parâmetros de consulta para mudar essa ordem.

Ordem inversa:

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

Ordenar por uma coluna específica:

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

A API Sheets v3 também permite filtrar linhas específicas usando uma consulta estruturada (referenciada pelos cabeçalhos de coluna):

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

API v4

Com a API Sheets v4, as linhas podem ser recuperadas por intervalo usando os métodos spreadsheets.values.get ou spreadsheets.values.batchGet. Por exemplo, o código a seguir retorna todas as linhas em "Sheet1":

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

A resposta a essa solicitação tem uma estrutura semelhante a esta:

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

As células vazias finais não são incluídas na resposta ao recuperar linhas, colunas ou planilhas inteiras.

A API Sheets v4 não tem equivalentes para os parâmetros de consulta de ordem de linha fornecidos pela API Sheets v3. A ordem inversa é trivial. Basta processar a matriz values retornada na ordem inversa. A ordenação por coluna não é compatível com leituras, mas é possível classificar os dados na planilha (usando uma solicitação SortRange) e depois ler.

No momento, a API Sheets v4 não tem um equivalente direto para as consultas estruturadas da API Sheets v3. No entanto, é possível recuperar os dados relevantes e classificá-los conforme necessário no aplicativo.

API v3

Para determinar o URL de um feed baseado em lista para uma determinada planilha, extraia o feed de planilha e encontre o URL da postagem na entrada de planilha de interesse.

Para adicionar uma linha de dados, envie uma solicitação POST para o URL da postagem, usando um cabeçalho de autorização adequado. Exemplo:

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

O corpo da solicitação POST precisa conter uma entrada para os dados da linha a serem adicionados, com células individuais referenciadas pelos cabeçalhos de coluna:

<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>

As novas linhas são anexadas ao final da planilha especificada.

API v4

Com a API Sheets v4, é possível anexar linhas usando o método spreadsheets.values.append. O exemplo a seguir grava uma nova linha de dados abaixo da última tabela em "Sheet1" de uma planilha.

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

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

Além disso, a API Sheets v4 também permite anexar células com propriedades e formatações específicas usando as solicitações AppendCells em uma spreadsheets.batchUpdate.

API v3

Para editar uma linha de dados, examine o feed de lista para localizar a entrada da linha que você quer atualizar. Atualize o conteúdo dessa entrada conforme necessário. Verifique se o valor do ID na entrada que você usa corresponde exatamente ao ID da entrada atual.

Depois que a entrada for atualizada, envie uma solicitação PUT com a entrada como o corpo da solicitação para o URL edit fornecido na entrada da linha, usando um cabeçalho de autorização apropriado. Exemplo:

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>

API v4

Com a API Sheets v4, é possível editar uma linha usando a notação A1 da linha que você quer editar e emitir uma solicitação spreadsheets.values.update para substituir essa linha. O intervalo especificado precisa se referir apenas à primeira célula da linha. A API infere as células a serem atualizadas com base nos valores fornecidos com a solicitação. Se você especificar um intervalo de várias células, os valores fornecidos precisarão se encaixar nesse intervalo. Caso contrário, a API vai retornar um erro.

O exemplo de solicitação e corpo de solicitação a seguir adiciona dados à quarta linha da "Sheet1":

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

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

Também é possível atualizar os dados da linha pelo método spreadsheet.values.batchUpdate. É mais eficiente usar esse método se você estiver fazendo várias atualizações de linha ou célula.

Além disso, a API Sheets v4 também permite editar as propriedades e a formatação de células usando as solicitações UpdateCells ou RepeatCell em uma spreadsheets.batchUpdate.

API v3

Para excluir uma linha, primeiro recupere a linha a ser excluída do feed de lista e envie uma solicitação DELETE para o URL edit fornecido na entrada da linha. Esse é o mesmo URL usado para atualizar a linha.

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

Se você quiser garantir que não vai excluir uma linha que foi alterada por outro cliente desde que ela foi recuperada, inclua um cabeçalho HTTP If-Match que contenha o valor da ETag da linha original. É possível determinar o valor da ETag da linha original examinando o atributo gd:etag do elemento de entrada.

Se você quiser excluir a linha, mesmo que outra pessoa a tenha atualizado desde que você a recuperou, use If-Match: * e não inclua a ETag. Nesse caso, não é necessário recuperar a linha antes de excluí-la.

API v4

A exclusão de linhas com a API Sheets v4 é processada por uma chamada de método spreadsheet.batchUpdate, usando uma solicitação DeleteDimension. Essa solicitação também pode ser usada para remover colunas, e os desenvolvedores podem escolher remover apenas parte de uma linha ou coluna. Por exemplo, o seguinte remove a 6ª linha de uma planilha com o ID fornecido. Os índices de linha são baseados em zero, com a startIndex incluída e a endIndex exclusiva:

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

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

O sheetId de uma planilha pode ser recuperado usando o método spreadsheet.get.

API v3

Para determinar o URL de um feed baseado em células para uma determinada planilha, examine o feed de planilha e encontre o URL do feed de células na entrada de planilha de interesse.

Para recuperar um feed baseado em células, envie uma solicitação GET para o URL do feed de células, usando um cabeçalho de autorização adequado. Exemplo:

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

As células são referenciadas usando o número da linha e da coluna. É possível buscar um único intervalo específico usando os parâmetros de consulta max-row, min-row, max-col e min-col. Por exemplo, o código a seguir recupera todas as células na coluna 4 (D), começando pela linha 2:

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

A API Sheets v3 retorna o inputValue das células recuperadas, o valor que um usuário digitaria na interface do usuário do Planilhas Google para manipular a célula. O inputValue pode ser um valor literal ou uma fórmula. Às vezes, a API também retorna um numericValue. Por exemplo, quando uma fórmula resulta em um número. Por exemplo, uma resposta pode incluir entradas de célula com estrutura semelhante a esta:

<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>

API v4

Extraia dados de células chamando um método spreadsheets.values.get ou spreadsheets.values.batchGet para o intervalo ou intervalos de interesse, respectivamente. Por exemplo, o seguinte retorna as células na coluna D da "Planilha2", começando com a linha 2, na ordem de colunas e retornando as fórmulas conforme inseridas (as células vazias são omitidas):

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

A resposta a essa solicitação tem uma estrutura semelhante a:

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

É mais eficiente usar spreadsheet.values.batchGet se você quiser recuperar vários intervalos de dados de células. Se você quiser acessar propriedades de célula, como formatação, o método spreadsheet.get é necessário.

API v3

Para editar o conteúdo de uma única célula, primeiro encontre a entrada dela no feed de células. A entrada contém um URL de edição. Atualize a entrada para refletir o conteúdo que você quer que a célula tenha e emita uma solicitação PUT para o URL de edição com a entrada de célula atualizada como o corpo da solicitação. Por exemplo, o seguinte código atualiza a célula D2 (R2C4) para conter uma fórmula SUM:

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>

API v4

A edição de uma única célula na API Sheets v4 pode ser feita com o método spreadsheets.values.update. Esse método requer um parâmetro de consulta ValueInputOption, que especifica se os dados de entrada são tratados como se tivessem sido inseridos na interface do Planilhas (USER_ENTERED) ou deixados sem análise e recebidos como estão (RAW). Por exemplo, a célula D2 a seguir é atualizada com uma fórmula:

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

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

Se você estiver fazendo várias edições de células, use o método spreadsheets.values.batchUpdate para emiti-las em uma solicitação.

API v3

Para editar várias células, primeiro extraia um feed de células para a planilha. A entrada contém um URL de lote. Envie uma solicitação POST para este URL, junto com um corpo de solicitação que descreve as células que você quer atualizar e o novo conteúdo delas. A solicitação POST e o corpo da solicitação têm uma estrutura semelhante a esta:

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>

O campo batch:id precisa identificar de forma exclusiva a solicitação no lote. O campo batch:operation precisa ser update para edições de células. gs:cell identifica a célula pelo número de linha e coluna e fornece os novos dados para inserir nela. id contém o URL completo da célula a ser atualizado. O link precisa ter um atributo href que contenha o caminho completo para o ID da célula. Todos esses campos são obrigatórios para cada entrada.

API v4

A API Sheets v4 oferece edição em lote de valores de células pelo método spreadsheets.values.batchUpdate.

É possível editar várias células emitindo uma solicitação POST com as mudanças de dados especificadas no corpo da solicitação. Exemplo:

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"]]
       }
  ]
}

Se você tiver especificado uma única célula como o intervalo, todos os valores fornecidos serão gravados na planilha, começando com essa célula como a coordenada superior esquerda. Se você especificar um intervalo de várias células, os valores fornecidos precisarão se encaixar exatamente nesse intervalo. Caso contrário, a API vai retornar um erro.