Cómo buscar unidades compartidas

En esta guía, se explica cómo la API de Google Drive admite varias formas de buscar unidades compartidas.

Para buscar un conjunto específico de unidades compartidas, usa el campo de cadena de consulta q con el método list en el recurso drives 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

Donde:

  • query_term es el término o campo de consulta en el que se realizará la búsqueda.

  • operator especifica la condición del término de consulta.

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

Por ejemplo, la siguiente cadena de consulta filtra la búsqueda para mostrar solo las unidades compartidas con el nombre "Recursos de la API de Google Drive".

q: name = 'Google Drive API resources' & useDomainAdminAccess=false

Para ver todos los términos de consulta de unidades compartidas, consulta Términos de consulta específicos de unidades compartidas.

Para ver todos los operadores de consulta que puedes usar para crear una consulta, consulta Operadores deconsulta.

Ejemplos de cadenas de consulta

En la siguiente tabla, se muestran 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 apóstrofe (') y una barra inversa ("\"), usa una barra inversa para escaparlos: name contains 'quinn\'s paper\\essay'.

Qué consultar Ejemplo Configuración de useDomainAdminAccess
Operador de coincidencia de cadenas (contains)
Unidades compartidas con la palabra "confidential" en el título entre todas las unidades compartidas de las que el usuario es miembro name contains 'confidential' false
Operadores de igualdad y desigualdad (=, !=)
Unidades compartidas visibles en la vista predeterminada hidden = false false
Unidades compartidas ocultas en la vista predeterminada hidden = true false
Unidades compartidas sin organizador asignado organizerCount = 0 true
Unidades compartidas con exactamente un miembro memberCount = 1 true
Unidades compartidas que pertenecen al ID de la unidad organizativa orgUnitId = 'C03az79cb' true
Unidades compartidas que no contienen el ID de la unidad organizativa orgUnitId != 'C03az79cb' true
Unidades compartidas con nombres que no coinciden con un nombre específico name != 'Archived Projects' true
Operadores de comparación (>, >=, <, <=)
Unidades compartidas creadas después del 1 de junio de 2017 createdTime > '2017-06-01T12:00:00' true
Unidades compartidas creadas antes del 1 de enero de 2023 createdTime < '2023-01-01T00:00:00' true
Unidades compartidas con más de un miembro memberCount > 1 true
Unidades compartidas con menos de 5 miembros memberCount < 5 true
Unidades compartidas con 3 o menos organizadores organizerCount <= 3 true
Operadores lógicos (and, or, not)
Unidades compartidas con la palabra "confidential" en el título y 20 o más miembros name contains 'confidential' and memberCount >= 20 true
Unidades compartidas con la palabra "confidential" en el título entre todas las unidades compartidas de la organización name contains 'confidential' and orgUnitId = 'C03az79cb' true
Unidades compartidas con nombres que contienen "Project" o "Archive" name contains 'Project' or name contains 'Archive' true
Unidades compartidas que no contienen "Draft" en su nombre not name contains 'Draft' true
Unidades compartidas que no pertenecen a una unidad organizativa de destino y que se crearon después de una fecha específica orgUnitId != 'C03az79cb' and createdTime > '2023-01-01T00:00:00' 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 y 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 tienen 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ía lo siguiente:

  • Solo las 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.