Esta guía de referencia proporciona operadores y términos de consulta 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.
Por ejemplo, para buscar 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
Aquí:
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 para el término de la 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 de 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 se encuentra dentro de una colección. |
and |
Muestra los elementos que coinciden con ambas consultas. |
or |
Muestra los elementos que coinciden con cualquiera de las consultas. |
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 descripciones y tipos de datos, consulta la referencia de recursos de files
.
Término de búsqueda | Operadores válidos | Uso |
---|---|---|
name |
contains , = , != |
Nombre del archivo. Rodea con comillas simples (' ). Escapa las comillas simples en las consultas con \' , como 'Valentine\'s Day' . |
fullText |
contains |
Si las propiedades name , description , indexableText o el texto del contenido o los metadatos del archivo coinciden. Rodea con comillas simples (' ). Escapa las comillas simples en las consultas con \' , como 'Valentine\'s Day' . |
mimeType |
contains , = , != |
Es el tipo 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 MIME, consulta Tipos de MIME compatibles con Google Workspace y Google Drive. |
modifiedTime |
<= , < , = , != , > , >= |
Es la 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 |
<= , < , = , != , > , >= |
Es la 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 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 |
Indica si la colección superior 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 de recursos de permissions . |
readers |
in |
Usuarios o grupos que tienen permiso para leer el archivo Consulta la referencia de recursos de permissions . |
sharedWithMe |
= , != |
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 |
<= , < , = , != , > , >= |
Es la 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 . Enciérralo entre comillas simples (' ). |
shortcutDetails.targetId |
= , != |
El ID del elemento al que apunta el acceso directo. |
A continuación, se muestran 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 cadena completos para el términofullText
. Por ejemplo, si el texto completo de un documento contiene la cadena "HelloWorld", solo la consultafullText contains 'HelloWorld'
muestra un resultado.El operador
contains
coincide con una frase alfanumérica exacta si está entre comillas dobles. Por ejemplo, si elfullText
de un documento contiene la cadena "Hola mundo", 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 cadena "Hello_world", la consultafullText contains '"Hello world"'
muestra un resultado.Los términos
owners
,writers
yreaders
se reflejan indirectamente en la listapermissions
y hacen referencia arole
en el permiso. Para obtener una lista completa de los permisos de roles, consulta Roles y permisos.
Para obtener más ejemplos de búsquedas de cadenas de consulta, consulta 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 de la unidad compartida. Para ver 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 |
<= , < , = , != , > , >= |
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 , = , != |
Es el nombre de la unidad compartida. Rodea con comillas simples (' ). Escapa 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 |
= , != |
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 de cadenas de consulta, consulta los ejemplos de cadenas de consulta de Drive compartido.
Temas relacionados
- Cómo buscar archivos y carpetas
- Cómo buscar unidades compartidas
- Tipos de MIME compatibles con Google Workspace y Google Drive
- Funciones y permisos