Termini e operatori delle query di ricerca

Questa guida di riferimento fornisce termini di query e operatori che puoi utilizzare con l'API Google Drive per filtrare i risultati in base a file, cartelle e unità condivise.

Per esempi di ricerca di file, vedi Cercare file e cartelle.

Ad esempio, per le ricerche di Drive condivisi, vedi Cercare i 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 su cui eseguire la ricerca.

  • operator specifica la condizione per il termine di query.

  • values sono i valori specifici da utilizzare per filtrare i risultati di ricerca.

Operatori di query

La tabella seguente elenca gli operatori di query validi:

Operatore Utilizzo
contains I contenuti di una stringa sono presenti nell'altra.
= I contenuti di una stringa o di un valore booleano sono uguali all'altro.
!= Il contenuto di una stringa o di un valore booleano non è uguale all'altro.
< Un valore è inferiore a 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 in una raccolta.
and Restituisce gli elementi che corrispondono a entrambe le query.
or Restituisce gli elementi corrispondenti 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 file

La tabella seguente elenca tutti i termini di query dei file validi. Per i tipi di dati e le descrizioni, consulta la documentazione di riferimento della risorsa files.

Termine di query Operatori validi Utilizzo
name contains, =, != Nome del file. Racchiudi tra virgolette singole ('). Inserisci un carattere di escape per le virgolette singole nelle query con \', ad esempio '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 ('). Inserisci un carattere di escape per le virgolette singole nelle query con \', ad esempio 'Valentine\'s Day'.
mimeType contains, =, != Tipo MIME del file. Racchiudi tra virgolette singole ('). Inserisci un carattere di escape per le virgolette singole nelle query con \', ad esempio 'Valentine\'s Day'. Per ulteriori informazioni sui tipi MIME, vedi 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 con 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 con date costanti.
trashed =, != Indica 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 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 alla risorsa permissions.
readers in Utenti o gruppi che dispongono dell'autorizzazione a leggere il file. Consulta il riferimento alla risorsa permissions.
sharedWithMe =, != File che si trovano nella raccolta "Condivisi con me" dell'utente. Tutti gli utenti del file sono presenti nell'elenco di controllo dell'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à di file personalizzate pubbliche.
appProperties has Proprietà di file personalizzate private.
visibility =, != Il livello di visibilità del file. I valori validi sono anyoneCanFind, anyoneWithLink, domainCanFind, domainWithLink e limited. Racchiudi tra virgolette semplici (').
shortcutDetails.targetId =, != L'ID dell'elemento a cui punta la scorciatoia.

Di seguito sono riportate le combinazioni di operatori e termini di query:

  • L'operatore contains esegue la corrispondenza del prefisso solo per un termine name. Ad esempio, supponiamo che il nome sia HelloWorld. Una query su name contains 'Hello' restituisce un risultato, ma una query su name contains 'World' no.

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

  • L'operatore contains corrisponde a una frase alfanumerica esatta se è delimitata da virgolette doppie. Ad esempio, se il fullText di un documento contiene la stringa "Un saluto da Google", la query fullText contains '"Hello there"' restituisce un risultato, ma la query fullText contains '"Hello world"' no. 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 e readers sono indirettamente riportati nell'elenco permissions e fanno riferimento al valore role dell'autorizzazione. Per un elenco completo delle autorizzazioni dei ruoli, consulta Ruoli e autorizzazioni.

Per altri esempi di ricerche con stringhe di query, consulta gli esempi di stringhe di query dei file.

Termini di query specifici del Drive condiviso

La tabella seguente elenca tutti i termini di query validi per i viaggi condivisi. Per i tipi di dati e le descrizioni, consulta la documentazione di riferimento della risorsa 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. Deve essere specificato un valore numerico. true
name contains, =, != Nome del Drive condiviso. Racchiudi tra virgolette singole ('). Inserisci un carattere di escape per le virgolette singole nelle query con \', ad esempio 'Valentine\'s Day'. true
organizerCount <=, <, =, !=, > e >= Numero di utenti e gruppi che sono organizzatori del Drive condiviso. Deve essere specificato un valore numerico. true
orgUnitId =, != L'ID unità organizzativa di un Drive condiviso. Accetta un valore di stringa. true

Per altri esempi di ricerche con stringhe di query, consulta gli esempi di stringhe di query per i Drive condivisi.