- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de autorización
- Pruébalo
Borra uno o más rangos de valores de una hoja de cálculo. El emisor debe especificar el ID de la hoja de cálculo y uno o más rangos. Solo se borran los valores; se conservan todas las demás propiedades de la celda (como el formato y la validación de datos).
Solicitud HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchClear
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
spreadsheetId |
El ID de la hoja de cálculo que se actualizará. |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "ranges": [ string ] } |
Campos | |
---|---|
ranges[] |
Los rangos que se borrarán, en notación A1 o notación R1C1. |
Cuerpo de la respuesta
La 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, "clearedRanges": [ string ] } |
Campos | |
---|---|
spreadsheetId |
La hoja de cálculo a la que se aplicaron las actualizaciones. |
clearedRanges[] |
Los rangos que se borraron, en notación A1. Si las solicitudes corresponden a un rango no delimitado o a un rango mayor que los límites de la hoja, estos son los rangos reales que se borraron, delimitados a los límites de la hoja. |
Alcances 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.