Actualizar filas (PUT / PATCH)

Tanto PUT como PATCH actualizan filas de tu hoja. Se diferencian en el tratamiento de las columnas que no incluyes en el cuerpo.

Método	Comportamiento
PATCH	Actualización parcial. Solo escribe las columnas del cuerpo; las demás permanecen intactas.
PUT	Sustitución completa. Vacía las columnas que no aparecen en el cuerpo en las filas afectadas.

Ambos métodos devuelven las filas afectadas.

Las actualizaciones requieren acceso de edición a la hoja de Google Sheets subyacente, igual que POST.

Actualizar una fila por índice

Añade a la URL el índice de fila, que empieza en cero. /1 actualiza la segunda fila de datos.

cURL

# PATCH: only updates Name, leaves other columns alone
curl 'https://api.sheetbest.com/sheets/<api-id>/1' \
  -X PATCH \
  -H 'Content-Type: application/json' \
  -d '{"Name": "Jack Doe"}'

# PUT: sets Name and blanks out every other column on row 1
curl 'https://api.sheetbest.com/sheets/<api-id>/1' \
  -X PUT \
  -H 'Content-Type: application/json' \
  -d '{"Name": "Jack Doe"}'

JavaScript

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

// PUT
fetch('https://api.sheetbest.com/sheets/<api-id>/1', {
  method: 'PUT',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ Name: 'Jack Doe' }),
});

Python

import requests

# PATCH
requests.patch(
    'https://api.sheetbest.com/sheets/<api-id>/1',
    json={'Name': 'Jack Doe'},
)

# PUT
requests.put(
    'https://api.sheetbest.com/sheets/<api-id>/1',
    json={'Name': 'Jack Doe'},
)

Actualizar mediante un filtro

Actualiza todas las filas que coincidan con un filtro de columna sustituyendo el índice de fila por /<Column>/<Value>. Se admiten comodines (*).

cURL

# Set Name to "Jack Doe" on every row whose Name contains "John"
curl 'https://api.sheetbest.com/sheets/<api-id>/Name/*John*' \
  -X PATCH \
  -H 'Content-Type: application/json' \
  -d '{"Name": "Jack Doe"}'

JavaScript

fetch('https://api.sheetbest.com/sheets/<api-id>/Name/*John*', {
  method: 'PATCH',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ Name: 'Jack Doe' }),
});

Python

requests.patch(
    'https://api.sheetbest.com/sheets/<api-id>/Name/*John*',
    json={'Name': 'Jack Doe'},
)

PUT funciona de la misma forma; recuerda que vacía las columnas que no aparecen en el cuerpo en cada fila coincidente.

La sintaxis del filtro es la misma que se usa para leer. Consulta Filtrar datos para ver coincidencias exactas, comodines y opciones de varias columnas. Las actualizaciones también admiten el prefijo /tabs/<TabName>; consulta Trabajar con pestañas.

Respuesta

Ambos métodos devuelven las filas afectadas tras aplicar la actualización:

[
  { "Id": "1", "Name": "Jack Doe", "Age": "23" }
]

Usar la semántica de PATCH desde un cliente que solo admite PUT

Algunos clientes (bibliotecas HTTP antiguas, ciertas plataformas no-code, entornos integrados o herramientas de webhooks) solo pueden enviar PUT. Para obtener el comportamiento de PATCH (actualización parcial) desde uno de estos clientes, envía una solicitud PUT e incluye el encabezado X-HTTP-Method-Override con el valor PATCH:

curl 'https://api.sheetbest.com/sheets/<api-id>/1' \
  -X PUT \
  -H 'Content-Type: application/json' \
  -H 'X-HTTP-Method-Override: PATCH' \
  -d '{"Name": "Jack Doe"}'

Sheet Best procesará la solicitud como si hubieras enviado PATCH: las columnas que no aparecen en el cuerpo permanecerán intactas en lugar de vaciarse.

Consulta Encabezados personalizados para ver la referencia completa, incluidos los métodos y valores admitidos.