Cloud Product Registry API 是第一方 Google Cloud 產品的權威資訊來源。您可以使用這個 API 以程式輔助方式存取 Google Cloud的官方階層，確保內部目錄和控管政策採用準確的即時資料。
資料模型
登錄檔會將資源整理成三層階層：產品套件、邏輯產品和邏輯產品變體。這個結構可協助您瞭解高階品牌和特定邏輯實體之間的關係。
產品套件
產品套件是高層級的機構實體，代表共用相同品牌和市場定位的產品統一分組。這個品牌會做為相關邏輯產品的傘狀品牌，建立統一的解決方案系列。例如 Google Cloud、Google Workspace 和 Google 地圖。
- 獨特的行銷曝光：套件設有頂層行銷頁面，可做為探索相關應用程式和產品的主要入口點。例如 Google Workspace 或 Google Cloud。
- 一致的群組：套件會以統一的系列產品形式公開顯示，藉此強調共用網域中產品之間的關係。
- 外部身分：市場會將套裝組合視為單一群組，而非鬆散的邏輯產品集合。
- 無法購買的實體：您無法直接購買「套裝組合」，而是購買或啟用其中的個別邏輯產品。
邏輯產品
邏輯產品是產品套裝組合中的頂級獨立產品。這些產品的設計宗旨是讓使用者能辨識、購買及使用，並清楚瞭解各項解決方案的界線。
- 以消費者為中心：市場將此視為獨立產品，具有獨特品牌，且符合消費者期望。
- 功能齊全：包含獨特的 API、使用者介面或用戶端，可提供獨特的端對端功能。例如 Compute Engine、Cloud SQL 和 Persistent Disk。
- 獨立實用性：您可以單獨購買產品，或在不強制依附其他產品的情況下使用產品功能。
- 專人管理：指定產品團隊會管理整個生命週期，從推出到終止服務。
- 支援：通常包括 Google 直接提供的專屬支援選項。
邏輯產品子類
邏輯產品變體是主要產品的特殊版本，保留主要產品的核心功能，但針對特定技術、用途或市場區隔進行調整。
- 以經過驗證的核心為基礎：變體直接從主要產品演變而來，並共用相同的基礎架構。
- 專為特定用途打造：變體版本專為滿足特定客戶需求而設計。舉例來說，Cloud SQL 是產品，MySQL 適用的 Cloud SQL 和 PostgreSQL 適用的 Cloud SQL 則是變體版本。
功能和適用範圍
在這個版本中，API 會提供邏輯產品和邏輯產品變體的必要中繼資料，包括：
- 名稱：實體的資源名稱。
- 名稱：實體的官方名稱。
- 生命週期狀態：實體的目前發布階段。
排除條件
API 只包含核心 Google Cloud 產品。Google 地圖和 Google Workspace 產品不適用這項政策。
雲端產品註冊表的好處
Cloud Product Registry 提供標準化介面，方便您探索產品，簡化與 Google Cloud 目錄的整合方式。
- 單一可靠來源：你可以存取所有 Google Cloud 產品名稱、ID 和說明的官方記錄，不必再猜測。
- 清楚的結構化資料：透過 API，您可以瀏覽高階產品套件、個別邏輯產品及其特定變體之間的關係。
存取與驗證
由於 Cloud Product Registry API 會公開 Google 資料，因此存取這項 API 時，不需要專案層級的額外 IAM 權限。
配額與限制
為確保存取權公平且服務穩定，API 會根據專案套用頻率限制。系統會根據Google Cloud 專案 ID 追蹤要求用量，並強制執行標準每秒查詢次數 (QPS) 限制。
生命週期管理
Google 會透過定義的淘汰和重組程序，管理產品的生命週期。瞭解這些事件有助於維持穩定的整合，並預期目錄的變更。
淘汰
當邏輯產品或變體遭到淘汰時，系統會立即限制其新銷售或註冊。為支援舊客戶，實體仍會顯示在 API 中。只有在所有相關合約到期後，系統才會永久移除該實體。
重組
當實體的分類因業務擴展而變更時，就會發生重組。常見情況是獨立的邏輯產品重新分類為邏輯產品變體，反之亦然。
- 資源名稱：由於類型變更，實體的資源名稱也會變更。
- API 行為：所有 Get 和 List API 都包含額外的中繼資料欄位，可傳達實體是否已替換為其他類型：
- 已取代：如果重新建構，欄位會設為 true。
- 取代：由於類型變更，欄位包含這個實體的新資源名稱。
後續步驟
如要進一步瞭解如何使用 Cloud Product Registry，請參閱下列資源：