Method: spreadsheets.values.batchClearByDataFilter

Borra uno o más rangos de valores de una hoja de cálculo. El llamador debe especificar el ID de la hoja de cálculo y uno o más DataFilters. Se borrarán los rangos que coincidan con cualquiera de los filtros de datos especificados. Solo se borran los valores; 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:batchClearByDataFilter

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

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
Campos
dataFilters[]

object (DataFilter)

El DataFilters que se usa para determinar qué rangos se deben borrar.

Cuerpo de la respuesta

La respuesta cuando se borra un rango de valores seleccionado con DataFilters 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

string

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

clearedRanges[]

string

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.