Method: spreadsheets.values.clear

Borra los valores de una hoja de cálculo. El llamador debe especificar el ID y el rango de la hoja de cálculo. Solo se borran los valores y se conservan todas las demás propiedades de la celda (como el formato, la validación de datos, etc.).

Solicitud HTTP

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

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 o R1C1 de los valores que se deben borrar.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta cuando se borra 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,
  "clearedRange": string
}
Campos
spreadsheetId

string

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

string

El rango (en notación A1) que se borró. (Si la solicitud era para un rango no delimitado o un rango mayor que los límites de la hoja, este será el rango real que se borró, delimitado según los límites de la hoja).

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.