Drive Labels API の概要

ラベルは、ユーザーがデータを整理、検索、適用できるように定義するメタデータです。 ポリシーを適用することもできます。Drive Labels API は RESTful API であり ドライブにメタデータを添付してビジネス プロセスをサポートする できます。この API の一般的な用途は次のとおりです。

  • 情報ガバナンス戦略に沿ってコンテンツを分類する - 特別な処理が必要な機密コンテンツやデータを識別するラベルを指定します。 たとえば、バッジラベル（色分けされたラベル付きのラベル）を 「Sensitivity」というタイトルを付けます。値が「トップシークレット」で 「機密」[公開]を選択します

  • ドライブ内のアイテムにポリシーを適用する - 管理するラベルを作成します ライフサイクル全体を通してコンテンツを推進し、 組織の記録保管方法に合わせて調整できますたとえば、ラベルを使用して データ損失ポリシー（DLP）を管理し、ラベルセット 「トップシークレット」に変更パソコンにダウンロードできません。

  • ファイルのキュレートと検索 - ラベルを作成することで、ファイルを検索しやすくなります。 組織内のユーザーが会社のコンテンツに基づいて 定義できます。たとえば、組織内のユーザーが ドライブの検索オプションで、署名待ちのすべての契約書を検索できます 特定の日付で表示できます

Drive Labels API で使用される一般的な用語のリストを以下に示します。

ラベル

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

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

ラベルのスタイルは 2 種類あります。

バッジラベル

ラベルに SelectionOptions 選択内容を含むフィールド タイプ。選択内容に応じて色分けできます。 重要ですこれを行うには、Deployment の badgeConfig から Properties/ Choice。

各ファイルに対して選択したオプションの色がドライブに表示されるので、 ファイルのステータスや分類などをわかりやすくできます。 たとえば、「トップ シークレット」は必要に応じてバッジラベル 表示されることがあります。一度に設定できるバッジラベルは 1 つのみです。

標準ラベル

0 個以上のフィールド タイプを含むラベル。標準ラベルは 「プロジェクト ムーンショット」などのラベルがすべてのファイルを すべてのリソースが含まれます。標準ラベルには 説明します。例: 「契約」というタイトルのラベル [Company]（会社）の [Company]（会社）[Due Date][ステータス]を選択しますおよび 「署名者」です。各フィールドは特定のタイプ（テキスト、日付、 選択されます。

バッジラベルの図。
図 1.バッジラベル
標準ラベルの図。
図 2.標準ラベル
フィールド

ラベルの個々の型付き設定可能なコンポーネント。ラベルにはゼロまたは 1 つの 多数のフィールドが関連付けられます。

フィールド タイプ
フィールドに関連付けられた値のデータ型。次のように構成可能 テキスト、整数、日付、ユーザー、選択。このフィールドに ListOptions を使用すると、ユーザー フィールドと選択フィールドを複数の 使用できます。選択したタイプは、変数に適用可能な ドライブのアイテムと使用可能な検索クエリ オプション。
選択肢

ユーザーが SelectionOptions 内で選択できるオプションのうちの 1 つ 表示されます。

ラベルタイプ

すべてのラベルに LabelType が含まれます。ラベルには次の 2 種類があります。

管理者

管理者所有のラベルを作成、編集するには、アカウントである必要があります 管理者ロールを持つ ラベルの管理 ありません。

管理者は、任意のユーザーと管理者ラベルを共有して、そのユーザーに そのロールは、ドライブ アイテムの表示と適用ができます。変更または読み取り ドライブのアイテムのラベル値を使用するには、次の権限が必要です。

  • 変更 - ユーザーがファイルに関連するドライブのアイテム メタデータを ユーザーに適切な権限レベルが必要です。

    • ドライブのアイテム: EDITOR
    • ラベル: APPLIER

  • 読み取り - ユーザーがドライブのアイテムのメタデータの読み取りまたは検索を行う ユーザーが特定のラベルに関連する情報を 権限レベル:

    • ドライブのアイテム: READER
    • ラベル: READER
Shared

管理者以外のユーザーは、他のユーザーが適用できる共有ラベルを作成できます 適用できます。チームは使用するための独自のラベルを作成、整理できる チーム内で共有できます。

ラベルの分類

ユーザーがアプリケーションで ドライブのファイル。ラベルスキーマとも呼ばれます。

ラベル分類の例:

  • 感度 - 赤、オレンジ、黄、緑
  • ステータス - 未開始、下書き、審査中、最終
  • コンテンツ タイプ - 契約、設計ドキュメント、モックアップ
  • 部門 - マーケティング、財務、人事、セールス
ラベルのライフサイクル

ラベルはライフサイクルを経て作成、公開、更新、 できます。ラベルがライフサイクルを進むにつれて、そのラベルのリビジョンが 増加します。詳細については、ラベルのライフサイクルをご覧ください。

ラベルのリビジョン

ラベルのインスタンス。ラベルの作成、更新、公開、 ラベルのリビジョンが増加します。

下書きのリビジョン
ラベルの現在の下書きインスタンスのリビジョン番号。Google Chat では ラベルに複数回の更新を行い、そのたびに下書きのリビジョンを 1 つ上げる 公開済みのリビジョンには影響しません。データ アナリストは、 未公開のラベルを使用すると、公開前にラベルの更新をテストできます。
公開済みのリビジョン
ラベルの公開バージョンのリビジョン番号。公開されている label は、現在ユーザーが使用できるラベルのインスタンスです。