Per cercare un insieme specifico di Drive condivisi, utilizza il campo della stringa di query q
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 di query su cui eseguire la ricerca.operator
specifica la condizione del termine di query.values
sono 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 di Google Drive".
q: name = 'Google Drive API resources' & useDomainAdminAccess=false
Esempi di stringhe di query
La tabella seguente elenca alcuni esempi di stringhe di query di base per i drive condivisi. Il codice effettivo varia a seconda della libreria client utilizzata per la ricerca.
Devi inoltre 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 un carattere barra rovesciata ("\"
), utilizza una barra rovesciata per eseguire l'escape: name
contains 'quinn\'s paper\\essay'
.
Che cosa vuoi eseguire una query | 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 "Riservato" nel titolo e con almeno 20 membri | name contains 'confidential' and memberCount >= 20 |
true |
I Drive condivisi con la parola "Riservato" nel titolo tra tutti i Drive condivisi dell'organizzazione | name contains 'confidential' and orgUnitId = 'C03az79cb' |
true |
I Drive condivisi con la parola "Riservato" 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 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 restituirà:
- 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.