Buscar términos y operadores de búsqueda

En esta guía de referencia, se proporcionan los términos y operadores de búsqueda que puedes usar con la API de Google Drive para filtrar archivos, carpetas y unidades compartidas.

Para ver ejemplos de búsqueda de archivos, consulta Cómo buscar archivos y carpetas.

Para ver ejemplos de búsquedas de unidades compartidas, consulta Cómo buscar unidades compartidas.

Sintaxis de la cadena de consulta

Una cadena de consulta contiene las siguientes tres partes:

query_term operator values

Donde:

  • query_term es el término de búsqueda o el campo en el que se realizará la búsqueda.

  • operator especifica la condición del término de búsqueda.

  • values son los valores específicos que deseas usar para filtrar los resultados de la búsqueda.

Operadores de consultas

En la siguiente tabla, se enumeran los operadores de búsqueda válidos:

Operador Uso
contains El contenido de una cadena está presente en la otra.
= El contenido de una cadena o un valor booleano es igual al otro.
!= El contenido de una cadena o un valor booleano no es igual al otro.
< Un valor es menor que otro.
<= Un valor es menor o igual que otro.
> Un valor es mayor que otro.
>= Un valor es mayor o igual que otro.
in Un elemento está contenido dentro de una colección.
and Devuelve los elementos que coinciden con ambas búsquedas.
or Devuelve los elementos que coinciden con cualquiera de las dos búsquedas.
not Niega una búsqueda.
has Una colección contiene un elemento que coincide con los parámetros.

Términos de búsqueda específicos del archivo

En la siguiente tabla, se enumeran todos los términos de búsqueda de archivos válidos. Para obtener información sobre los tipos de datos y las descripciones, consulta la referencia del recurso files.

Término de búsqueda Operadores válidos Uso
name contains, =, != Nombre del archivo. Encierra entre comillas simples ('). Escapa las comillas simples en las consultas con \', como 'Valentine\'s Day'.
fullText contains Indica si coinciden las propiedades name, description, indexableText o el texto del contenido o los metadatos del archivo. Encierra entre comillas simples ('). Escapa las comillas simples en las consultas con \', como 'Valentine\'s Day'.
mimeType contains, =, != Tipo MIME del archivo. Encierra entre comillas simples ('). Escapa las comillas simples en las consultas con \', como 'Valentine\'s Day'. Para obtener más información sobre los tipos de MIME, consulta Tipos de MIME compatibles con Google Workspace y Google Drive.
modifiedTime <=, <, =, !=, > y >= Fecha de la última modificación del archivo. Formato RFC 3339, la zona horaria predeterminada es UTC, como 2012-06-04T12:00:00-08:00. Los campos del tipo date no son comparables entre sí, solo con fechas constantes.
viewedByMeTime <=, <, =, !=, > y >= Fecha en la que el usuario vio un archivo por última vez. Formato RFC 3339, la zona horaria predeterminada es UTC, como 2012-06-04T12:00:00-08:00. Los campos del tipo date no son comparables entre sí, solo con fechas constantes.
trashed =, != Indica si el archivo está en la papelera o no. Puede ser true o false.
starred =, != Indica si el archivo está destacado o no. Puede ser true o false.
parents in Indica si la colección de elementos principales contiene el ID especificado.
owners in Usuarios que son propietarios del archivo
writers in Usuarios o grupos que tienen permiso para modificar el archivo. Consulta la referencia del recurso permissions.
readers in Usuarios o grupos que tienen permiso para leer el archivo Consulta la referencia del recurso permissions.
sharedWithMe =, != Son los archivos que se encuentran en la colección "Compartidos conmigo" del usuario. Todos los usuarios del archivo se encuentran en la Lista de control de acceso (LCA) del archivo. Puede ser true o false.
createdTime <=, <, =, !=, > y >= Fecha en la que se creó el archivo. Usa el formato RFC 3339. La zona horaria predeterminada es UTC, como 2012-06-04T12:00:00-08:00.
properties has Son propiedades de archivos personalizadas públicas.
appProperties has Son las propiedades personalizadas privadas del archivo.
visibility =, != Es el nivel de visibilidad del archivo. Los valores válidos son anyoneCanFind, anyoneWithLink, domainCanFind, domainWithLink y limited. Encierra entre comillas simples (').
shortcutDetails.targetId =, != Es el ID del elemento al que apunta el acceso directo.

A continuación, se muestran combinaciones de operadores y términos de búsqueda:

  • El operador contains solo realiza la coincidencia de prefijos para un término name. Por ejemplo, supongamos que tienes un nombre de HelloWorld. Una búsqueda de name contains 'Hello' devuelve un resultado, pero una búsqueda de name contains 'World' no lo hace.

  • El operador contains solo realiza la coincidencia en tokens de cadena completos para el término fullText. Por ejemplo, si el texto completo de un documento contiene la cadena "HelloWorld", solo la búsqueda fullText contains 'HelloWorld' devolverá un resultado.

  • El operador contains coincide con una frase alfanumérica exacta si el operando derecho está entre comillas dobles. Por ejemplo, si el fullText de un documento contiene la cadena "Hola mundo", la búsqueda fullText contains '"Hello there"' devuelve un resultado, pero la búsqueda fullText contains '"Hello world"' no lo hace. Además, dado que la búsqueda es alfanumérica, si el texto completo de un documento contiene la cadena "Hello_world", la búsqueda fullText contains '"Hello world"' devuelve un resultado.

  • Los términos owners, writers y readers se reflejan indirectamente en la lista permissions y hacen referencia al role en el permiso. Para obtener una lista completa de los permisos de los roles, consulta Roles y permisos.

Para obtener más ejemplos de búsquedas con cadenas de consulta, consulta los ejemplos de cadenas de consulta de archivos.

Términos de búsqueda específicos de la unidad compartida

En la siguiente tabla, se enumeran todos los términos de búsqueda válidos para las unidades compartidas. Para obtener información sobre los tipos de datos y las descripciones, consulta la referencia del recurso drives.

Término de búsqueda Operadores válidos Uso Configuración useDomainAdminAccess
createdTime <=, <, =, !=, > y >= Fecha en la que se creó la unidad compartida. Formato RFC 3339, la zona horaria predeterminada es UTC, como 2012-06-04T12:00:00-08:00. true
hidden =, != Especifica si la unidad compartida está oculta. Puede ser true o false. false
memberCount <=, <, =, !=, > y >= Cantidad de usuarios y grupos que son miembros de la unidad compartida. Toma un valor numérico. true
name contains, =, != Nombre de la unidad compartida. Encierra entre comillas simples ('). Escapa las comillas simples en las consultas con \', como 'Valentine\'s Day'. true
organizerCount <=, <, =, !=, > y >= Cantidad de usuarios y grupos que son organizadores de la unidad compartida. Toma un valor numérico. true
orgUnitId =, != Es el ID de la unidad organizativa de una unidad compartida. Toma un valor de cadena. true

Para obtener más ejemplos de búsquedas con cadenas de consulta, consulta los ejemplos de cadenas de consulta de unidades compartidas.