ラベルの概要

ラベルは、ユーザーが Google ドライブ内のファイルを整理、検索、ポリシーを適用するのに役立つメタデータです。Drive API を使用すると、デベロッパーはファイルとフォルダにラベルを適用したり、ラベルのフィールド値を設定したり、ファイルのラベルとフィールド値を読み取ったり、カスタム ラベル分類で定義されたメタデータ用語を使用してファイルを検索したりできます。

ドライブラベルを使用すると、ファイルとフォルダにメタデータを添付してビジネス プロセスをサポートできます。ラベルの一般的な用途は次のとおりです。

  • 情報ガバナンス戦略に沿ってコンテンツを分類する - ラベルを作成して、特別な扱いを必要とする機密性の高いコンテンツやデータを識別します。たとえば、「機密性」という名前のバジ付きラベル（オプション値が色分けされたラベル）を作成して、値を「極秘」、「機密」、「公開」に設定できます。

  • ドライブのアイテムにポリシーを適用する - ラベルを作成してドライブのコンテンツをライフサイクル全体で管理し、組織の記録保持の慣行に準拠させます。たとえば、ラベルを使用してデータ損失防止ポリシー（DLP）を管理し、ユーザーが「機密性」ラベルが「極秘」に設定されたファイルをダウンロードできないようにします。

  • ファイルの管理と検索 - ラベルを作成して、組織内のユーザーがラベルとそのフィールドに基づいてアイテムを検索できるようにすることで、会社のコンテンツの検索可能性を高めることができます。たとえば、特定の日付までに署名が必要なすべての契約に「署名ステータス」ラベルセットを「署名待ち」に適用します。ユーザーが「署名待ち」で検索すると、ドライブ検索でこれらの契約書が返されます。

ドライブのラベルで使用される一般的な用語は次のとおりです。

ラベル

ドライブ ファイルに配置された構造化メタデータ。ドライブのユーザーは、ファイルにラベルを割り当て、ラベル フィールドの値を設定できます。ラベルは次の要素で構成されます。

ラベル名
ラベルのリソース名。ラベル ID はラベル名の一部です。リクエストに応じて、名前は labels/{id} または labels/{id}@{revisionId} の形式になります。詳細については、下記のラベルのリビジョンをご覧ください。
ラベル ID
ラベルのグローバルに一意の識別子。ID はラベル名の一部ですが、名前とは異なり、リビジョン間で一貫しています。
フィールド

ラベルの個別の型付き設定可能なコンポーネント。ラベルには、0 個以上のフィールドを関連付けることができます。選択フィールドとユーザー フィールドは、Google Drive Labels API でフィールドが ListOptions で構成されている場合、複数の値で設定できます。

フィールド タイプ
フィールドに関連付けられた値のデータ型。整数、日付文字列、テキスト、ユーザー、選択として構成できます。選択したタイプは、ドライブのアイテムに適用される有効な値と、使用可能な検索クエリ オプションの両方に影響します。
ラベル分類

ユーザーがドライブ ファイルに適用できる、構成済みのラベルフィールド。Drive Labels API を使用して読み取りと書き込みが可能です。ラベルスキーマとも呼ばれます。

ラベルのリビジョン

ラベルのインスタンス。ラベルが作成、更新、公開、非推奨になるたびに、ラベルのリビジョンが増分されます。

下書きのリビジョン
ラベルの現在のドラフト インスタンスのリビジョン番号。公開済みのリビジョンに影響を与えることなく、ラベルに複数の更新を加え、下書きのリビジョン番号をそれぞれ増やすことができます。ドラフトラベルを使用すると、公開前にラベルの更新をテストできます。
公開済みのリビジョン
ラベルの公開バージョンのリビジョン番号。公開ラベルは、ユーザーが利用できるラベルのインスタンスです。