Para buscar un conjunto específico de unidades compartidas, usa el campo q de la cadena de consulta con drives.list para filtrar las unidades que se mostrarán 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_termes el término de búsqueda o el campo en el que se realizará la búsqueda.operatorespecifica la condición para el término de la búsqueda.valuesson los valores específicos que deseas usar para filtrar los resultados de la búsqueda.
Para ver los términos y operadores de búsqueda que puedes usar para filtrar las unidades compartidas, consulta Términos y operadores de búsqueda.
Por ejemplo, la siguiente cadena de consulta filtra la búsqueda para que solo muestre unidades compartidas 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 incluyen ejemplos de algunas cadenas de consulta básicas para unidades compartidas. El código real difiere según la biblioteca cliente que uses para la búsqueda.
También debes escapar los caracteres especiales en los nombres de los archivos para asegurarte de que la
consulta funcione correctamente. Por ejemplo, si un nombre de archivo contiene un carácter de apóstrofo (') y una barra inversa ("\"), usa una barra inversa para escaparlos: 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 organizador asignado | organizerCount = 0 |
true |
| Unidades compartidas que no contienen el ID de la unidad organizativa | orgUnitId != 'C03az79cb' |
true |
Cómo consultar varios términos con paréntesis
Puedes usar paréntesis para agrupar varios términos de búsqueda. 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 creadas después del 1 de enero de 2019 y que tengan 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 mostrará lo siguiente:
- Solo unidades compartidas con más de cinco organizadores que se crearon después del 1 de enero de 2019
- Todas las unidades compartidas con más de 20 miembros, incluso las creadas antes del 1 de enero de 2019.