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