Questa guida di riferimento fornisce termini e operatori di query che puoi utilizzare con l'API Google Drive per filtrare in base a file, cartelle e Drive condivisi.
Per esempi di ricerca di file, vedi Cercare file e cartelle.
Ad esempio, per ricerche di Drive condivisi, 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 di query in 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.
Operatori di query
Nella tabella seguente sono elencati gli operatori di query validi:
Operatore | Utilizzo |
---|---|
contains |
I contenuti di una stringa sono presenti nell'altra. |
= |
Il contenuto di una stringa o di un valore booleano è uguale all'altro. |
!= |
Il contenuto di una stringa o di un valore booleano è diverso dall'altro. |
< |
Un valore è minore di un altro. |
<= |
Un valore è inferiore 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 corrispondente ai parametri. |
Termini di query specifici per i file
Nella tabella seguente sono elencati tutti i termini di query relativi ai file validi. Per i tipi di dati e le descrizioni, consulta il riferimento delle risorse di files
.
Termine di query | Operatori validi | Utilizzo |
---|---|---|
name |
contains , = e != |
Nome del file. Racchiudi le virgolette singole (' ). Inserisci l'escape delle virgolette singole nelle query con \' , ad esempio 'Valentine\'s Day' . |
fullText |
contains |
Indica se le proprietà name , description , indexableText o il testo nei contenuti del file o nei metadati del file corrispondono. Racchiudi le virgolette singole (' ). Inserisci l'escape delle virgolette singole nelle query con \' , ad esempio 'Valentine\'s Day' . |
mimeType |
contains , = e != |
Tipo MIME del file. Racchiudi le virgolette singole (' ). Inserisci l'escape delle virgolette singole nelle query con \' , ad esempio 'Valentine\'s Day' . Per saperne di più sui tipi MIME, vedi Tipi MIME supportati per 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 paragonabili tra loro, ma solo con date costanti. |
viewedByMeTime |
<= , < , = , != , > e >= |
Data dell'ultima visualizzazione del 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 paragonabili tra loro, ma solo con date costanti. |
trashed |
= , != |
Se il file è 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 |
Indica se la raccolta padre contiene l'ID specificato. |
owners |
in |
Utenti che sono proprietari del file. |
writers |
in |
Utenti o gruppi autorizzati a modificare il file. Consulta il riferimento delle risorse di permissions . |
readers |
in |
Utenti o gruppi che dispongono dell'autorizzazione per leggere il file. Consulta il riferimento delle risorse di permissions . |
sharedWithMe |
= , != |
I file che si trovano nella raccolta "Condivisi con me" dell'utente. Tutti gli utenti del file si trovano 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à dei file personalizzati pubblici. |
appProperties |
has |
Proprietà dei file personalizzati privati. |
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 punta la scorciatoia. |
Di seguito sono riportate le combinazioni di operatore e termine di query:
L'operatore
contains
esegue la corrispondenza del prefisso solo per un terminename
. Ad esempio, supponiamo che tu abbia nome diHelloWorld
. Una queryname contains 'Hello'
restituisce un risultato, al contrario di una queryname contains 'World'
.L'operatore
contains
esegue la corrispondenza solo su token di intere stringhe per il terminefullText
. Ad esempio, se il testo completo di un documento contiene la stringa "HelloWorld", solo la queryfullText contains 'HelloWorld'
restituirà un risultato.L'operatore
contains
corrisponde a una frase alfanumerica esatta se è racchiusa tra virgolette doppie. Ad esempio, sefullText
di un documento contiene la stringa "Hello World", la queryfullText contains '"Hello there"'
restituisce un risultato, al contrario della queryfullText contains '"Hello world"'
. Inoltre, poiché la ricerca è alfanumerica, se il testo completo di un documento contiene la stringa "Hello_world", la queryfullText contains '"Hello world"'
restituisce un risultato.I termini
owners
,writers
ereaders
sono riportati indirettamente nell'elencopermissions
e fanno riferimento allarole
sull'autorizzazione. Per un elenco completo delle autorizzazioni dei ruoli, vedi Ruoli e autorizzazioni.
Per altri esempi di ricerche di stringhe di query, consulta gli esempi di stringhe di query di file.
Termini di query specifici dei Drive condivisi
La seguente tabella elenca tutti i termini di query validi per i Drive condivisi. Per le descrizioni e i tipi di dati, consulta il riferimento delle risorse di drives
.
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 che sono membri del Drive condiviso. Calcola un valore numerico. | true |
name |
contains , = e != |
Nome del Drive condiviso. Racchiudi le virgolette singole (' ). Inserisci l'escape delle virgolette singole nelle query con \' , ad esempio 'Valentine\'s Day' . |
true |
organizerCount |
<= , < , = , != , > e >= |
Numero di utenti e gruppi che sono organizzatori del Drive condiviso. Calcola un valore numerico. | true |
orgUnitId |
= , != |
L'ID unità organizzativa di un Drive condiviso. Recupera un valore stringa. | true |
Per altri esempi di ricerche di stringhe di query, consulta gli esempi di stringhe di query dei Drive condivisi.
Argomenti correlati
- Cercare file e cartelle
- Cercare Drive condivisi
- Tipi MIME supportati per Google Workspace e Google Drive
- Ruoli e autorizzazioni