Termini e operatori delle query di ricerca

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

  • L'operatore contains esegue la corrispondenza solo su interi token di stringa 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 trova corrispondenze con una frase alfanumerica esatta se si tratta di è racchiusa tra virgolette. Ad esempio, se il valore fullText di un documento contiene la stringa "Hello there world", la query fullText contains '"Hello there"' restituisce un risultato, a differenza della query fullText contains '"Hello world"'. Inoltre, poiché la ricerca è alfanumerica, se l'intero di testo di un documento contiene la stringa "Hello_world", quindi la query fullText contains '"Hello world"' restituisce un risultato.

  • I termini owners, writers e readers sono riportati indirettamente nel permissions e consulta l'elenco 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 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.