Buscar términos y operadores de búsqueda

Una cadena de consulta contiene las siguientes tres partes:

query_term operator values

Donde:

  • query_term es el término o campo de búsqueda.

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

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

En esta referencia, se proporcionan los términos de consulta y los operadores que puedes usar con la API de Google Drive.

Operadores de consultas

En esta tabla, se enumeran todos 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 un valor booleano es igual al otro.
!= El contenido de una cadena o un valor booleano no es igual que el 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 Muestra elementos que coinciden con ambas búsquedas.
or Muestra elementos que coinciden con cualquiera de las búsquedas.
not Negara 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 válidos de búsqueda de archivos. Para conocer los tipos de datos y las descripciones, consulta la referencia del recurso de files.

Término de búsqueda Operadores válidos Uso
name contains, = y != Nombre del archivo. Rodea con comillas simples '. Escapa las comillas simples en las consultas con \', como 'Valentine\'s Day'.
fullText contains Indica si coinciden las propiedades name, description y indexableText, o bien el texto en el contenido o los metadatos del archivo. Rodea con comillas simples '. Escapa las comillas simples en las consultas con \', como 'Valentine\'s Day'.
mimeType contains, = y != Es el tipo de MIME del archivo. Rodea con 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 <=, <, =, !=, >, >= Fecha de la última modificación del archivo. En formato 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 <=, <, =, !=, >, >= Fecha en la que el usuario vio un archivo por última vez. En formato 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 =, != 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 Si la colección principal contiene el ID especificado
owners in Los usuarios que son propietarios del archivo
writers in Usuarios o grupos que tienen permiso para modificar el archivo. Consulta la referencia del recurso Permiso.
readers in Los usuarios o grupos que tienen permiso para leer el archivo. Consulta la referencia del recurso Permiso.
sharedWithMe =, != Archivos que se encuentran en la colección "Compartidos conmigo" del usuario Todos los usuarios de archivos se encuentran 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 del archivo personalizado
appProperties has Propiedades privadas de archivos personalizadas
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 operadores y términos de consulta:

  • El operador contains solo realiza coincidencias de prefijos para un término name. Por ejemplo, supongamos que tienes un nombre de HelloWorld. Una consulta de name contains 'Hello' muestra un resultado, pero una consulta de name contains 'World' no.

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

  • El operador contains coincide con una frase alfanumérica exacta si está rodeada de comillas dobles. Por ejemplo, si el fullText de un documento contiene la string “Hello there world”, entonces la consulta fullText contains '"Hello there"' muestra un resultado, pero la consulta fullText contains '"Hello world"' no lo hace. Además, como la búsqueda es alfanumérica, si el texto completo de un documento contiene la string “Hello_world”, la consulta fullText contains '"Hello world"' mostrará un resultado.

  • Los términos owners, writers y readers se reflejan indirectamente en la lista permissions y hacen referencia a role en el permiso.

Para ver más ejemplos de búsquedas de cadenas de consulta, consulta Ejemplos de cadenas de consulta.

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 de la unidad compartida. Para conocer los tipos de datos y las descripciones, consulta la referencia de recursos de Drive.

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