- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- InsertDataOption;
- Pruébala
Agrega valores a una hoja de cálculo. El rango de entrada se usa para buscar datos existentes y encontrar una “tabla” dentro de ese rango. Los valores se agregarán a la siguiente fila de la tabla, a partir de la primera columna de la tabla. Consulta la guía y el código de muestra para obtener detalles específicos sobre cómo se detectan las tablas y se adjuntan los datos.
El llamador debe especificar el ID de la hoja de cálculo, el rango y un valueInputOption
. valueInputOption
solo controla cómo se agregarán los datos de entrada a la hoja (en términos de columnas o filas). No influye en a qué celda comienzan a escribirse los datos.
Solicitud HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
spreadsheetId |
Es el ID de la hoja de cálculo que se actualizará. |
range |
La notación A1 de un rango para buscar una tabla lógica de datos. Los valores se agregan después de la última fila de la tabla. |
Parámetros de consulta
Parámetros | |
---|---|
valueInputOption |
Cómo deben interpretarse los datos de entrada. |
insertDataOption |
Cómo se deben insertar los datos de entrada. |
includeValuesInResponse |
Determina si la respuesta de actualización debe incluir los valores de las celdas que se anexaron. De forma predeterminada, las respuestas no incluyen los valores actualizados. |
responseValueRenderOption |
Determina cómo se deben renderizar los valores en la respuesta. La opción de renderización predeterminada es |
responseDateTimeRenderOption |
Determina la manera en que se deben renderizar las fechas, los horarios y las duraciones de la respuesta. Se ignora si |
Cuerpo de la solicitud
El cuerpo de la solicitud incluye una instancia de ValueRange
.
Cuerpo de la respuesta
La respuesta cuando se actualiza un rango de valores en una hoja de cálculo.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{
"spreadsheetId": string,
"tableRange": string,
"updates": {
object ( |
Campos | |
---|---|
spreadsheetId |
La hoja de cálculo a la que se aplicaron las actualizaciones |
tableRange |
El rango (en notación A1) de la tabla a la que se agregan los valores (antes de que se agreguen). Estará vacío si no se encontró ninguna tabla. |
updates |
Información sobre las actualizaciones que se aplicaron. |
Permisos de autorización
Se necesita uno de los siguientes alcances de OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
Para obtener más información, consulta la Guía de autorización.
InsertDataOption
Determina cómo se modifican los datos existentes cuando se ingresan datos nuevos.
Enumeradores | |
---|---|
OVERWRITE |
Los datos nuevos reemplazan los datos existentes en las áreas donde se escriben. Nota: Si agregas datos al final de la hoja, se insertarán filas o columnas nuevas para que se puedan escribir los datos. |
INSERT_ROWS |
Se insertan filas para los datos nuevos. |