Termini e operatori delle query di ricerca

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 termine name. Ad esempio, supponiamo che tu abbia nome di HelloWorld. Una query name contains 'Hello' restituisce un risultato, al contrario di una query name contains 'World'.

  • L'operatore contains esegue la corrispondenza solo su token di intere stringhe per il termine fullText. Ad esempio, se il testo completo di un documento contiene la stringa "HelloWorld", solo la query fullText contains 'HelloWorld' restituirà un risultato.

  • L'operatore contains corrisponde a una frase alfanumerica esatta se è racchiusa tra virgolette doppie. Ad esempio, se fullText di un documento contiene la stringa "Hello World", la query fullText contains '"Hello there"' restituisce un risultato, al contrario della query fullText contains '"Hello world"'. Inoltre, poiché la ricerca è alfanumerica, se il testo completo di un documento contiene la stringa "Hello_world", la query fullText contains '"Hello world"' restituisce un risultato.

  • I termini owners, writers e readers sono riportati indirettamente nell'elenco permissions e fanno riferimento alla role 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.