Se usó la API de Cloud Translation para traducir esta página.

Filtros

Los filtros te permiten ordenar y filtrar los datos que ves cuando visualizas una hoja de cálculo. Los filtros no cambian los valores de los datos en tu hoja de cálculo. Puedes usar filtros para ocultar o ordenar información de forma temporal. Los datos que coincidan con los criterios de filtro especificados no aparecerán mientras el filtro esté activado. Con las vistas de filtros, también puedes guardar diferentes filtros con nombre y cambiar entre ellos cuando quieras.

Los siguientes son algunos ejemplos de casos de uso de los filtros:

Ordena los datos por una columna en particular. Por ejemplo, ordena los registros de usuarios por nombre completo.
Ocultar datos que cumplan con una condición específica Por ejemplo, oculta todos los registros que tengan más de 2 años.
Oculta los datos que coincidan con un valor determinado. Por ejemplo, oculta todos los problemas con el estado “cerrado”.

Filtro básico

El BasicFilter de una hoja de cálculo es el filtro predeterminado que se aplica cada vez que alguien la ve. Una hoja de cálculo puede tener un filtro básico por hoja. Para desactivar el filtro básico, bórralo. Esta acción quita el filtro y todos sus parámetros de configuración de la hoja de cálculo. Si quieres volver a activar el mismo filtro, debes volver a establecer los criterios.

Administra el filtro básico

Para establecer o borrar el filtro básico, usa el método spreadsheets.batchUpdate con el tipo de solicitud adecuado:

Para establecer el filtro básico, usa el método SetBasicFilterRequest.
Para borrar el filtro básico, usa el método ClearBasicFilterRequest.

Para enumerar el filtro básico, usa el método spreadsheets.get y establece el parámetro de URL fields en sheets/basicFilter. En la siguiente muestra de código spreadsheets.get, se muestra una URL de Hojas de cálculo de Google con una máscara de campo:

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID?fields=sheets/basicFilter)

Vistas de filtro

Un FilterView es un filtro con nombre que puedes activar y desactivar cuando quieras. Una hoja de cálculo puede tener varias vistas de filtros, pero solo puedes aplicar una a la vez.

Los siguientes son algunos ejemplos de casos de uso de las vistas de filtro:

Tienes varios filtros diferentes entre los que deseas cambiar cuando ves los datos.
No tienes acceso de edición a una hoja de cálculo, pero aún quieres aplicar un filtro. En este caso, puedes crear una vista de filtro temporal que solo tú puedas ver.
Quieres que cada persona con la que compartas tu hoja de cálculo vea los datos de manera diferente. Para especificar la vista de filtro que deseas aplicar, proporciona spreadsheetId y filterViewId en la URL de la hoja de cálculo. Para ello, usa el filterViewId que se muestra en la respuesta cuando creas la vista de filtro.

En la siguiente muestra de código, se muestra una URL de Hojas de cálculo de Google con una vista de filtro:
```
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit#gid=0&fvid=FILTER_VIEW_ID
```

Administra las vistas de filtro

Para crear, duplicar, modificar o borrar vistas de filtro, usa el método spreadsheets.batchUpdate con el tipo de solicitud adecuado:

Para crear una vista de filtro, usa el método AddFilterViewRequest.
Para crear una copia de una vista de filtro, usa el método DuplicateFilterViewRequest.
Para modificar las propiedades de una vista de filtro, usa el método UpdateFilterViewRequest.
Para borrar una vista de filtro, usa el método DeleteFilterViewRequest.

Para enumerar todas tus vistas de filtros, usa el método spreadsheets.get y establece el parámetro de URL fields en sheets/filterViews. En la siguiente muestra de código spreadsheets.get, se muestra una URL de Hojas de cálculo de Google con una máscara de campo:

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID?fields=sheets/filterViews)

Representación del filtro

En el siguiente ejemplo de código, se muestra la representación JSON de un objeto FilterView. El objeto BasicFilter es el mismo, excepto que no tiene los campos filterViewId y title, y no puede usar un rango con nombre.

{
  "filterViewId": number,
  "title": string,
  "range": {
    object(GridRange)
  },
  "namedRangeId": string,
  "sortSpecs": [
    {
      object(SortSpec)
    }
  ],
  "criteria": {
    string: {
      object(FilterCriteria)
    },
    ...
  }
}

Datos de ejemplo

En el resto de este documento, se hace referencia a la siguiente tabla de ejemplo de datos de ventas:

**Tabla 1.** Ejemplo de datos de ventas
	A	B	C	D	E	F	G
1	Item Category	Número de modelo	Costo	Cantidad	Región	Vendedor	Fecha de envío
2	Rueda de la fortuna	W-24	USD 20.50	4	Oeste	Beth	1/3/2016
3	Puerta	D-01X	USD 15.00	2	Sur	Amir	15/3/2016
4	Marco	FR-0B1	USD 34.00	8	Este	Hannah	12/3/2016
5	Panel	P-034	USD 6.00	4	Norte	Devyn	15/3/2016
6	Panel	P-052	USD 11.50	7	Este	Erik	16/5/2016
7	Rueda de la fortuna	W-24	USD 20.50	11	Sur	Sheldon	30/4/2016
8	Motor	ENG-0161	USD 330.00	2	Norte	Jessie	2/7/2016

Especificaciones de orden

Un filtro puede tener varias especificaciones de orden. Estas especificaciones determinan cómo ordenar los datos y se aplican en el orden especificado. El atributo SortSpec.dimensionIndex especifica el índice de columna al que se debe aplicar el orden.

En el siguiente ejemplo de código, se muestra una especificación de ordenamiento:

