L'API Cloud Product Registry funge da fonte di riferimento autorevole 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 prodotto logiche. Questa struttura ti aiuta a orientarti nella relazione tra brand di alto livello e strumenti specifici e 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. che funge da brand ombrello che ospita strumenti correlati, creando una famiglia unificata di soluzioni. Ad esempio, Google Cloud, Google 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 mettere in evidenza la relazione tra i prodotti in un dominio condiviso.
- Identità esterna: il mercato identifica la suite come un unico gruppo anziché come una raccolta di strumenti.
- Entità non acquistabile: non puoi acquistare una "suite" direttamente. Acquisti o attivi i singoli prodotti logici contenuti al suo interno.
Prodotto logico
Un prodotto logico è un'offerta autonoma di primo livello all'interno di una suite di prodotti. Questi prodotti sono progettati per essere riconosciuti, acquistati e utilizzati come soluzioni distinte con limiti chiari.
- Incentrato sul cliente: il mercato lo riconosce come un'offerta separata. Ha un brand unico e si allinea alle aspettative dei clienti.
- Completamente funzionale: include API, interfacce utente o client unici che forniscono funzionalità distinte e end-to-end. Gli esempi includono Compute Engine, Cloud SQL e Persistent Disk.
- Utilità indipendente: puoi acquistare il prodotto in modo indipendente o utilizzarlo in modo funzionale senza dipendenze forzate da altri prodotti.
- Gestione esperta: un team di prodotto designato gestisce l'intero ciclo di vita, dal lancio al ritiro.
- Supportato: spesso include opzioni di assistenza dedicate fornite direttamente da Google.
Variante prodotto logica
Una variante logica del prodotto è una versione specializzata di un prodotto principale. Mantiene la potenza e la funzionalità di base del prodotto principale, ma è ottimizzato per una tecnologia, un caso d'uso o un segmento di mercato specifici.
- Basata su un core comprovato: la variante si evolve direttamente da un prodotto principale e condivide la stessa architettura sottostante.
- Realizzata appositamente: la variante è personalizzata per soddisfare esigenze specifiche dei clienti. Ad esempio, Cloud SQL è il prodotto; 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 prodotto logiche, tra cui:
- Nome: il nome della risorsa dell'entità.
- Titolo: il nome ufficiale dell'entità.
- Stato del ciclo di vita: la fase di rilascio corrente dell'entità.
Esclusioni
L'API contiene solo prodotti Google Cloud di base. Sono esclusi Google Maps e i prodotti Google Workspace.
Vantaggi del registro dei prodotti cloud
Cloud Product Registry fornisce un'interfaccia standardizzata per l'individuazione dei prodotti, semplificando l'integrazione con il catalogo Google Cloud .
- Unica fonte attendibile: puoi eliminare le congetture accedendo al record ufficiale di tutti i titoli, gli ID e le descrizioni dei prodotti Google Cloud .
- Dati strutturati e chiari: l'API ti consente di navigare tra le relazioni tra le suite di prodotti di alto livello, i singoli prodotti logici e le loro varianti specifiche.
Accesso e autenticazione
Poiché l'API Cloud Product Registry espone 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 la limitazione di frequenza basata sul progetto. Il sistema tiene traccia dell'utilizzo delle richieste rispetto al tuo Google Cloud ID progetto e applica limiti standard di query al secondo (QPS).
Gestione del ciclo di vita
Google gestisce il ciclo di vita dei prodotti attraverso processi definiti per il ritiro e la ristrutturazione. Comprendere questi eventi ti aiuta a mantenere integrazioni stabili e 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 lo 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à. Ciò accade spesso 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
comunicare se un'entità viene sostituita con un tipo diverso:
- Sostituito: il campo è impostato su true se è stato ristrutturato.
- Sostituzione: il campo contiene il nuovo nome della risorsa di questa entità, a causa di una modifica del tipo.
Passaggi successivi
Consulta le seguenti risorse per scoprire di più sull'utilizzo del registro dei prodotti cloud:
- Scopri come elencare e ottenere le suite di prodotti
- Scopri come cercare entità utilizzando i nomi delle risorse