Per cercare un insieme specifico di Drive condivisi, utilizza il campo q stringa di query
con drives.list 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.operatorspecifica la condizione per il termine di query.valuessono i valori specifici che vuoi utilizzare per filtrare i risultati di ricerca.
Per visualizzare i termini e gli operatori di query che puoi utilizzare per filtrare i Drive condivisi, consulta Termini e operatori di query 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
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 tua 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 vuoi interrogare | Esempio | useDomainAdminAccess impostazione |
|---|---|---|
| Drive condivisi creati dopo il 1° giugno 2017 | createdTime > '2017-06-01T12:00:00' |
true |
| Drive condivisi visibili nella visualizzazione predefinita | hidden = false |
false |
| Drive condivisi con più di un membro | memberCount > 1 |
true |
| 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 "confidenziale" nel titolo tra tutti i Drive condivisi dell'organizzazione | name contains 'confidential' and orgUnitId = 'C03az79cb' |
true |
| Drive condivisi con la parola "confidenziale" nel titolo tra tutti i Drive condivisi di cui l'utente è membro | name contains 'confidential' |
false |
| Drive condivisi senza organizzatore assegnato | organizerCount = 0 |
true |
| Drive condivisi che non contengono l'ID unità organizzativa | orgUnitId != 'C03az79cb' |
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.