標籤是您定義的中繼資料,可協助使用者整理、尋找及套用 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 快速入門導覽課程。