L'API Cloud Product Registry funge da fonte autorevole di informazioni per i prodotti proprietari Google Cloud . Puoi utilizzare questa API per accedere in modo programmatico alla gerarchia ufficiale degli Google Cloud strumenti, assicurandoti che i tuoi cataloghi interni e le tue norme di governance si basino su dati accurati e in tempo reale.
Modello dei dati
Il registro organizza le risorse in una gerarchia a tre livelli: Suite di prodotti, Prodotti logici e Varianti di prodotti logici. Questa struttura ti aiuta a navigare nella relazione tra brand di alto livello e strumenti specifici, funzionali.
Suite di prodotti
Una suite di prodotti è un'entità organizzativa di alto livello che rappresenta un raggruppamento unificato di prodotti che condividono un brand e un posizionamento di mercato comuni. Funge da brand ombrello che ospita strumenti correlati, creando una famiglia unificata di soluzioni. Ad esempio, Google CloudGoogle Workspace e Google Maps.
- Presenza di marketing distinta: la suite include una pagina di marketing di primo livello e funge da punto di accesso principale per scoprire app e prodotti correlati. Ad esempio, Google Workspace o Google Cloud.
- Raggruppamento coeso: la suite viene visualizzata pubblicamente come una famiglia unificata per evidenziare la relazione tra i prodotti in un dominio condiviso.
- Identità esterna: il mercato identifica la suite come un singolo gruppo anziché una raccolta di strumenti non correlati.
- Entità non acquistabile: non puoi acquistare direttamente una "suite". Puoi invece acquistare o attivare i singoli prodotti logici contenuti al suo interno.
Prodotto logico
Un prodotto logico è un'offerta autonoma di primo piano all'interno di una suite di prodotti. Questi prodotti sono progettati per essere riconosciuti, acquistati e utilizzati come soluzioni distinte con limiti chiari.
- Centrato sul cliente: il mercato lo riconosce come un'offerta separata. Ha un brand unico ed è in linea con le aspettative dei clienti.
- Completamente funzionale: include API, interfacce utente o client unici che forniscono funzionalità distinte end-to-end. Esempi: Compute Engine, Cloud SQL e Persistent Disk.
- Utilità indipendente: puoi acquistare il prodotto in modo indipendente o utilizzare il prodotto in modo funzionale senza dipendenze forzate da altri prodotti.
- Gestito da esperti: un team di prodotto dedicato gestisce l'intero ciclo di vita, dal lancio al ritiro.
- Supportato: spesso include opzioni di assistenza dedicate fornite direttamente da Google.
Variante di prodotto logico
Una variante di prodotto logico è una versione specializzata di un prodotto principale. Mantiene la potenza e la funzionalità di base del prodotto principale, ma è ottimizzata per una tecnologia, un caso d'uso o un segmento di mercato specifico.
- Basata su un core collaudato: la variante si evolve direttamente da un prodotto principale e condivide la stessa architettura sottostante.
- Progettata appositamente: la variante è personalizzata per soddisfare esigenze specifiche dei clienti. Ad esempio, Cloud SQL è il prodotto, mentre Cloud SQL per MySQL e Cloud SQL per PostgreSQL sono le varianti.
Funzionalità e ambito
Per questa release, l'API fornisce metadati essenziali per i prodotti logici e le varianti di prodotti logici, tra cui:
- Nome: il nome della risorsa dell'entità.
- Titolo: il nome ufficiale dell'entità.
- Stato del ciclo di vita: la fase di release corrente dell'entità.
Esclusioni
L'API contiene solo i prodotti principali. Google Cloud Esclude i prodotti Google Maps e Google Workspace.
Vantaggi di Cloud Product Registry
Cloud Product Registry fornisce un'interfaccia standardizzata per la scoperta dei prodotti, semplificando l'integrazione con il catalogo Google Cloud .
- Unica fonte di informazioni: puoi eliminare le congetture accedendo al record ufficiale per tutti i Google Cloud titoli, gli ID e le descrizioni dei prodotti.
- Dati chiari e strutturati: l'API ti consente di navigare nelle relazioni tra le suite di prodotti di alto livello, i singoli prodotti logici e le relative varianti specifiche.
Accesso e autenticazione
Poiché l'API Cloud Product Registry espone i dati pubblici di Google, non sono necessarie autorizzazioni IAM aggiuntive a livello di progetto per accedere a questa API.
Quote e limiti
Per garantire un accesso equo e la stabilità del servizio, l'API applica limitazione di frequenza basata sul progetto. Il sistema tiene traccia dell'utilizzo delle richieste rispetto all' Google Cloud ID progetto e applica i limiti standard di query al secondo (QPS) .
Gestione del ciclo di vita
Google gestisce il ciclo di vita dei prodotti tramite processi definiti per il ritiro e la ristrutturazione. Comprendere questi eventi ti aiuta a mantenere integrazioni stabili e ad anticipare le modifiche al catalogo.
Ritiro
Quando un prodotto logico o una variante viene ritirato, il sistema ne limita immediatamente le nuove vendite o registrazioni. Per supportare i clienti legacy, l' entità rimane visibile nell'API. Il sistema la rimuove definitivamente solo dopo la scadenza di tutti i contratti associati.
Ristrutturazione
La ristrutturazione si verifica quando la classificazione di un'entità cambia a causa dell'espansione dell'attività. In genere, questo accade quando un prodotto logico autonomo viene riclassificato come variante di prodotto logico o viceversa.
- Nome risorsa: il nome della risorsa dell'entità cambia a causa della modifica del tipo.
- Comportamento dell'API: tutte le API Get & List includono campi di metadati aggiuntivi per
indicare se un'entità viene sostituita con un tipo diverso:
- Replaced: il campo è impostato su true se viene ristrutturato.
- Replacement: il campo contiene il nuovo nome della risorsa di questa entità, a causa di una modifica del tipo.
Passaggi successivi
Esplora le seguenti risorse per scoprire di più sull'utilizzo di Cloud Product Registry:
- Scopri come elencare e ottenere le suite di prodotti
- Scopri come cercare le entità utilizzando i nomi delle risorse