Cercare Drive condivisi

Questa guida spiega in che modo l'API Google Drive supporta diversi modi per cercare i Drive condivisi.

Per cercare un insieme specifico di Drive condivisi, utilizza il campo della stringa di query q field con il list metodo sulla risorsa drives per filtrare i Drive da restituire combinando uno o più termini di ricerca.

Una stringa di query contiene le seguenti tre parti:

query_term operator values

Dove:

  • query_term è il termine o il campo della query su cui eseguire la ricerca.

  • operator specifica la condizione per il termine della query.

  • values sono i valori specifici che vuoi utilizzare per filtrare i risultati di ricerca.

Ad esempio, la seguente stringa di query filtra la ricerca in modo da restituire solo i Drive condivisi con il nome "Risorse dell'API Google Drive".

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

Per visualizzare tutti i termini di query dei Drive condivisi, consulta Termini di query specifici per i Drive condivisi.

Per visualizzare tutti gli operatori di query che puoi utilizzare per creare una query, consulta Operatori di query.

Esempi di stringhe di query

La seguente tabella elenca esempi di alcune stringhe di query di base per i Drive condivisi. Il codice effettivo varia a seconda della libreria client che utilizzi per la ricerca.

Devi anche eseguire l'escape dei caratteri speciali nei nomi dei file per assicurarti che la query funzioni correttamente. Ad esempio, se un nome file contiene sia un apostrofo (') sia una barra rovesciata ("\"), utilizza una barra rovesciata per eseguirne l'escape: name contains 'quinn\'s paper\\essay'.

Su cosa eseguire la query Esempio Impostazione useDomainAdminAccess
Operatore di corrispondenza di stringhe (contains)
Drive condivisi con la parola "confidential" nel titolo tra tutti i Drive condivisi di cui l'utente è membro name contains 'confidential' false
Operatori di uguaglianza e disuguaglianza (=, !=)
Drive condivisi visibili nella visualizzazione predefinita hidden = false false
Drive condivisi nascosti dalla visualizzazione predefinita hidden = true false
Drive condivisi senza organizzatore assegnato organizerCount = 0 true
Drive condivisi con esattamente un membro memberCount = 1 true
Drive condivisi che appartengono all'ID unità organizzativa orgUnitId = 'C03az79cb' true
Drive condivisi che non contengono l'ID unità organizzativa orgUnitId != 'C03az79cb' true
Drive condivisi con nomi che non corrispondono a un nome specifico name != 'Archived Projects' true
Operatori di confronto (>, >=, <, <=)
Drive condivisi creati dopo il 1° giugno 2017 createdTime > '2017-06-01T12:00:00' true
Drive condivisi creati prima del 1° gennaio 2023 createdTime < '2023-01-01T00:00:00' true
Drive condivisi con più di un membro memberCount > 1 true
Drive condivisi con meno di 5 membri memberCount < 5 true
Drive condivisi con al massimo 3 organizzatori organizerCount <= 3 true
Operatori logici (and, or, not)
Drive condivisi con la parola "confidential" nel titolo e almeno 20 membri name contains 'confidential' and memberCount >= 20 true
Drive condivisi con la parola "confidential" nel titolo tra tutti i Drive condivisi dell'organizzazione name contains 'confidential' and orgUnitId = 'C03az79cb' true
Drive condivisi con nomi che contengono "Project" o "Archive" name contains 'Project' or name contains 'Archive' true
Drive condivisi che non contengono "Draft" nel nome not name contains 'Draft' true
Drive condivisi non appartenenti a un'unità organizzativa di destinazione e creati dopo una data specifica orgUnitId != 'C03az79cb' and createdTime > '2023-01-01T00:00:00' true

Eseguire query su più termini con le parentesi

Puoi utilizzare le parentesi per raggruppare più termini di query. Ad esempio, per cercare i Drive condivisi creati dopo una data specifica e che hanno più di cinque organizzatori o più di 20 membri, utilizza questa query:

createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or memberCount > 20)

Questa ricerca restituisce tutti i Drive condivisi creati dopo il 1° gennaio 2019 e che hanno più di cinque organizzatori o più di 20 membri.

L'API Drive valuta gli operatori and e or da sinistra a destra, quindi la stessa ricerca senza parentesi restituirebbe:

  • Solo i Drive condivisi con più di cinque organizzatori creati dopo il 1° gennaio 2019.
  • Tutti i Drive condivisi con più di 20 membri, anche quelli creati prima del 1° gennaio 2019.