Descripción general de Cloud Product Registry

La API de Cloud Product Registry sirve como fuente autorizada de verdad para los productos Google Cloud propios. 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 en el mercado comunes. Actúa como la marca general que alberga los Productos Lógicos relacionados, lo que crea una familia unificada de soluciones. Por ejemplo, Google Cloud, Google Workspace y Google Maps.

  • Presencia de marketing distintiva: La suite 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 coherente: La suite 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 independiente y de primer nivel 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. Entre los ejemplos, se incluyen Compute Engine, Cloud SQL y Persistent Disk.
  • Utilidad independiente: Puedes comprar el producto de forma independiente o usarlo 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 el cierre.
  • Compatible: A menudo, incluye opciones de asistencia especializadas que proporciona Google directamente.

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 se ajusta para una tecnología, un caso de uso o un segmento de mercado específicos.

  • Creada sobre un núcleo probado: La variante evoluciona directamente a partir de un producto principal y comparte la misma arquitectura subyacente.
  • Diseñada para un propósito específico: La variante se adapta para satisfacer las necesidades específicas del cliente. Por ejemplo, Cloud SQL es el producto, y Cloud SQL para MySQL y Cloud SQL para PostgreSQL son las variantes.

Funciones y alcance

En 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: 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 Google Cloud principales. No incluye los productos de Google Maps ni Google Workspace.

Beneficios del Registro de productos en la nube

Cloud Product Registry proporciona una interfaz estandarizada para el descubrimiento de productos, lo que simplifica la forma en que te integras con el catálogo de Google Cloud .

  • Única fuente de información: Puedes eliminar las conjeturas accediendo al registro oficial de todos los títulos, IDs y descripciones de los productos de Google Cloud .
  • Datos claros y estructurados: La API te permite navegar por las relaciones entre las suites 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 límite de frecuencia basados en el proyecto. El sistema hace un seguimiento del uso de tus solicitudes en relación con tu ID de proyectoGoogle Cloud y aplica los límites estándar de consultas por segundo (QPS).

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 deja de usar un producto o una variante lógica, el sistema inmediatamente restringe las nuevas ventas o registros. Para admitir a los clientes heredados, la entidad sigue siendo visible en la API. El sistema lo 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 comercial. Esto suele ocurrir cuando un producto lógico independiente se reclasifica como una variante del producto lógico o viceversa.

  • Nombre del recurso: El nombre del recurso de la entidad cambia debido a un 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 como 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: