標籤是您定義的中繼資料，可協助使用者管理與尋找 Google 雲端硬碟中的檔案，以及為這些檔案套用政策。Drive Labels API 是一種 RESTful API，可透過將中繼資料附加至您的雲端硬碟檔案來支援業務流程。這個 API 的常見用途包括：
依資訊管理策略分類內容：建立標籤，找出敏感內容或需要特殊處理的資料。舉例來說，您可以建立名為「敏感度」的徽章標籤 (含有以顏色編碼的選項值)，並將值設為「極機密」、「機密」和「公開」。
對雲端硬碟中的項目套用政策：建立標籤，在雲端硬碟內容的整個生命週期中進行管理，並確保內容符合貴機構的記錄保留程序。舉例來說，您可以透過標籤管理資料遺失防護 (DLP) 政策，禁止使用者將「機密程度」標籤設為「極機密」的檔案下載到電腦。
管理及尋找檔案：建立標籤，讓貴機構使用者根據標籤和欄位尋找項目，提升公司內容的搜尋便利性。舉例來說，貴機構使用者可以運用雲端硬碟搜尋選項，找出特定日期前待簽署的所有合約。
以下列出 Drive Labels API 中常用的術語：
- 標籤
放在雲端硬碟檔案上的結構化中繼資料。 雲端硬碟使用者可以為檔案指派標籤，並設定標籤欄位值。標籤的組成要素如下：
- 標籤名稱
- 標籤的資源名稱。標籤 ID 是標籤名稱的一部分。視要求而定，名稱格式為
labels/{id}或labels/{id}@{revisionId}。詳情請參閱下方的「標籤修訂」。 - 標籤 ID
- 標籤的全域專屬 ID。ID 是標籤名稱的一部分，但與名稱不同，ID 在修訂版本之間會保持一致。
標籤有 2 種樣式：
- 標記標籤
標籤，其中包含含有 choices 的
SelectionOptions欄位類型，可使用顏色編碼表示重要性。方法是透過Choice的Properties設定badgeConfig。雲端硬碟會為每個檔案顯示所選選項的顏色，讓使用者清楚瞭解檔案的狀態或分類。舉例來說，「機密」選項的「敏感度」徽章標籤可能會以紅色顯示。一個標籤只能有一個標記欄位，但可以有多個標記標籤。
- 標準標籤
包含零或多個欄位類型的標籤。標準標籤可能會有標籤名稱，例如「Project Moonshot」，並指出與該專案相關的所有檔案。標準標籤也可能有多個結構化欄位。舉例來說，標題為「合約」的標籤可能包含「公司」、「截止日」、「狀態」和「簽署人」欄位。每個欄位都有特定類型 (文字、日期、選項或使用者)。
|
|
- 欄位
標籤中可設定的個別類型元件。標籤可以沒有相關聯的欄位，也可以有多個欄位。
- 欄位類型
- 與欄位相關聯的值的資料類型。可設定為文字、整數、日期、使用者或選取項目。如果您使用
ListOptions設定欄位，可以為使用者和選項欄位設定多個值。所選類型會影響適用於雲端硬碟項目的有效值，以及可用的搜尋查詢選項。
- 選擇
使用者可在
SelectionOptions欄位中選擇的其中一個選項。- 標籤類型
所有標籤都包含
LabelType。標籤分為以下 2 種：- 管理員
如要建立及編輯管理員擁有的標籤，您必須是具備「管理標籤」權限的帳戶管理員。
管理員可以與任何使用者共用管理員標籤，授予使用者查看標籤並套用至雲端硬碟項目的權限。如要修改或讀取雲端硬碟項目的標籤值，必須具備下列權限：
修改：如要修改與特定標籤相關的雲端硬碟項目中繼資料，使用者必須具備適當的權限等級：
- 雲端硬碟項目：
EDITOR - 標籤：
APPLIER
- 雲端硬碟項目：
讀取：如要讓使用者讀取或搜尋與特定標籤相關的雲端硬碟項目中繼資料，使用者必須具備適當的權限等級：
- 雲端硬碟項目：
READER - 標籤：
READER
- 雲端硬碟項目：
非管理員使用者可以建立共用標籤，供其他人套用至雲端硬碟項目。團隊可以自行建立及整理標籤，供團隊內部使用，無須管理員協助。
- 標籤分類
使用者目前可套用至雲端硬碟檔案的標籤欄位。又稱「標籤結構定義」。
標籤分類範例：
- 敏感度 - 紅色、橘色、黃色、綠色
- 狀態：尚未開始、草稿、審查中、最終版
- 內容類型：合約、設計文件、模擬圖
- 部門：行銷、財務、人力資源、銷售
- 標籤生命週期
標籤的生命週期包括建立、發布及更新。標籤通過生命週期時，標籤修訂版本會遞增。詳情請參閱「標籤生命週期」。
- 標籤修訂
標籤的執行個體。每當建立、更新、發布或淘汰標籤時，標籤修訂版本就會遞增。
- 草擬修訂版本
- 標籤目前草稿例項的修訂版本號碼。您可以對標籤進行多次更新，每次更新都會增加草稿修訂版本號碼，但不會影響已發布的修訂版本。 草稿標籤功能可讓您先測試標籤更新，再發布更新內容。
- 已發布的修訂版本
- 已發布標籤的版本號碼。發布的標籤是目前可供使用者使用的標籤例項。
相關主題
如要瞭解如何使用 Google Workspace API 進行開發，包括處理驗證和授權，請參閱「開始使用 Google Workspace 開發人員身分」。
如要瞭解如何設定及執行簡單的 Labels API 應用程式，請參閱 Python 快速入門指南。