Cercare file con un'etichetta o un valore di campo specifici

Questa pagina descrive come cercare file a cui è stata applicata un'etichetta o un valore di campo specifico.

Tipi di campi etichetta

I campi delle etichette di Google Drive sono fortemente tipizzati e ogni tipo supporta semantiche di indicizzazione e ricerca diverse. La tabella seguente mostra i tipi di dati disponibili.

Tipo Opzioni per il tipo di etichetta Operatori di ricerca supportati
Testo TextOptions is null, is not null, =, contains, starts with
Testo lungo LongTextOptions is null, is not null, contains
Numero intero IntegerOptions is null, is not null, =, !=, <, >, <=, >=
Data DateOptions is null, is not null, =, !=, <, >, <=, >=
Selezione SelectionOptions is null, is not null, =, !=
Utente UserOptions is null, is not null, =, !=
Elenco selezioni SelectionOptions (con max_entries > 1) is null, is not null, in, not in
Elenco utenti UserOptions (con max_entries > 1) is null, is not null, in, not in

1. Ricerca in base alla presenza di un'etichetta o di un campo

Puoi cercare gli elementi a cui è stata (o non è stata) applicata un'etichetta specifica:

  • 'labels/contract' in labels
  • not 'labels/contract' in labels

Puoi anche cercare elementi in cui un campo specifico è stato (o non è stato) impostato:

  • labels/contract.comment IS NOT NULL
  • labels/contract.comment IS NULL

2. Eseguire ricerche in base a campi con un solo valore

Puoi scrivere query di ricerca in modo che corrispondano ai valori di campo previsti. La tabella seguente mostra le query sui campi valide:

Cosa vuoi interrogare Stringa di query
Elementi in cui il commento è impostato su "hello" labels/contract.comment = 'hello'
File in cui il commento inizia con "hello" labels/contract.comment STARTS WITH 'hello'
File in cui lo stato è eseguito labels/contract.status = 'executed'
File con stato diverso da Eseguito labels/contract.status != 'executed'
File in cui execution_date è precedente a una data specifica labels/contract.execution_date < '2020-06-22'
File in cui value_usd (numero intero) è inferiore a un valore specifico labels/contract.value_usd < 2000
File in cui client_contact è impostato su un indirizzo email specifico labels/contract.client_contact = 'alex@altostrat.com'

3. Cerca in base ai campi con campi multivalore (ad esempio ListOptions.max_entries > 1)

I campi che supportano più valori possono essere interrogati solo utilizzando l'operatore IN:

  • 'EMAIL_ADDRESS' IN labels/project.project_leads
  • NOT 'EMAIL_ADDRESS' IN labels/project.project_leads

Esempio

Il seguente esempio di codice mostra come utilizzare uno o più labelId per elencare tutti i file con un'etichetta o un valore di campo specifico da una risorsa file di Drive. Utilizza anche il metodo files.list. Il corpo della richiesta deve essere vuoto.

Se vuoi includere labelInfo nella risposta, devi anche specificare:

  • includeLabels come elenco di ID separati da virgole.

  • labelInfo nel parametro fields per indicare che vuoi che labelInfo venga restituito entro includeLabels.

In caso di esito positivo, il corpo della risposta contiene l'elenco dei file.

Java

List<File> fileList = driveService.files().list().setIncludeLabels("LABEL_1_ID,LABEL_2_ID").setFields("items(labelInfo, id)").setQ("'labels/LABEL_1_ID' in labels and 'labels/LABEL_2_ID' in labels").execute().getItems();

Python

file_list = drive_service.files().list(includeLabels="LABEL_1_ID,LABEL_2_ID", q="'labels/LABEL_1_ID' in labels and 'labels/LABEL_2_ID' in labels", fields="items(labelInfo, id)").execute();

Node.js

/**
* Search for Drive files with specific labels
* @return{obj} file list with labelInfo
**/
async function searchForFileWithLabels() {
  // Get credentials and build service
  // TODO (developer) - Use appropriate auth mechanism for your app

  const {GoogleAuth} = require('google-auth-library');
  const {google} = require('googleapis');

  const auth = new GoogleAuth({scopes: 'https://www.googleapis.com/auth/drive'});
  const service = google.drive({version: 'v3', auth});
  try {
    const fileList = await service.files.list({
      includeLabels: 'LABEL_1_ID,LABEL_2_ID',
      q: '\'labels/LABEL_1_ID\' in labels and \'labels/LABEL_2_ID\' in labels',
      fields:'files(labelInfo, id)',
    });
    return file;
  } catch (err) {
    // TODO (developer) - Handle error
    throw err;
  }

Sostituisci quanto segue:

  • LABEL_1_ID: Il primo labelId di un'etichetta da restituire.
  • LABEL_2_ID: La seconda labelId di un'etichetta da restituire.