ラベルの概要

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

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

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

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

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

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

ラベル

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

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

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

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

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

ラベルのリビジョン

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

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