Descripción general de Cloud Product Registry

La API de Cloud Product Registry sirve como fuente de información confiable y autorizada para los productos propios Google Cloud . Puedes usar esta API para acceder de forma programática a la jerarquía oficial de Google Cloud, lo que garantiza que tus catálogos internos y políticas de administración se basen en datos precisos y en tiempo real.

Modelo de datos

El registro organiza los recursos en una jerarquía de tres niveles: Paquetes de productos, Productos lógicos y Variantes de productos lógicos. Esta estructura te ayuda a navegar por la relación entre las marcas de alto nivel y la entidad lógica específica.

Paquete de productos

Un paquete de productos es una entidad organizativa de alto nivel que representa una agrupación unificada de productos que comparten una marca y un posicionamiento de mercado comunes. Actúa como la marca general que alberga productos lógicos relacionados, lo que crea una familia unificada de soluciones. Por ejemplo, Google Cloud, Google Workspace y Google Maps.

  • Presencia de marketing distinta: El paquete incluye una página de marketing de nivel superior y actúa como el punto de entrada principal para descubrir apps y productos relacionados. Por ejemplo, Google Workspace o Google Cloud.
  • Agrupación cohesiva: El paquete aparece públicamente como una familia unificada para destacar la relación entre los productos en un dominio compartido.
  • Identidad externa: El mercado identifica el paquete como un solo grupo en lugar de una colección suelta de productos lógicos.
  • Entidad no comprable: No puedes comprar un "paquete" directamente. En cambio, compras o habilitas los productos lógicos individuales que contiene.

Producto lógico

Un producto lógico es una oferta destacada y autónoma dentro de un paquete de productos. Estos productos están diseñados para reconocerse, comprarse y usarse como soluciones distintas con límites claros.

  • Centrado en el cliente: El mercado reconoce esto como una oferta independiente. Tiene una marca única y se alinea con las expectativas de los clientes.
  • Completamente funcional: Incluye APIs, interfaces de usuario o clientes únicos que proporcionan una funcionalidad integral y distinta. Algunos ejemplos son Compute Engine, Cloud SQL y Persistent Disk.
  • Utilidad independiente: Puedes comprar el producto de forma independiente o usar lo de forma funcional sin dependencias forzadas de otros productos.
  • Administración experta: Un equipo de productos designado administra todo el ciclo de vida, desde el lanzamiento hasta la baja.
  • Compatible: A menudo incluye opciones de asistencia dedicadas que proporciona Google directamente Google.

Variante de producto lógico

Una variante de producto lógico es una versión especializada de un producto principal. Conserva la potencia y la funcionalidad principales del producto principal, pero está optimizada para una tecnología, un caso de uso o un segmento de mercado específicos.

  • Compilación en un núcleo probado: La variante evoluciona directamente desde un producto principal y comparte la misma arquitectura subyacente.
  • Diseño específico: La variante se adapta para satisfacer las necesidades específicas de los clientes. Por ejemplo, Cloud SQL es el producto; Cloud SQL para MySQL y Cloud SQL para PostgreSQL son las variantes.

Funcionalidades y alcance

Para esta versión, la API proporciona metadatos esenciales para los productos lógicos y las variantes de productos lógicos, incluidos los siguientes:

  • Nombre: Es el nombre del recurso de la entidad.
  • Título: Es el nombre oficial de la entidad.
  • Estado del ciclo de vida: Es la etapa de lanzamiento actual de la entidad.

Exclusiones

La API solo contiene productos principales. Google Cloud Excluye los productos de Google Maps y Google Workspace.

Beneficios de Cloud Product Registry

Cloud Product Registry proporciona una interfaz estandarizada para el descubrimiento de productos, lo que simplifica la integración con el catálogo Google Cloud .

  • Fuente única de información confiable: Puedes eliminar las conjeturas accediendo al registro oficial de todos los Google Cloud títulos, IDs y descripciones de los productos.
  • Datos claros y estructurados: La API te permite navegar por las relaciones entre los paquetes de productos de alto nivel, los productos lógicos individuales y sus variantes específicas.

Acceso y autenticación

Dado que la API de Cloud Product Registry expone datos públicos de Google, no se requieren permisos de IAM adicionales a nivel del proyecto para acceder a esta API.

Cuotas y límites

Para garantizar un acceso justo y la estabilidad del servicio, la API aplica la límite de frecuencia basada en el proyecto. El sistema hace un seguimiento del uso de tus solicitudes en función de tu Google Cloud ID del proyecto y aplica los límites estándar de consultas por segundo (QPS) límites.

Administración del ciclo de vida

Google administra el ciclo de vida de los productos a través de procesos definidos para la baja y la reestructuración. Comprender estos eventos te ayuda a mantener integraciones estables y anticipar los cambios en el catálogo.

Baja

Cuando se da de baja un producto o una variante lógica, el sistema lo restringe de inmediato para las ventas o los registros nuevos. Para admitir a los clientes heredados, la entidad permanece visible en la API. El sistema la quita de forma permanente solo después de que vencen todos los contratos asociados.

Reestructuración

La reestructuración se produce cuando cambia la clasificación de una entidad debido a la expansión empresarial. Esto suele ocurrir cuando un producto lógico independiente se reclasifica como una variante de producto lógico o al revés.

  • Nombre del recurso: El nombre del recurso de la entidad cambia debido al cambio de tipo.
  • Comportamiento de la API: Todas las APIs de Get y List incluyen campos de metadatos adicionales para indicar si una entidad se reemplaza por un tipo diferente:
    • Reemplazado: El campo se establece en verdadero si se reestructura.
    • Reemplazo: El campo contiene el nuevo nombre del recurso de esta entidad debido a un cambio de tipo.

¿Qué sigue?

Explora los siguientes recursos para obtener más información sobre el uso de Cloud Product Registry: