Cercare Drive condivisi

Questa guida spiega come 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 con il metodo list nella 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 di ricerca.

  • 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 API Google Drive".

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

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

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

Esempi di stringhe di query

La tabella seguente 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 utilizzare il codice di escape per i 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 eseguire l'escape: name contains 'quinn\'s paper\\essay'.

Cosa interrogare Esempio useDomainAdminAccess impostazione
Operatore di corrispondenza delle stringhe (contains)
Drive condivisi con la parola "confidenziale" 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 un solo 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 un massimo di tre organizzatori organizerCount <= 3 true
Operatori logici (and, or, not)
Drive condivisi con la parola "confidenziale" nel titolo e 20 o più membri name contains 'confidential' and memberCount >= 20 true
Drive condivisi con la parola "riservato" nel titolo tra tutti i Drive condivisi dell'organizzazione name contains 'confidential' and orgUnitId = 'C03az79cb' true
Drive condivisi con nomi contenenti "Project" o "Archive" name contains 'Project' or name contains 'Archive' true
Drive condivisi che non contengono "Bozza" nel nome not name contains 'Draft' true
Drive condivisi che non appartengono 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 ricerca. 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.