Adicionar linhas (POST)

Envie uma requisição POST à URL da planilha para acrescentar linhas ao final. O corpo pode ser um objeto JSON (uma linha) ou um array de objetos (várias linhas). As chaves precisam corresponder aos cabeçalhos das colunas.

Permissão de edição necessária

As gravações passam pelo Google Sheets, então a conexão precisa de acesso de edição:

• Para planilhas públicas, defina Qualquer pessoa com o link → Editor.
• Para planilhas privadas, use Conectar com o Drive.

Sem acesso de edição, a API responde com write_error.

Adicionar uma única linha

cURL

curl 'https://api.sheetbest.com/sheets/<api-id>' \
  -H 'Content-Type: application/json' \
  -d '{"Id": 10, "Name": "Jack Doe", "Age": 97}'

JavaScript

fetch('https://api.sheetbest.com/sheets/<api-id>', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ Id: 10, Name: 'Jack Doe', Age: 97 }),
})
  .then((r) => r.json())
  .then(console.log);

Python

import requests

requests.post(
    'https://api.sheetbest.com/sheets/<api-id>',
    json={'Id': 10, 'Name': 'Jack Doe', 'Age': 97},
)

Adicionar várias linhas

Envie um array para inserir várias linhas em uma única requisição:

cURL

curl 'https://api.sheetbest.com/sheets/<api-id>' \
  -H 'Content-Type: application/json' \
  -d '[
    {"Id": 10, "Name": "Jack Doe", "Age": 97},
    {"Id": 11, "Name": "John Doe", "Age": 44}
  ]'

JavaScript

fetch('https://api.sheetbest.com/sheets/<api-id>', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify([
    { Id: 10, Name: 'Jack Doe', Age: 97 },
    { Id: 11, Name: 'John Doe', Age: 44 },
  ]),
});

Python

requests.post(
    'https://api.sheetbest.com/sheets/<api-id>',
    json=[
        {'Id': 10, 'Name': 'Jack Doe', 'Age': 97},
        {'Id': 11, 'Name': 'John Doe', 'Age': 44},
    ],
)

Resposta

Uma inserção bem-sucedida retorna as linhas gravadas:

{
  "Id": "10",
  "Name": "Jack Doe",
  "Age": "97"
}

Chaves que não existem na planilha são ignoradas. Colunas ausentes são gravadas como células vazias.

Gravar em uma aba específica

Acrescente /tabs/<TabName> para gravar em uma aba diferente da primeira:

curl 'https://api.sheetbest.com/sheets/<api-id>/tabs/Admin' \
  -H 'Content-Type: application/json' \
  -d '[{"Name": "Jack Doe", "Age": 97}]'

Veja Trabalhar com abas.