Per cercare un insieme specifico di unità condivise, utilizza il campo della stringa di query q
con drives.list
per filtrare le unità 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 per il 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 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 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.