Añadir filas (POST)

Envía una solicitud POST a la URL de tu hoja para añadir filas al final. El cuerpo puede ser un objeto JSON (una fila) o un arreglo de objetos (varias filas). Las claves deben coincidir con los encabezados de columna de la hoja.

Se requiere permiso de edición

Las escrituras se realizan a través de Google Sheets, por lo que la conexión necesita acceso de edición:

• Para hojas públicas, configura Cualquier persona con el enlace → Editor.
• Para hojas privadas, usa Conectar con Drive.

Sin acceso de edición, la API responde con write_error.

Añadir una sola fila

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

Añadir varias filas

Envía un arreglo para insertar varias filas en una sola solicitud:

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

Respuesta

Una inserción correcta devuelve las filas escritas:

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

Las claves que no existen en la hoja se ignoran. Las columnas ausentes se escriben como celdas vacías.

Escribir en una pestaña específica

Añade /tabs/<TabName> para escribir en una pestaña distinta de la primera:

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

Consulta Trabajar con pestañas.