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