Method: spreadsheets.values.update

Establece valores en un rango de una hoja de cálculo. El llamador debe especificar el ID de la hoja de cálculo, el rango y un valueInputOption.

Solicitud HTTP

PUT https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
spreadsheetId

string

El ID de la hoja de cálculo que se actualizará.

range

string

La notación A1 de los valores que se actualizarán.

Parámetros de consulta

Parámetros
valueInputOption

enum (ValueInputOption)

Cómo se deben interpretar los datos de entrada

includeValuesInResponse

boolean

Determina si la respuesta de actualización debe incluir los valores de las celdas que se actualizaron. De forma predeterminada, las respuestas no incluyen los valores actualizados. Si el rango que se debe escribir era mayor que el rango realmente escrito, la respuesta incluye todos los valores del rango solicitado (excluyendo las filas y columnas vacías finales).

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 predeterminada de dateTime es SERIAL_NUMBER.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de ValueRange.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de UpdateValuesResponse.

Alcances 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.