特定のラベルやフィールド値を持つファイルを検索する

このページでは、特定のラベルまたはフィールド値を持つファイルを検索する方法について説明します。 適用されました。

ラベルの項目型

Google ドライブのラベル フィールドは厳密に型指定されており、それぞれの型が インデックス登録と検索セマンティクスが異なります。次の表に、使用可能な Pod の 説明します。

タイプ ラベルタイプのオプション サポートされている検索演算子
テキスト TextOptions is null, is not null, =, contains, starts with
長いテキスト LongTextOptions is null, is not null, contains
Integer IntegerOptions is null, is not null, =, !=, <, >, <=, >=
日付 DateOptions is null, is not null, =, !=, <, >, <=, >=
選択 SelectionOptions is null, is not null, =, !=
ユーザー UserOptions is null, is not null, =, !=
選択リスト SelectionOptions(max_entries > 1) is null, is not null, in, not in
ユーザーリスト UserOptions(max_entries > 1) is null, is not null, in, not in

1. ラベルまたはフィールドの有無に基づいて検索する

特定のラベルが付いているアイテム(または付けられていないアイテム)を検索できます。

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

特定のフィールドが設定されている(または設定されていない)アイテムを検索することもできます。

  • labels/contract.comment IS NOT NULL
  • labels/contract.comment IS NULL
で確認できます。

2. 単一値フィールドに基づいて検索する

想定されるフィールド値に一致する検索クエリを作成できます。次の表に に、有効なフィールド クエリを示します。

クエリの対象 クエリ文字列
コメントが「hello」に設定されているアイテム labels/contract.comment = 'hello'
コメントが「hello」で始まるファイル labels/contract.comment STARTS WITH 'hello'
ステータスが実行されているファイル labels/contract.status = 'executed'
ステータスが実行されていないファイル labels/contract.status != 'executed'
execution_date が特定の日付より前のファイル labels/contract.execution_date < '2020-06-22'
value_usd(整数)が特定の値より小さいファイル labels/contract.value_usd < 2000
client_contact が特定のメールアドレスに設定されているファイル labels/contract.client_contact = 'alex@altostrat.com'

3. 複数の値を持つフィールド( ListOptions.max_entries >1)

複数の値をサポートするフィールドのクエリを実行するには、IN 演算子を使用する必要があります。

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

次のコードサンプルは、1 つ以上の labelId を使用してすべてを一覧表示する方法を示しています。 ドライブ ファイルの特定のラベルまたはフィールド値を持つファイル resource。また、 files.list メソッドを使用します。リクエスト本文は、 空にします。

レスポンスに labelInfo を含める場合は、以下も指定する必要があります。

  • includeLabels ID のカンマ区切りのリストとして指定できます

  • fields パラメータ内の labelInfo は、 includeLabels 内で labelInfo が返されました。

成功すると、レスポンスは body にはリストが含まれる できます。

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

次のように置き換えます。

  • LABEL_1_ID: 返されるラベルの最初の labelId
  • LABEL_2_ID: 返されるラベルの 2 番目の labelId