Tipi di rivenditori
Il provisioning del tuo account è stato eseguito come rivenditore diretto (1 livello) o come distributore (2 livelli). Puoi verificare il tipo di account nella pagina Impostazioni della Partner Sales Console. I rivenditori diretti vengono visualizzati come
RESELLER, mentre i distributori come DISTRIBUTOR.
Concetti generali di Channel Services
Figura 1. Diagramma della relazione tra i concetti di Channel Services presentati in questo documento.
Account
Un account è l'entità di primo livello e viene mappato al tuo
dominio rivenditore. Tutte le altre risorse sono basate su questa risorsa.
Per effettuare chiamate all'API Cloud Channel, dovrai disporre del tuo account_id, disponibile nella pagina Impostazioni della Partner Sales Console.
Clienti
I clienti, in genere un'azienda, sono gli utenti finali dei prodotti Google Cloud per i quali effettui ordini. In una gerarchia del canale di rivendita a più livelli, i clienti sono i nodi foglia.
Diritti
I diritti rappresentano i servizi che ti vengono fatturati, ma utilizzati da uno dei tuoi clienti.
Per un'offerta SaaS come Google Workspace, un diritto corrisponderebbe a un abbonamento a uno dei servizi (ad es. Google Workspace Business Starter o Cloud Identity Premium).
Per un'offerta IaaS come Google Cloud Platform, un diritto è un account di fatturazione basato sul consumo che i clienti possono utilizzare per i propri progetti.
Offerte
Le offerte rappresentano ciò che puoi vendere. Un'offerta e un cliente sono i componenti principali di un diritto.
Le offerte sono una combinazione di uno SKU e di un modello di prezzi. Ad esempio, un singolo prodotto con vari piani di pagamento o livelli di sconto avrà tante offerte quante sono le permutazioni del prodotto e dei piani o degli sconti.
Per Google Workspace, le offerte non modificano il prezzo. Quando i prezzi cambiano, vengono generati nuovi offerId.
Dominio del rivenditore
Un dominio rivenditore è un'istanza di Google Workspace in cui puoi gestire i privilegi di accesso alla Partner Sales Console.
Link ai partner di canale
I link ai partner di canale sono applicabili solo ai distributori.
I link ai partner di canale rappresentano il collegamento tra un distributore e i suoi rivenditori indiretti autorizzati. I distributori sono tenuti a registrare i propri partner di canale su Google.
Contatta il tuo Partner Manager per ulteriori dettagli su questa procedura.
Concetti specifici dell'API
Identità cloud
Un'identità cloud è l'impronta per i clienti di Google Workspace e Chrome e l'insieme di funzionalità di base per i clienti, incluso l'accesso ad admin.google.com e alla gestione degli utenti.
Devi eseguire il provisioning di un'identità cloud con dati specifici di Google Workspace prima di creare un diritto per un prodotto Google Workspace o Chrome.
Operazioni
Le operazioni sono chiamate anche operazioni a lunga esecuzione (LRO). Vengono utilizzati nell'intera API Cloud Channel, poiché molte azioni attivate dalle chiamate API non sono istantanee e possono richiedere più tempo rispetto ai timeout del client predefiniti.
Le operazioni sono chiamate API asincrone. Gli endpoint che utilizzano le operazioni
potrebbero restituire errori HTTP 4xx (a causa della convalida sincrona) o un
codice HTTP 200 con una risorsa Operation e l'identificatore dell'operazione.
Per ottenere lo stato di un'operazione, utilizza il metodo operations.get.