Questa guida di riferimento fornisce termini e operatori di query che puoi utilizzare con API Google Drive per filtrare file, cartelle e Drive condivisi.
Per esempi di ricerca di file, vedi Cercare file e cartelle.
Ad esempio, vedi Cercare Drive condivisi.
Sintassi della stringa di query
Una stringa di query contiene le seguenti tre parti:
query_term operator values
Dove:
query_term
è il termine o il campo da cercare.operator
specifica la condizione del termine di query.values
sono i valori specifici che vuoi utilizzare per filtrare la ricerca che consentono di analizzare i dati e visualizzare i risultati.
Operatori di query
Nella tabella seguente sono elencati gli operatori di query validi:
Operatore | Utilizzo |
---|---|
contains |
Il contenuto di una stringa è presente nell'altra. |
= |
Il contenuto di una stringa o un valore booleano è uguale all'altro. |
!= |
Il contenuto di una stringa o un valore booleano non è uguale all'altro. |
< |
Un valore è minore di un altro. |
<= |
Un valore è minore o uguale a un altro. |
> |
Un valore è maggiore di un altro. |
>= |
Un valore è maggiore o uguale a un altro. |
in |
Un elemento è contenuto all'interno di una raccolta. |
and |
Restituisci gli elementi che corrispondono a entrambe le query. |
or |
Restituisci gli elementi che corrispondono a una delle due query. |
not |
Nega una query di ricerca. |
has |
Una raccolta contiene un elemento che corrisponde ai parametri. |
Termini di query specifici del file
La tabella seguente elenca tutti i termini di query validi per i file. Per i tipi di dati e
descrizioni, consulta la files
risorsa
riferimento.
Termine di query | Operatori validi | Utilizzo |
---|---|---|
name |
contains , = e != |
Nome del file. Racchiudi tra virgolette singole (' ). Utilizza l'escape delle virgolette singole nelle query con \' , come 'Valentine\'s Day' . |
fullText |
contains |
Se le proprietà name , description , indexableText o il testo nei contenuti o nei metadati del file corrispondono. Racchiudi tra virgolette singole (' ). Utilizza l'escape delle virgolette singole nelle query con \' , come 'Valentine\'s Day' . |
mimeType |
contains , = e != |
Tipo MIME del file. Racchiudi tra virgolette singole (' ). Utilizza l'escape delle virgolette singole nelle query con \' , come 'Valentine\'s Day' . Per saperne di più sui tipi MIME, consulta l'articolo Tipi MIME supportati da Google Workspace e Google Drive. |
modifiedTime |
<= , < , = , != , > e >= |
Data dell'ultima modifica del file. Formato RFC 3339; il fuso orario predefinito è UTC, ad esempio 2012-06-04T12:00:00-08:00 . I campi di tipo date non sono confrontabili tra loro, ma solo alle date costanti. |
viewedByMeTime |
<= , < , = , != , > e >= |
Data dell'ultima visualizzazione di un file da parte dell'utente. Formato RFC 3339; il fuso orario predefinito è UTC, ad esempio 2012-06-04T12:00:00-08:00 . I campi di tipo date non sono confrontabili tra loro, ma solo alle date costanti. |
trashed |
= , != |
Se il file si trova nel cestino o meno. Può essere true o false . |
starred |
= , != |
Indica se il file è stato aggiunto a Speciali o meno. Può essere true o false . |
parents |
in |
Se la raccolta principale contiene l'ID specificato. |
owners |
in |
Utenti proprietari del file. |
writers |
in |
Utenti o gruppi con autorizzazione a modificare il file. Consulta il riferimento della risorsa permissions . |
readers |
in |
Utenti o gruppi con autorizzazione di lettura del file. Consulta il riferimento della risorsa permissions . |
sharedWithMe |
= , != |
I file che si trovano in "Condivisi con me" raccolta. Tutti gli utenti del file sono inclusi nell'elenco di controllo di accesso (ACL) del file. Può essere true o false . |
createdTime |
<= , < , = , != , > e >= |
Data di creazione del Drive condiviso. Utilizza il formato RFC 3339; il fuso orario predefinito è UTC, ad esempio 2012-06-04T12:00:00-08:00 . |
properties |
has |
Proprietà del file personalizzato pubblico. |
appProperties |
has |
Proprietà file personalizzate private. |
visibility |
= , != |
Il livello di visibilità del file. I valori validi sono anyoneCanFind , anyoneWithLink , domainCanFind , domainWithLink e limited . Racchiudi tra virgolette singole (' ). |
shortcutDetails.targetId |
= , != |
L'ID dell'elemento a cui rimanda la scorciatoia. |
Di seguito sono illustrate le combinazioni di operatore e termine di query:
L'operatore
contains
esegue la corrispondenza del prefisso solo per unaname
termine. Ad esempio, supponiamo che tu abbia un nome diHelloWorld
. Una queryname contains 'Hello'
restituisce un ma non una query diname contains 'World'
.L'operatore
contains
esegue la corrispondenza solo su interi token di stringa per il terminefullText
. Ad esempio, se il testo completo di un documento contiene la stringa "HelloWorld", solo la queryfullText contains 'HelloWorld'
restituisce un risultato.L'operatore
contains
trova corrispondenze con una frase alfanumerica esatta se si tratta di è racchiusa tra virgolette. Ad esempio, se il valorefullText
di un documento contiene la stringa "Hello there world", la queryfullText contains '"Hello there"'
restituisce un risultato, a differenza della queryfullText contains '"Hello world"'
. Inoltre, poiché la ricerca è alfanumerica, se l'intero di testo di un documento contiene la stringa "Hello_world", quindi la queryfullText contains '"Hello world"'
restituisce un risultato.I termini
owners
,writers
ereaders
sono riportati indirettamente nelpermissions
e consulta l'elencorole
sull'autorizzazione. Per un elenco completo delle autorizzazioni dei ruoli, vedi Ruoli e autorizzazioni.
Per altri esempi di ricerche di stringhe di query, consulta Stringa di query file esempi.
Termini di query specifici per i Drive condivisi
La tabella seguente elenca tutti i termini di query validi sui Drive condivisi. Per i tipi di dati e
descrizioni, consulta la risorsa drives
riferimento.
Termine di query | Operatori validi | Utilizzo | useDomainAdminAccess impostazione |
---|---|---|---|
createdTime |
<= , < , = , != , > e >= |
Data di creazione del Drive condiviso. Formato RFC 3339; il fuso orario predefinito è UTC, ad esempio 2012-06-04T12:00:00-08:00 . |
true |
hidden |
= , != |
Specifica se il Drive condiviso è nascosto. Può essere true o false . |
false |
memberCount |
<= , < , = , != , > e >= |
Numero di utenti e gruppi membri del Drive condiviso. Prende un valore numerico. | true |
name |
contains , = e != |
Nome del Drive condiviso. Racchiudi tra virgolette singole (' ). Utilizza l'escape delle virgolette singole nelle query con \' , come 'Valentine\'s Day' . |
true |
organizerCount |
<= , < , = , != , > e >= |
Numero di utenti e gruppi che sono organizzatori del Drive condiviso. Prende un valore numerico. | true |
orgUnitId |
= , != |
L'ID unità organizzativa di un Drive condiviso. Prende un valore stringa. | true |
Per altri esempi di ricerche tramite stringa di query, vedi stringa di query su Drive condiviso esempi.
Argomenti correlati
- Cercare file e cartelle
- Cercare Drive condivisi
- Tipi MIME supportati da Google Workspace e Google Drive
- Ruoli e autorizzazioni