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，請參閱下列資源：