Die Cloud Product Registry API dient als maßgebliche Quelle für Informationen zu Produkten von Google Google Cloud . Mit dieser API können Sie programmatisch auf die offizielle Hierarchie von Google Cloud Tools zugreifen, sodass Ihre internen Kataloge und Governance-Richtlinien auf genauen Echtzeitdaten basieren.
Datenmodell
In der Registry werden Ressourcen in einer dreistufigen Hierarchie organisiert: Produkt Suites, logische Produkte und logische Produktvarianten. Diese Struktur hilft Ihnen, die Beziehung zwischen Marken auf hoher Ebene und spezifischen, funktionalen Tools zu verstehen.
Produkt-Suite
Eine Produkt-Suite ist eine Organisationseinheit auf hoher Ebene, die eine einheitliche Gruppierung von Produkten darstellt, die eine gemeinsame Marke und Marktpositionierung haben. Sie fungiert als Dachmarke für zugehörige Tools und schafft eine einheitliche Familie von Lösungen. Beispiele sind Google Cloud, Google Workspace und Google Maps.
- Eigene Marketingpräsenz: Die Suite hat eine Marketingseite auf höchster Ebene und dient als primärer Einstiegspunkt für die Suche nach zugehörigen Apps und Produkten. Beispiele sind Google Workspace oder Google Cloud.
- Einheitliche Gruppierung: Die Suite wird öffentlich als einheitliche Familie dargestellt, um die Beziehung zwischen Produkten in einer gemeinsamen Domain hervorzuheben.
- Externe Identität: Der Markt identifiziert die Suite als eine einzelne Gruppe und nicht als lose Sammlung von Tools.
- Nicht käufliche Entität: Sie können keine Suite direkt kaufen. Stattdessen kaufen oder aktivieren Sie die einzelnen logischen Produkte, die darin enthalten sind.
Logisches Produkt
Ein logisches Produkt ist ein erstklassiges, eigenständiges Angebot innerhalb einer Produkt-Suite. Diese Produkte sind so konzipiert, dass sie als eigenständige Lösungen mit klaren Grenzen erkannt, gekauft und verwendet werden können.
- Kundenorientiert: Der Markt erkennt dies als separates Angebot. Es hat eine einzigartige Marke und entspricht den Erwartungen der Kunden.
- Voll funktionsfähig: Es enthält einzigartige APIs, Benutzeroberflächen oder Clients die eine eigenständige End-to-End-Funktionalität bieten. Beispiele sind Compute Engine, Cloud SQL und Persistent Disk.
- Unabhängiges Dienstprogramm: Sie können das Produkt unabhängig kaufen oder es funktional verwenden, ohne dass Abhängigkeiten von anderen Produkten bestehen.
- Professionell verwaltet: Ein bestimmtes Produktteam verwaltet den gesamten Lebenszyklus, von der Einführung bis zur Einstellung.
- Unterstützt: Oft sind spezielle Supportoptionen enthalten, die direkt von Google bereitgestellt werden.
Logische Produktvariante
Eine logische Produktvariante ist eine spezielle Version eines primären Produkts. Sie behält die Kernleistung und -funktionalität des Hauptprodukts bei, ist aber auf eine bestimmte Technologie, einen bestimmten Anwendungsfall oder ein bestimmtes Marktsegment zugeschnitten.
- Auf einem bewährten Kern aufgebaut: Die Variante wird direkt aus einem primären Produkt entwickelt und hat dieselbe zugrunde liegende Architektur.
- Speziell entwickelt: Die Variante ist auf die spezifischen Bedürfnisse der Kunden zugeschnitten. Beispiel: Cloud SQL ist das Produkt, Cloud SQL for MySQL und Cloud SQL for PostgreSQL sind die Varianten.
Funktionen und Umfang
Für diese Version bietet die API wichtige Metadaten für logische Produkte und logische Produktvarianten, darunter:
- Name: Ressourcenname der Entität.
- Titel: Offizieller Name der Entität.
- Lebenszyklusstatus: Die aktuelle Release-Phase der Entität.
Ausschlüsse
Die API enthält nur Kern Google Cloud produkte. Google Maps- und Google Workspace-Produkte sind ausgeschlossen.
Vorteile der Cloud Product Registry
Die Cloud Product Registry bietet eine standardisierte Schnittstelle für die Produkt suche und vereinfacht so die Integration in den Google Cloud Katalog.
- Einzige Quelle der Wahrheit: Sie können Vermutungen vermeiden, indem Sie auf den offiziellen Eintrag für alle Google Cloud Produkttitel, IDs und Beschreibungen zugreifen.
- Klare, strukturierte Daten: Mit der API können Sie die Beziehungen zwischen Produkt-Suites auf hoher Ebene, einzelnen logischen Produkten und ihren spezifischen Varianten nachvollziehen.
Zugriff und Authentifizierung
Da die Cloud Product Registry API öffentliche Google-Daten bereitstellt, sind auf Projektebene keine zusätzlichen IAM-Berechtigungen für den Zugriff auf diese API erforderlich.
Kontingente und Limits
Um einen fairen Zugriff und die Stabilität des Dienstes zu gewährleisten, wendet die API projektbasierte Ratenbegrenzungen an. Das System verfolgt die Nutzung Ihrer Anfragen anhand Ihrer Google Cloud Projekt-ID und erzwingt standardmäßige Limits für Abfragen pro Sekunde (Queries Per Second, QPS)
Verwaltung des Lebenszyklus
Google verwaltet den Lebenszyklus von Produkten durch definierte Prozesse für die Einstellung und Umstrukturierung. Wenn Sie diese Ereignisse kennen, können Sie stabile Integrationen aufrechterhalten und Änderungen am Katalog vorhersehen.
Einstellung
Wenn ein logisches Produkt oder eine Variante eingestellt wird, wird es sofort für neue Verkäufe oder Registrierungen gesperrt. Um Bestandskunden zu unterstützen, bleibt die Entität in der API sichtbar. Das System entfernt sie erst dauerhaft, wenn alle zugehörigen Verträge abgelaufen sind.
Umstrukturierung
Eine Umstrukturierung erfolgt, wenn sich die Klassifizierung einer Entität aufgrund einer Geschäftserweiterung ändert. Dies geschieht häufig, wenn ein eigenständiges logisches Produkt als logische Produktvariante neu klassifiziert wird oder umgekehrt.
- Ressourcenname: Der Ressourcenname der Entität ändert sich aufgrund der Typänderung.
- API-Verhalten: Alle Get- und List-APIs enthalten zusätzliche Metadatenfelder, um anzugeben, ob eine Entität durch einen anderen Typ ersetzt wird:
- Ersetzt: Das Feld ist auf „true“ gesetzt, wenn es umstrukturiert wird.
- Ersatz: Das Feld enthält den neuen Ressourcennamen dieser Entität aufgrund einer Typänderung.
Nächste Schritte
In den folgenden Ressourcen erfahren Sie mehr über die Verwendung der Cloud Product Registry: