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 是产品；Cloud SQL for MySQL 和 Cloud SQL for PostgreSQL 是变体。
功能和范围
在此版本中，该 API 为逻辑商品和逻辑商品变体提供了必要的元数据，包括：
- 名称：实体的资源名称。
- Title：实体的官方名称。
- 生命周期状态：实体的当前发布阶段。
排除项
该 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：