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