[
  {
    "dimensionIndex": 3,
    "sortOrder": "ASCENDING"
  },
  {
    "dimensionIndex": 6,
    "sortOrder": "ASCENDING"
  }
]

Cuando se aplica a los datos de ventas de ejemplo, esta especificación ordena primero por “Cantidad” y, luego, si 2 filas tienen la misma cantidad, por “Fecha de embarque”.

**Tabla 2.** Datos de ventas ordenados por 2 columnas
	A	B	C	D	E	F	G
1	Item Category	Número de modelo	Costo	Cantidad	Región	Vendedor	Fecha de envío
2	Puerta	D-01X	USD 15.00	2	Sur	Amir	15/3/2016
3	Motor	ENG-0161	USD 330.00	2	Norte	Jessie	2/7/2016
4	Rueda de la fortuna	W-24	USD 20.50	4	Oeste	Beth	1/3/2016
5	Panel	P-034	USD 6.00	4	Norte	Devyn	15/3/2016
6	Panel	P-052	USD 11.50	7	Este	Erik	16/5/2016
7	Marco	FR-0B1	USD 34.00	8	Este	Hannah	12/3/2016
8	Rueda de la fortuna	W-24	USD 20.50	11	Sur	Sheldon	30/4/2016

Criterios de filtro

El método FilterCriteria determina qué datos de la hoja de cálculo se muestran o se ocultan en un filtro básico o en una vista de filtro. Cada criterio depende de los valores de una columna específica. Proporcionas los criterios de filtro como un mapa en el que las claves son los índices de columna y los valores son los criterios.

Para los criterios especificados con un condition booleano, la condición debe ser True para que se muestren los valores. La condición no anula hiddenValues. Si un valor aparece en hiddenValues, todas las coincidencias de un valor aún están ocultas.

En la siguiente muestra de código, se muestra un mapa de criterios de filtro:

{
  0: {
    'hiddenValues': ['Panel']
  },
  6: {
    'condition': {
      'type': 'DATE_BEFORE',
      'values': {
        'userEnteredValue': '4/30/2016'
      }
    }
  }
}

Cuando se aplica a los datos de ventas de ejemplo, este criterio solo muestra filas en las que "Categoría del artículo" no es "Panel" y en las que la "Fecha de envío" es anterior al 30 de abril de 2016.

**Tabla 3.** Datos de ventas con criterios de filtro
	A	B	C	D	E	F	G
1	Item Category	Número de modelo	Costo	Cantidad	Región	Vendedor	Fecha de envío
2	Rueda de la fortuna	W-24	USD 20.50	4	Oeste	Beth	1/3/2016
3	Puerta	D-01X	USD 15.00	2	Sur	Amir	15/3/2016
4	Marco	FR-0B1	USD 34.00	8	Este	Hannah	12/3/2016

Muestra

En la siguiente muestra de código, se muestra cómo crear una vista de filtro, duplicarla y, luego, actualizar la versión duplicada con los datos de ventas de ejemplo anteriores.

Python

sheets/snippets/sheets_filter_views.py

Ver en GitHub

import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError


def filter_views(spreadsheet_id):
  """
  Creates the batch_update the user has access to.
  Load pre-authorized user credentials from the environment.
  TODO(developer) - See https://developers.google.com/identity
  for guides on implementing OAuth2 for the application.
  """
  creds, _ = google.auth.default()
  # pylint: disable=maybe-no-member
  try:
    service = build("sheets", "v4", credentials=creds)

    my_range = {
        "sheetId": 0,
        "startRowIndex": 0,
        "startColumnIndex": 0,
    }
    addfilterviewrequest = {
        "addFilterView": {
            "filter": {
                "title": "Sample Filter",
                "range": my_range,
                "sortSpecs": [{
                    "dimensionIndex": 3,
                    "sortOrder": "DESCENDING",
                }],
                "criteria": {
                    0: {"hiddenValues": ["Panel"]},
                    6: {
                        "condition": {
                            "type": "DATE_BEFORE",
                            "values": {"userEnteredValue": "4/30/2016"},
                        }
                    },
                },
            }
        }
    }

    body = {"requests": [addfilterviewrequest]}
    addfilterviewresponse = (
        service.spreadsheets()
        .batchUpdate(spreadsheetId=spreadsheet_id, body=body)
        .execute()
    )

    duplicatefilterviewrequest = {
        "duplicateFilterView": {
            "filterId": addfilterviewresponse["replies"][0]["addFilterView"][
                "filter"
            ]["filterViewId"]
        }
    }

    body = {"requests": [duplicatefilterviewrequest]}
    duplicatefilterviewresponse = (
        service.spreadsheets()
        .batchUpdate(spreadsheetId=spreadsheet_id, body=body)
        .execute()
    )

    updatefilterviewrequest = {
        "updateFilterView": {
            "filter": {
                "filterViewId": duplicatefilterviewresponse["replies"][0][
                    "duplicateFilterView"
                ]["filter"]["filterViewId"],
                "title": "Updated Filter",
                "criteria": {
                    0: {},
                    3: {
                        "condition": {
                            "type": "NUMBER_GREATER",
                            "values": {"userEnteredValue": "5"},
                        }
                    },
                },
            },
            "fields": {"paths": ["criteria", "title"]},
        }
    }

    body = {"requests": [updatefilterviewrequest]}
    updatefilterviewresponse = (
        service.spreadsheets()
        .batchUpdate(spreadsheetId=spreadsheet_id, body=body)
        .execute()
    )
    print(str(updatefilterviewresponse))
  except HttpError as error:
    print(f"An error occurred: {error}")


if __name__ == "__main__":
  # Pass: spreadsheet_id
  filter_views("1CM29gwKIzeXsAppeNwrc8lbYaVMmUclprLuLYuHog4k")