Method: spreadsheets.values.append

Adjunta 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, comenzando por la primera columna. Consulta la guía y el código de muestra para obtener detalles específicos sobre cómo se detectan las tablas y se agregan los datos.

El llamador debe especificar el ID, el rango y un valueInputOption de la hoja de cálculo. valueInputOption solo controla cómo se agregarán los datos de entrada a la hoja (por columna o por fila), no influye en la celda en la que se comenzarán a escribir 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

string

Es el ID de la hoja de cálculo que se actualizará.
range

string

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

enum (ValueInputOption)

Indica cómo se deben interpretar los datos de entrada.
insertDataOption

enum (InsertDataOption)

Indica cómo se deben insertar los datos de entrada.
includeValuesInResponse

boolean

Determina si la respuesta de actualización debe incluir los valores de las celdas a las que se les agregaron valores. De forma predeterminada, las respuestas no incluyen los valores actualizados.
responseValueRenderOption

enum (ValueRenderOption)

Determina cómo se deben renderizar los valores en la respuesta. La opción de renderización predeterminada es FORMATTED_VALUE.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

Determina cómo se deben renderizar las fechas, las horas y las duraciones en la respuesta. Se ignora si responseValueRenderOption es FORMATTED_VALUE. La opción de renderización de fecha y hora predeterminada es SERIAL_NUMBER.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de ValueRange.

Cuerpo de la respuesta

Es 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 (UpdateValuesResponse)
  }
}
Campos
spreadsheetId

string

La hoja de cálculo a la que se aplicaron las actualizaciones.
tableRange

string

Es el rango (en notación A1) de la tabla a la que se agregan los valores (antes de que se agreguen los valores). Es un valor vacío si no se encontró ninguna tabla.
updates

object (UpdateValuesResponse)

Información sobre las actualizaciones que se aplicaron.

Permisos de autorización

Se necesita uno de los siguientes permisos 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.

Enumeraciones
OVERWRITE Los datos nuevos reemplazan los datos existentes en las áreas en las que 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.