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 为逻辑产品和逻辑产品变体提供必要的元数据，包括：
- 名称：实体的资源名称。
- 标题：实体的官方名称。
- 生命周期状态：实体当前的发布阶段。
排除项
该 API 仅包含核心 Google Cloud 产品。它不包括 Google 地图和 Google Workspace 产品。
Cloud Product Registry 的优势
Cloud Product Registry 提供了一个用于产品 发现的标准化界面，简化了您与 Google Cloud 目录的集成方式。
- 单一可信来源：您可以访问所有产品标题、ID 和 说明的 Google Cloud 官方记录，从而消除猜测。
- 清晰的结构化数据：该 API 可让您了解高级产品套件、各个逻辑产品及其 特定变体之间的关系。
访问权限和身份验证
由于 Cloud Product Registry API 会公开 Google 数据，因此在项目级层访问此 API 时无需额外的 IAM 权限。
配额和限制
为确保公平访问和服务的稳定性，该 API 应用了基于项目的速率限制。系统会根据您的 Google Cloud 项目 ID 跟踪您的请求使用情况，并强制执行标准每秒查询次数 (QPS) 限制。
生命周期管理
Google 通过已定义的弃用和重组流程来管理产品的生命周期。了解这些事件有助于您维护稳定的集成并预测目录的更改。
弃用
当逻辑产品或变体被弃用时，系统会立即限制其进行新的销售或注册。为支持旧版客户，该实体在 API 中仍然可见。只有在所有相关合同到期后，系统才会永久移除该实体。
重组
当实体的分类因业务扩张而发生变化时，就会发生重组。这种情况通常发生在独立逻辑产品被重新分类为逻辑产品变体，或反之亦然时。
- 资源名称：实体的资源名称因类型更改而发生变化。
- API 行为：所有 Get 和 List API 都包含额外的元数据字段，用于说明实体是否被替换为其他类型：
- Replaced：如果实体经过重组，则该字段设置为 true。
- Replacement：由于类型更改，该字段包含此实体的新资源名称。
后续步骤
如需详细了解如何使用 Cloud Product Registry，请参阅以下资源：