Para buscar un conjunto específico de unidades compartidas, usa el campo de cadena de consulta q
con drives.list
para filtrar los viajes
obtener resultados combinando uno o más términos de búsqueda.
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.
Para ver los términos de búsqueda y los operadores que puedes usar para filtrar unidades compartidas, haz lo siguiente: consulta Términos y operadores de búsqueda.
Por ejemplo, la siguiente cadena de consulta filtra la búsqueda para que solo devuelva resultados compartidos con el nombre “Recursos de la API de Google Drive”.
q: name = 'Google Drive API resources' & useDomainAdminAccess=false
Ejemplos de cadenas de consulta
En la siguiente tabla, se muestran ejemplos de algunas cadenas de consulta básicas para uso compartido unidades. El código real difiere según la biblioteca cliente que uses para tu búsqueda.
También debes escapar los caracteres especiales en los nombres de tus archivos para asegurarte de que el
la consulta funciona correctamente. Por ejemplo, si el nombre de un archivo contiene un apóstrofo
('
) y un carácter de barra inversa ("\"
), usa una barra inversa para escapar de ellos: name
contains 'quinn\'s paper\\essay'
.
Qué quieres consultar | Ejemplo | Configuración useDomainAdminAccess |
---|---|---|
Unidades compartidas creadas después del 1 de junio de 2017 | createdTime > '2017-06-01T12:00:00' |
true |
Unidades compartidas visibles en la vista predeterminada | hidden = false |
false |
Unidades compartidas con más de un miembro | memberCount > 1 |
true |
Unidades compartidas con la palabra “confidencial” en el título y 20 o más miembros | name contains 'confidential' and memberCount >= 20 |
true |
Unidades compartidas con la palabra “confidencial” en el título entre todas las unidades compartidas de la organización | name contains 'confidential' and orgUnitId = 'C03az79cb' |
true |
Unidades compartidas con la palabra “confidencial” en el título entre todas las unidades compartidas de las que es miembro el usuario | name contains 'confidential' |
false |
Unidades compartidas sin un organizador asignado | organizerCount = 0 |
true |
Unidades compartidas que no contienen el ID de la unidad organizativa | orgUnitId != 'C03az79cb' |
true |
Consulta varios términos con paréntesis
Puedes usar paréntesis para agrupar varios términos de consulta. Por ejemplo, para buscar unidades compartidas creadas después de una fecha específica que tengan más de cinco organizadores o más de 20 miembros, usa esta consulta:
createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or
memberCount > 20)
Esta búsqueda muestra todas las unidades compartidas que se crearon después del 1 de enero de 2019 y que tener más de cinco organizadores o más de 20 miembros.
La API de Drive evalúa los operadores and
y or
de izquierda a derecha,
por lo que la misma búsqueda sin paréntesis devolvería lo siguiente:
- Solo las unidades compartidas con más de cinco organizadores que se hayan creado después de 1 de enero de 2019.
- Todas las unidades compartidas con más de 20 miembros, incluso las creadas antes 1 de enero de 2019.