Visão geral do Cloud Product Registry

A API Cloud Product Registry serve como a fonte de verdade autoritativa para produtos próprios Google Cloud . É possível usar essa API para acessar de forma programática a hierarquia oficial de Google Cloud ferramentas, 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: Pacotes de produtos, Produtos lógicos e Variantes de produtos lógicos. Essa estrutura ajuda a navegar pela relação entre marcas de alto nível e ferramentas específicas e funcionais.

Pacote de produtos

Um pacote de produtos é uma entidade organizacional de alto nível que representa um agrupamento unificado de produtos que compartilham uma marca e um posicionamento de mercado comuns. Ele atua como a marca guarda-chuva que abriga ferramentas relacionadas, criando uma família unificada de soluções. Por exemplo, Google Cloud, Google Workspace e Google Maps.

  • Presença de marketing distinta: o pacote apresenta uma página de marketing de nível superior e atua como o principal ponto de entrada para descobrir apps e produtos. Por exemplo, o 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 em vez de uma coleção solta de ferramentas.
  • Entidade não comprável: não é possível comprar um "pacote" 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 classe em um pacote de produtos. Esses produtos são projetados para serem reconhecidos, comprados e usados como soluções distintas com limites claros.

  • Focado no cliente: o mercado reconhece isso como uma oferta separada. Ele tem uma marca exclusiva e está alinhado às expectativas do cliente.
  • Totalmente funcional: inclui APIs, interfaces do usuário ou clientes exclusivos que fornecem funcionalidades distintas e completas. Exemplos incluem o Compute Engine, o Cloud SQL e o Persistent Disk.
  • Utilitário independente: é possível comprar o produto de forma independente ou usar funcionalmente sem dependências forçadas de outros produtos.
  • Gerenciado por especialistas: uma equipe de produtos designada gerencia todo o ciclo de vida, do lançamento ao encerramento.
  • Com suporte: geralmente inclui opções de suporte dedicadas fornecidas diretamente pelo Google.

Variante de produto lógico

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

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

Recursos e escopo

Para esta 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: a fase de lançamento atual da entidade.

Exclusões

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

Benefícios do Cloud Product Registry

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

  • Fonte única de verdade: é possível eliminar as suposições acessando o registro oficial de todos os Google Cloud títulos, IDs e descrições de produtos.
  • Dados estruturados claros: a API permite navegar pelas relações entre pacotes de produtos de alto nível, produtos lógicos individuais e suas variantes específicas.

Acesso e autenticação

Como a API Cloud Product Registry expõe dados públicos do Google, nenhuma permissão adicional do IAM é necessária no nível do projeto para acessar essa API.

Cotas e limites

Para garantir o acesso justo e a estabilidade do serviço, a API aplica a limitação de taxa baseada em projetos. O sistema rastreia o uso da solicitação em relação ao Google Cloud ID do projeto e aplica limites padrão de consultas por segundo (QPS) limits.

Gerenciamento do ciclo de vida

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

Suspensão de uso

Quando um produto lógico ou variante é descontinuado, o sistema restringe imediatamente novas vendas ou registros. Para oferecer suporte a clientes legados, a entidade permanece visível na API. O sistema a remove permanentemente somente 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 transmitir se uma entidade é substituída por um tipo diferente:
    • Substituído: o campo é definido como verdadeiro 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 recursos a seguir para saber mais sobre como usar o Cloud Product Registry: