Nach Dateien mit einem bestimmten Label oder Feldwert suchen

Auf dieser Seite wird beschrieben, wie Sie nach Dateien mit einem bestimmten Label oder Feldwert suchen.

Labelfeldtypen

Google Drive-Labelfelder sind stark typisiert. Jeder Typ unterstützt unterschiedliche Indexierungs- und Suchsemantik. In der folgenden Tabelle sind die verfügbaren Datentypen aufgeführt.

Typ	Optionen für Labeltypen	Unterstützte Suchoperatoren
Text	TextOptions	is null, is not null, =, contains, starts with
Langer Text	LongTextOptions	is null, is not null, contains
Ganzzahl	IntegerOptions	is null, is not null, =, !=, <, >, <=, >=
Datum	DateOptions	is null, is not null, =, !=, <, >, <=, >=
Auswahl	SelectionOptions	is null, is not null, =, !=
Nutzer	UserOptions	is null, is not null, =, !=
Auswahlliste	SelectionOptions (mit max_entries > 1)	is null, is not null, in, not in
Nutzerliste	UserOptions (mit max_entries > 1)	is null, is not null, in, not in

Suchbeispiele

Hinweis: In den folgenden Beispielen werden zur besseren Verständlichkeit lesbare Strings verwendet. Stattdessen müssen die tatsächlichen Ressourcennamen und Feld-IDs verwendet werden. labels/contract.execution_date könnte beispielsweise so aussehen: labels/837d7f5de85137b86e52.491d.

1. Suche basierend auf dem Vorhandensein eines Labels oder Felds

Sie können nach Elementen suchen, auf die ein bestimmtes Label angewendet wurde (oder nicht):

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

Sie können auch nach Elementen suchen, für die ein bestimmtes Feld festgelegt wurde (oder nicht):

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

Hinweis :Wenn Sie nach Dateien suchen, für die keine Felder festgelegt sind, werden Elemente zurückgegeben, auf die das Label nicht angewendet wurde. Sie können die beiden Abfragen oben kombinieren, um Elemente zu finden, auf die das Label angewendet wird, die aber keinen Wert für ein bestimmtes Feld enthalten: 'labels/contract' in labels AND labels/contract.comment IS NULL.

2. Suche nach einzelnen Werten

Sie können Suchanfragen schreiben, die mit erwarteten Feldwerten übereinstimmen. In der folgenden Tabelle sind die gültigen Feldabfragen aufgeführt:

Was Sie abfragen möchten	Abfragestring
Elemente, bei denen der Kommentar auf „hallo“ festgelegt ist	labels/contract.comment = 'hello'
Dateien, deren Kommentar mit „hallo“ beginnt	labels/contract.comment STARTS WITH 'hello'
Dateien, in denen der Status ausgeführt wird	labels/contract.status = 'executed'
Dateien, bei denen der Status nicht ausgeführt wird	labels/contract.status != 'executed'
Dateien, bei denen das Ausführungsdatum vor einem bestimmten Datum liegt	labels/contract.execution_date < '2020-06-22'
Dateien, bei denen „value_usd“ (ganze Zahl) kleiner als ein bestimmter Wert ist	labels/contract.value_usd < 2000
Dateien, bei denen „client_contact“ auf eine bestimmte E-Mail-Adresse festgelegt ist	labels/contract.client_contact = '[e-mail]'

3. Suche anhand von Feldern mit mehreren Werten (z. B. Optionslist.max_entries > 1)

Felder, die mehrere Werte unterstützen, können nur mit dem IN-Operator abgefragt werden:

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

Beispiel

Im folgenden Codebeispiel wird gezeigt, wie Sie mit einem oder mehreren labelId alle Dateien mit einem bestimmten Label oder Feldwert aus einer Drive-Dateiressource auflisten. Außerdem wird die Methode files.list verwendet. Der Anfragetext muss leer sein.

Wenn du labelInfo in die Antwort aufnehmen möchtest, musst du auch Folgendes angeben:

• includeLabels als durch Kommas getrennte Liste von IDs.

• labelInfo im Parameter fields, um anzugeben, dass die labelInfo innerhalb von includeLabels zurückgegeben werden soll.

Bei Erfolg enthält der Antworttext die Liste der Dateien.

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;
  }

Ersetzen Sie Folgendes:

• LABEL_1_ID: Der erste labelId eines zurückzugebenden Labels.
• LABEL_2_ID: Der zweite labelId eines Labels, das zurückgegeben werden soll.