ラベルの概要

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

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

  • 情報ガバナンス戦略に従ってコンテンツを分類する - 特別な処理が必要な機密コンテンツやデータを識別するラベルを作成します。たとえば、「機密」「機密」「一般公開」の値を持つバッジラベル(色分けされたオプション値を含むラベル)を作成できます。

  • ドライブ内のアイテムにポリシーを適用する - ドライブ コンテンツがライフサイクル全体を通して管理され、組織の記録管理手法を遵守するようにラベルを作成できます。たとえば、ラベルを使用してデータ損失ポリシー(DLP)を管理します。これにより、「機密」ラベルが「最高機密」に設定されているファイルをダウンロードできなくなります。

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

ドライブラベルで使用される一般的な用語を以下に示します。

ラベル

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

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

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

フィールド タイプ
フィールドに関連付けられた値のデータ型。Integer、dateString、text、user、selection として構成できます。選択したタイプは、ドライブのアイテムに適用される有効な値と使用可能な検索クエリのオプションに影響します。
ラベルの分類

ユーザーがドライブ ファイルに適用する際に現在使用できるラベル フィールド。Drive Labels API を通じて読み取りおよび書き込みが可能です。ラベル スキーマとも呼ばれます。

ラベルのリビジョン

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

リビジョンの下書き
ラベルの現在のドラフト インスタンスのリビジョン番号。ラベルにいくつかの更新を行うことができます。その場合、公開済みのリビジョンに影響を与えることなく、それぞれで下書きのリビジョン番号をインクリメントできます。下書きラベルを使用する機能は、公開前にラベルの更新をテストできます。
公開済みの版
ラベルの公開済みバージョンのリビジョン番号。公開されたラベルは、現在ユーザーが利用できるラベルのインスタンスです。

次のステップ