L'API Cloud Product Registry est la source d'informations de référence pour les produits first party Google Cloud . Vous pouvez utiliser cette API pour accéder par programmation à la hiérarchie officielle des Google Cloud outils, ce qui garantit que vos catalogues internes et vos règles de gouvernance reposent sur des données précises, et en temps réel.
Modèle de données
Le registre organise les ressources selon une hiérarchie à trois niveaux : Suites de produits, Produits logiques et Variantes de produits logiques. Cette structure vous aide à comprendre la relation entre les marques de haut niveau et les outils spécifiques, fonctionnels.
Suite de produits
Une suite de produits est une entité organisationnelle de haut niveau, représentant un regroupement unifié de produits qui partagent une marque et un positionnement marketing communs. Elle sert de marque ombrelle pour les outils associés, créant ainsi une famille de solutions unifiée. Par exemple, Google Cloud, Google Workspace et Google Maps.
- Présence marketing distincte : la suite comprend une page marketing de premier niveau et sert de point d’entrée principal pour découvrir les applications et produits associés. Par exemple, Google Workspace ou Google Cloud.
- Regroupement cohérent : la suite apparaît publiquement comme une famille unifiée pour mettre en évidence la relation entre les produits d'un domaine partagé.
- Identité externe : le marché identifie la suite comme un groupe unique plutôt que comme une collection d'outils non structurée.
- Entité non achetable : vous ne pouvez pas acheter directement une "suite". Vous devez acheter ou activer les produits logiques individuels qu'elle contient.
Produit logique
Un produit logique est une offre autonome de premier plan au sein d'une suite de produits. Ces produits sont conçus pour être reconnus, achetés et utilisés comme des solutions distinctes avec des limites claires.
- Axé sur le client : le marché le reconnaît comme une offre distincte. Il porte une marque unique et répond aux attentes des clients.
- Entièrement fonctionnel : il inclut des API, des interfaces utilisateur ou des clients uniques qui offrent une fonctionnalité de bout en bout distincte. Par exemple, Compute Engine, Cloud SQL et Persistent Disk.
- Utilité indépendante : vous pouvez acheter le produit indépendamment ou l'utiliser de manière fonctionnelle sans dépendance forcée à d'autres produits.
- Géré par des experts : une équipe produit dédiée gère l'ensemble du cycle de vie, du lancement à l'arrêt.
- Pris en charge : il inclut souvent des options d'assistance dédiées fournies directement par Google.
Variante de produit logique
Une variante de produit logique est une version spécialisée d'un produit principal. Elle conserve la puissance et les fonctionnalités de base du produit principal, mais est adaptée à une technologie, un cas d'utilisation ou un segment de marché spécifique.
- Basée sur un noyau éprouvé : la variante évolue directement à partir d'un produit principal et partage la même architecture sous-jacente.
- Conçue sur mesure : la variante est adaptée aux besoins spécifiques des clients. Par exemple, Cloud SQL est le produit, tandis que Cloud SQL pour MySQL et Cloud SQL pour PostgreSQL sont les variantes.
Fonctionnalités et portée
Pour cette version, l'API fournit des métadonnées essentielles pour les produits logiques et les variantes de produits logiques, y compris les éléments suivants :
- Nom : nom de ressource de l'entité.
- Titre : nom officiel de l'entité.
- État du cycle de vie : étape de publication actuelle de l'entité.
Exclusions
L'API ne contient que les produits principaux. Google Cloud Elle exclut les produits Google Maps et Google Workspace.
Avantages de Cloud Product Registry
Cloud Product Registry fournit une interface standardisée pour la découverte de produits, ce qui simplifie l'intégration au catalogue Google Cloud .
- Source d'informations unique : vous pouvez éliminer les incertitudes en accédant à l' enregistrement officiel de tous les Google Cloud titres, ID et descriptions de produits.
- Données claires et structurées : l'API vous permet de parcourir les relations entre les suites de produits de haut niveau, les produits logiques individuels et leurs variantes spécifiques.
Accès et authentification
Étant donné que l'API Cloud Product Registry expose des données Google publiques, aucune autorisation IAM supplémentaire n'est requise au niveau du projet pour accéder à cette API.
Quotas et limites
Pour garantir un accès équitable et la stabilité du service, l'API applique une limitation du débit basée sur le projet. Le système suit l'utilisation de vos requêtes par rapport à votre Google Cloud ID de projet et applique les limites standards de requêtes par seconde (RPS) limites.
Gestion du cycle de vie
Google gère le cycle de vie des produits via des processus définis pour l'obsolescence et la restructuration. Comprendre ces événements vous aide à maintenir des intégrations stables et à anticiper les modifications apportées au catalogue.
Obsolescence
Lorsqu'un produit logique ou une variante est obsolète, le système limite immédiatement les nouvelles ventes ou inscriptions. Pour prendre en charge les anciens clients, l' entité reste visible dans l'API. Le système ne la supprime définitivement qu'une fois que tous les contrats associés ont expiré.
Restructuration
La restructuration se produit lorsque la classification d'une entité change en raison de l'expansion de l'entreprise. Cela se produit généralement lorsqu'un produit logique autonome est reclassé en tant que variante de produit logique ou inversement.
- Nom de ressource : le nom de ressource de l'entité change en raison du changement de type.
- Comportement de l'API : toutes les API Get & List incluent des champs de métadonnées supplémentaires pour
indiquer si une entité est remplacée par un autre type :
- Remplacé : le champ est défini sur "true" s'il est restructuré.
- Remplacement : le champ contient le nouveau nom de ressource de cette entité, en raison d'un changement de type.
Étape suivante
Consultez les ressources suivantes pour en savoir plus sur l'utilisation de Cloud Product Registry :
- Découvrez comment lister et obtenir des suites de produits.
- Découvrez comment rechercher des entités à l'aide de noms de ressources.