Buscar términos y operadores de búsqueda

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

Para ver ejemplos de búsqueda de archivos, consulta Busca archivos y carpetas.

Para ver ejemplos de búsquedas de unidades compartidas, consulta Busca unidades compartidas.

Sintaxis de la cadena de consulta

Una cadena de consulta contiene las siguientes tres partes:

query_term operator values

Aquí:

  • query_term es el término o campo de búsqueda que se va a buscar.

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

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

Operadores de consultas

En la siguiente tabla, se enumeran los operadores de consulta válidos:

Operador Uso
contains El contenido de una cadena está presente en la otra.
= El contenido de una cadena o de un valor booleano es igual al otro.
!= El contenido de una cadena o de 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 se encuentra dentro de una colección.
and Mostrar artículos que coincidan con ambas búsquedas
or Muestra elementos que coincidan con cualquiera de las 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 de archivos

En la siguiente tabla, se enumeran todos los términos válidos de consulta de archivos. Para los tipos de datos y descripciones, consulta el recurso files referencia.

Término de búsqueda Operadores válidos Uso
name contains, =, != Nombre del archivo. Rodea con comillas simples ('). Escape de 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. Rodea con comillas simples ('). Escape de las comillas simples en las consultas con \', como 'Valentine\'s Day'.
mimeType contains, =, != Es el tipo de MIME del archivo. Rodea con comillas simples ('). Escape de 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 <=, <, =, !=, >, >= Fecha de la última modificación del archivo. RFC 3339; la zona horaria predeterminada es UTC, como 2012-06-04T12:00:00-08:00. Los campos de tipo date no son comparables entre sí, solo con fechas constantes.
viewedByMeTime <=, <, =, !=, >, >= La fecha en la que el usuario vio un archivo por última vez. RFC 3339; la zona horaria predeterminada es UTC, como 2012-06-04T12:00:00-08:00. Los campos de tipo date no son comparables entre sí, solo con fechas constantes.
trashed =, != 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 superior contiene el ID especificado.
owners in Son los 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 =, != Archivos que se encuentran en la sección "Compartidos conmigo" del usuario colección. Todos los usuarios de los archivos están en la Lista de control de acceso (LCA) del archivo. Puede ser true o false.
createdTime <=, <, =, !=, >, >= Fecha en la que se creó la unidad compartida. Usa el formato RFC 3339. La zona horaria predeterminada es UTC, como 2012-06-04T12:00:00-08:00.
properties has Propiedades públicas de archivos personalizados.
appProperties has Propiedades de archivos personalizados privados.
visibility =, != El nivel de visibilidad del archivo. Los valores válidos son anyoneCanFind, anyoneWithLink, domainCanFind, domainWithLink y limited. Rodea con comillas simples (').
shortcutDetails.targetId =, != El ID del elemento al que apunta el acceso directo.

A continuación, se muestran las combinaciones de operador y término de búsqueda:

  • El operador contains solo busca coincidencias de prefijos para un Término de name. Por ejemplo, imagina que tienes un nombre de HelloWorld. Una consulta de name contains 'Hello' muestra un resultado, pero no lo hace una consulta de name contains 'World'.

  • El operador contains solo busca coincidencias en tokens de cadenas completos para el término fullText. Por ejemplo, si el texto completo de un documento contiene la cadena "HelloWorld", solo la consulta fullText contains 'HelloWorld' devuelve un resultado.

  • El operador contains coincide con una frase alfanumérica exacta si se trata de Está rodeado de comillas dobles. Por ejemplo, si el fullText de un documento contiene la cadena "Hello there world"; entonces, la consulta fullText contains '"Hello there"' muestra un resultado, pero la consulta fullText contains '"Hello world"' no. Además, debido a que la búsqueda es alfanumérica, si el valor completo texto de un documento contiene la cadena "Hello_world" y, luego, la consulta fullText contains '"Hello world"' muestra un resultado.

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

Para ver más ejemplos de búsquedas de cadenas de consulta, consulta cadena de consulta de archivo. ejemplos comunes.

Términos de búsqueda específicos de unidades compartidas

En la siguiente tabla, se enumeran todos los términos válidos de consulta de unidades compartidas. Para los tipos de datos y descripciones, consulta el recurso drives referencia.

Término de búsqueda Operadores válidos Uso Configuración useDomainAdminAccess
createdTime <=, <, =, !=, >, >= Fecha en la que se creó la unidad compartida. 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 <=, <, =, !=, >, >= 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. Rodea con comillas simples ('). Escape de las comillas simples en las consultas con \', como 'Valentine\'s Day'. true
organizerCount <=, <, =, !=, >, >= Cantidad de usuarios y grupos que son organizadores de la unidad compartida. Toma un valor numérico. true
orgUnitId =, != El ID de la unidad organizativa de una unidad compartida. Toma un valor de cadena. true

Para ver más ejemplos de búsquedas de cadenas de consulta, visita cadena de consulta de unidades compartidas ejemplos comunes.