Visão geral do Cloud Product Registry

A API Cloud Product Registry serve como a fonte oficial de produtos Google Cloud próprios. Use essa API para acessar de maneira programática a hierarquia oficial de Google Cloud, garantindo que seus catálogos internos e políticas de governança dependam de dados precisos e em tempo real.

Modelo de dados

O registro organiza os recursos em uma hierarquia de três níveis: Suítes de produtos, Produtos lógicos e Variantes de produtos lógicos. Essa estrutura ajuda você a navegar pela relação entre marcas de alto nível e entidades lógicas específicas.

Pacote de produtos

Um pacote de produtos é uma entidade organizacional de alto nível que representa um grupo unificado de produtos que compartilham uma marca e um posicionamento de mercado comuns. Ela atua como a marca principal que abriga produtos lógicos relacionados, criando uma família unificada de soluções. Por exemplo, Google Cloud, Google Workspace e Google Maps.

  • Presença de marketing distinta: o pacote tem uma página de marketing de nível superior e funciona como o principal ponto de entrada para descobrir apps e produtos relacionados. Por exemplo, Google Workspace ou Google Cloud.
  • Agrupamento coeso: o pacote aparece publicamente como uma família unificada para destacar a relação entre produtos em um domínio compartilhado.
  • Identidade externa: o mercado identifica o pacote como um único grupo, e não como uma coleção solta de produtos lógicos.
  • Entidade não comprável: não é possível comprar uma "Suite" diretamente. Em vez disso, você compra ou ativa os produtos lógicos individuais contidos nele.

Produto lógico

Um produto lógico é uma oferta independente e de primeira linha em um pacote de produtos. Eles são projetados para serem reconhecidos, comprados e usados como soluções distintas com limites claros.

  • Foco no cliente: o mercado reconhece isso como uma oferta separada. Ela tem uma marca exclusiva e está alinhada às expectativas dos clientes.
  • Totalmente funcional: inclui APIs, interfaces do usuário ou clientes exclusivos que oferecem funcionalidades distintas e completas. Exemplos incluem Compute Engine, Cloud SQL e Persistent Disk.
  • Utilitário independente: você pode comprar o produto de forma independente ou usá-lo funcionalmente sem dependências forçadas de outros produtos.
  • Gerenciamento especializado: uma equipe de produto designada gerencia todo o ciclo de vida, do lançamento ao encerramento.
  • Suporte: geralmente inclui opções de suporte dedicado fornecidas diretamente pelo Google.

Variante de produto lógico

Uma variante de produto lógico é uma versão especializada de um produto principal. Ele mantém a potência e a funcionalidade principais do produto principal, mas é ajustado para uma tecnologia, um caso de uso ou um segmento de mercado específico.

  • Criada com base em um núcleo comprovado: a variante evolui diretamente de um produto principal e compartilha a mesma arquitetura subjacente.
  • Projetada para uma finalidade específica: a variante é adaptada para atender às necessidades específicas do cliente. Por exemplo, "Cloud SQL" é o produto, e "Cloud SQL para MySQL" e "Cloud SQL para PostgreSQL" são as variantes.

Recursos e escopo

Nesta versão, a API fornece metadados essenciais para produtos lógicos e variantes de produtos lógicos, incluindo:

  • Nome: nome do recurso da entidade.
  • Título: nome oficial da entidade.
  • Status do ciclo de vida: o estágio atual de lançamento da entidade.

Exclusões

A API contém apenas produtos principais do Google Cloud . Isso exclui o Google Maps e os produtos do Google Workspace.

Benefícios do Cloud Product Registry

O Cloud Product Registry oferece uma interface padronizada para descoberta de produtos, simplificando a integração com o catálogo Google Cloud .

  • Única fonte de verdade: acesse o registro oficial de todos os títulos, IDs e descrições de produtos do Google Cloud para eliminar as suposições.
  • Dados estruturados claros: a API permite navegar pelas relações entre as suítes de produtos de alto nível, os produtos lógicos individuais e as variantes específicas deles.

Acesso e autenticação

Como a API Cloud Product Registry expõe dados públicos do Google, não são necessárias outras permissões do IAM no nível do projeto para acessar essa API.

Cotas e limites

Para garantir acesso justo e estabilidade do serviço, a API aplica limitação de taxa com base no projeto. O sistema rastreia o uso de solicitações em relação ao seuGoogle Cloud ID do projeto e aplica os limites padrão de consultas por segundo (QPS).

Gerenciamento do ciclo de vida

O Google gerencia o ciclo de vida dos produtos com processos definidos para descontinuação e reestruturação. Entender esses eventos ajuda você a manter integrações estáveis e antecipar mudanças no catálogo.

Suspensão de uso

Quando um produto lógico ou uma variante é descontinuada, o sistema imediatamente restringe novas vendas ou registros. Para oferecer suporte a clientes legados, a entidade permanece visível na API. O sistema só remove permanentemente depois que todos os contratos associados expiram.

Reestruturação

A reestruturação ocorre quando a classificação de uma entidade muda devido à expansão dos negócios. Isso geralmente acontece quando um produto lógico independente é reclassificado como uma variante de produto lógico ou vice-versa.

  • Nome do recurso: o nome do recurso da entidade muda devido à mudança de tipo.
  • Comportamento da API: todas as APIs Get e List incluem campos de metadados adicionais para informar se uma entidade foi substituída por um tipo diferente:
    • Substituído: o campo é definido como "true" se for reestruturado.
    • Substituição: o campo contém o novo nome do recurso dessa entidade devido a uma mudança de tipo.

A seguir

Confira os seguintes recursos para saber mais sobre como usar o Cloud Product Registry: