Drive Labels API 總覽

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

標籤是您定義的中繼資料,可協助使用者管理與尋找 Google 雲端硬碟中的檔案,並對這類檔案套用政策。Drive Labels API 是符合 REST 樣式的 API,支援可將中繼資料附加至雲端硬碟檔案,藉此支援業務程序。這個 API 的常見用途包括:

  • 依資訊管理策略分類內容:建立標籤,識別需要特別處理的敏感內容或資料。 舉例來說,您可以建立標有「機密」、「機密」和「公開」值的「機密等級」標記標籤 (含顏色編碼選項的標籤)。

  • 將政策套用至雲端硬碟中的項目:在整個生命週期中建立標籤來管理雲端硬碟內容,並確保內容符合貴機構的記錄保留做法。例如,使用標籤來管理資料遺失防護政策 (DLP),將「機密性」標籤設為「頂端密鑰」的檔案無法下載到電腦上。

  • 收錄及尋找檔案 - 建立標籤,讓機構使用者根據標籤及其欄位尋找項目,提高貴公司內容的可搜尋性。舉例來說,貴機構的使用者可以使用雲端硬碟搜尋選項找出所有在特定日期之前簽署的合約。

以下是 Drive Labels API 中常用的字詞清單:

標籤

雲端硬碟檔案的結構化中繼資料。雲端硬碟使用者可以指派標籤,並設定檔案的標籤欄位值。標籤由下列項目組成:

標籤名稱
標籤的資源名稱。標籤 ID 由標籤名稱組成。名稱會依要求的格式而異:labels/{id}labels/{id}@{revisionId}。詳情請參閱下方的標籤修訂版本一節。
標籤 ID
標籤的全域唯一識別碼。ID 是由標籤名稱的一部分組成,但與名稱不同,在修訂版本之間是一致的。

標籤有 2 種樣式:

標記標籤

具有 SelectionOptions 欄位類型的標籤,包含具有選項的 choices 以表示重要性的重要性。方法是透過 ChoiceProperties 設定 badgeConfig

雲端硬碟會顯示每個檔案選項的顏色,讓使用者清楚瞭解檔案的狀態、分類等。舉例來說,「敏感性」標記標籤的「最高機密」選項可能會顯示為紅色。一次只能設定一個標記標籤。

標準標籤

標籤包含零或多個欄位類型。標準標籤可能會包含「Project Moonshot」標籤標籤,並指出與專案相關的所有檔案。標準標籤也可能有多個結構化欄位。例如,標題為「合約」的標籤可能包含「公司」、「截止日」、「狀態」和「簽署者」等欄位。每個欄位都有特定的類型 (文字、日期、選項或使用者)。

標記標籤圖表。
圖 1.標記標籤
標準標籤圖。
圖 2.標準標籤
欄位

標籤的個別類型,可設定元件。一個標籤可以有零個或多個相關聯的欄位。

欄位類型
欄位相關聯的值的資料類型。可設為文字、整數、日期、使用者或選項。使用 ListOptions 設定欄位時,您可以設定使用者及具有多個值的選取欄位。您選取的類型會影響雲端硬碟項目適用的有效值和可用的搜尋查詢選項。
選擇

使用者可以從 SelectionOptions 欄位中選擇其中一個選項。

標籤類型

所有標籤都包含 LabelType。標籤分為 2 種:

管理

如要建立及編輯管理員擁有的標籤,您必須是具備管理標籤權限的帳戶管理員。

管理員可以與管理員分享管理員標籤,授予使用者檢視及套用至雲端硬碟項目的權限。修改或讀取雲端硬碟項目的標籤值需要下列權限:

  • 修改 - 使用者必須具有適當的權限層級,才能修改與指定標籤相關的雲端硬碟項目中繼資料:

    • 雲端硬碟項目:EDITOR
    • 標籤:APPLIER
  • 讀取 - 使用者必須具有適當的權限層級,才能讀取或搜尋與指定標籤相關的雲端硬碟項目中繼資料:

    • 雲端硬碟項目:READER
    • 標籤:READER
分享

非管理員使用者可以建立共用標籤,供其他人套用至雲端硬碟項目。團隊可以建立及管理自己的標籤,以便在團隊內使用,而且不需要管理員。

標籤分類

使用者目前設定的標籤欄位,可供應用程式雲端硬碟檔案使用。又稱為標籤架構。

標籤分類範例:

  • 靈敏度:紅色、橘色、黃色、綠色
  • 狀態:尚未開始、草稿、審核中、最終結果
  • 內容類型:合約、設計文件、模擬圖
  • 部門:行銷、財務、人力資源、銷售
標籤生命週期

標籤會在建立、發布、更新等整個生命週期中經歷。標籤在整個生命週期中皆會增加,其「標籤修訂版本」也會遞增。詳情請參閱下方的標籤生命週期一節。

標籤修訂版本

標籤的執行個體。每當建立、更新、發布或淘汰標籤時,標籤修訂版本都會遞增。

修訂版本草稿
標籤目前草稿執行個體的修訂版本編號。您可以對標籤進行多項更新,每次都會增加其草稿修訂版本編號,而不影響已發布的修訂版本。只要能夠使用草稿標籤,就能在發布前測試標籤更新。
已發布的修訂版本
標籤已發布版本的修訂版本編號。已發布的標籤就是目前使用者可用的標籤執行個體。

標籤生命週期

標籤、欄位和選項會在整個生命週期中經歷特定狀態。 此外,標籤可能會有不同的修訂版本。下圖顯示標籤生命週期,包括修訂版本:

標籤生命週期圖表。
圖 3. 標籤的生命週期
  1. 建立標籤 (create()) - 這個標籤會在 revision_id=1 中建立,並儲存在資料庫中。標籤的狀態為 UNPUBLISHED_DRAFT。在這個狀態下:
    • 使用者無法查看標籤
    • 使用者無法將標籤套用至雲端硬碟項目。
  2. (選用) 更新標籤、欄位或選項 (delta()):所有更新 (甚至是尚未發布) 都會儲存在資料庫中,標籤的修訂版本也會增加。
  3. 發布標籤 (publish()) - 標籤狀態為 PUBLISHED,且使用者可以套用該標籤。發布標籤會增加其修訂版本。
  4. (選用) 更新標籤、欄位或選項 (delta()):系統會更新標籤、欄位或選項,並將其儲存為資料庫做為草稿標籤。這個標籤的狀態為 PUBLISHED,包含 hasUnpublishedChanges=true,代表有草稿變更,但使用者無法使用。每次更新都會增加標籤的修訂版本。
  5. (選用) 發布標籤 (publish()):如果有最新的草稿,系統會發布。這個標籤的狀態為 PUBLISHED,且使用者可以套用該標籤。發布標籤會增加其版本。
  6. 停用標籤 (disable()):標籤狀態為 DISABLED,但使用者可透過 API 套用標籤。但是,除非將標籤設為顯示,否則已停用的使用者介面不會顯示標籤。淘汰標籤會增加修訂版本。
  7. 啟用標籤 (enable()):標籤會恢復為 PUBLISHED 狀態,且使用者可以套用該標籤。發布標籤會增加其修訂版本。
  8. 刪除標籤 (delete()) - 該標籤的狀態為 DELETED,且無法套用。已刪除的標籤最終會遭到清除。

請務必強調,每次更新標籤都會使標籤的修訂版本增加。此外,如果標籤已發布,則在「n」更新後再次發布標籤,代表發布的修訂版本編號為修訂版本 +「n」加上「1」的連續更新次數。

後續步驟