Una cadena de consulta contiene las siguientes 3 partes:
query_term operator values
Aquí:
query_term es el campo o término de búsqueda en el que se realizará la búsqueda.
operator especifica la condición para el término de consulta.
values son los valores específicos que deseas usar para filtrar tus resultados de búsqueda.
En esta referencia, se proporcionan los operadores y los términos de consulta que puedes usar con la API de Google Drive.
Operadores de consultas
En esta tabla, se enumeran todos los operadores de consultas válidos:
Operador | Uso |
---|---|
contains |
El contenido de una string está presente en la otra. |
= |
El contenido de una string o booleano es igual al otro. |
!= |
El contenido de un string o 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 |
Muestra elementos que coinciden con ambas consultas. |
or |
Muestra elementos que coinciden con cualquiera de las consultas. |
not |
Negar una consulta de 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 tipos y descripciones de datos, consulta la referencia del recurso files
.
Término de búsqueda | Operadores válidos | Uso |
---|---|---|
name |
contains , = , != |
Nombre del archivo. Encierra el texto entre comillas simples ' . Usa comillas simples en las consultas con \' , como 'Valentine\'s Day' . |
fullText |
contains |
Indica si las propiedades name , description o indexableText o el texto del contenido o los metadatos del archivo coinciden. Encierra el texto entre comillas simples ' . Usa comillas simples en las consultas con \' , como 'Valentine\'s Day' . |
mimeType |
contains , = , != |
Tipo MIME del archivo. Encierra el texto entre comillas simples ' . Usa 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 de Google Workspace y 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 . Por el momento, los campos de tipo date no se pueden comparar entre sí, solo con fechas constantes. |
viewedByMeTime |
<= , < , = , != , > , >= |
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 . Por el momento, los campos de tipo date no se pueden comparar entre sí, solo con fechas constantes. |
trashed |
= , != |
Si el archivo está en la papelera o no Puede ser true o false . |
starred |
= , != |
Si el archivo está destacado o no Puede ser true o false . |
parents |
in |
Indica si la colección de padres contiene el ID especificado. |
owners |
in |
Usuarios que poseen el archivo. |
writers |
in |
Usuarios o grupos que tienen permiso para modificar el archivo. Consulta la referencia de recursos de Permisos. |
readers |
in |
Usuarios o grupos que tienen permiso para leer el archivo. Consulta la referencia de recursos de Permisos. |
sharedWithMe |
= , != |
Archivos que se encuentran en la colección "Compartidos conmigo" del usuario Todos los usuarios del archivo están en la lista de control de acceso (LCA) del archivo. Puede ser true o false . |
createdTime |
<= , < , = , != , > , >= |
Fecha en 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 los archivos personalizados. |
appProperties |
has |
Propiedades privadas de los archivos personalizados |
visibility |
= , != |
El nivel de visibilidad del archivo. Los valores válidos son anyoneCanFind , anyoneWithLink , domainCanFind , domainWithLink y limited . Encierra el texto entre 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 la coincidencia de prefijos para un términoname
. Por ejemplo, supongamos que tienes un nombre deHelloWorld
. Una consulta dename contains 'Hello'
muestra un resultado, pero una consulta dename contains 'World'
no.El operador
contains
solo realiza coincidencias en tokens de string completos para el términofullText
. Por ejemplo, si el texto completo de un documento contiene la string “HelloWorld”, solo la consultafullText contains 'HelloWorld'
muestra un resultado.El operador
contains
coincide en una frase alfanumérica exacta si está entre comillas dobles. Por ejemplo, si elfullText
de un documento contiene la string "Hello there world", la consultafullText contains '"Hello there"'
muestra un resultado, pero la consultafullText contains '"Hello world"'
no. Además, como la búsqueda es alfanumérica, si el texto completo de un documento contiene la string "Hello_world", la consultafullText contains '"Hello world"'
muestra un resultado.Los términos
owners
,writers
yreaders
se reflejan indirectamente en la lista Permisos y hacen referencia arole
en el permiso.
Para obtener más ejemplos de búsquedas de strings de consulta, visita Ejemplos de string 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 de unidades compartidas válidos. Para obtener información sobre los tipos de datos y descripciones, consulta la referencia del recurso drives.
Término de búsqueda | Operadores válidos | Uso | Configuración de useDomainAdminAccess obligatoria |
---|---|---|---|
createdTime |
<= , < , = , != , > , >= |
Fecha en 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 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 , = , != |
Nombre de la unidad compartida. Encierra el texto entre comillas simples ' . Usa comillas simples en las consultas con \' , como 'Valentine\'s Day' . |
false |
organizerCount |
<= , < , = , != , > , >= |
Cantidad de usuarios y grupos que organizan la unidad compartida. Toma un valor numérico. | true |
orgUnitId |
= , != |
Es el ID de unidad organizativa (UO) de una unidad compartida. Toma un valor de string. | true |