Panoramica dell'API dei rivenditori

Uno dei modi in cui Google offre servizi dei prodotti Google agli utenti è attraverso canali di distribuzione di servizi, come i rivenditori autorizzati di Google Workspace. Quando si utilizza l'API dei rivenditori, è importante comprendere le relazioni concettuali tra i rivenditori e i clienti, i piani di pagamento, gli SKU dei prodotti e le licenze.

Rivenditore

Un rivenditore acquista licenze utente da Google e rivende queste licenze ai clienti di Google. Un rivenditore può gestire direttamente gli abbonamenti dei clienti oppure, se personalizzando più servizi, può collaborare con un integratore di servizi per gestire i clienti.

I rivenditori possono scegliere tra i seguenti piani:

  • impegno annuale: il rivenditore acquista un numero fisso di licenze da Google per un anno. I clienti possono creare fino al numero di licenze ordinate, ma ai rivenditori viene addebitato il numero di licenze ordinate. Se i clienti hanno bisogno di licenze aggiuntive, i rivenditori possono utilizzare la chiamata API subscriptions.changeSeats per aumentare il numero di licenze ordinate.
  • flessibile: ogni volta che un cliente crea un nuovo utente, Google addebita al rivenditore questa licenza. Il contratto tra il rivenditore e Google descrive il prezzo, le specifiche e il numero massimo di licenze.

Oltre alla gestione delle licenze utente, il rivenditore (o i suoi integratori di servizi partner) forniscono ai clienti una vasta gamma di servizi aggiuntivi come formazione, promozioni, pubblicità, prezzi, personalizzazioni dei deployment, risoluzione dei problemi e manutenzione.

Licenze

Una licenza consente a un utente con un Account Google di accedere ai servizi Google Workspace. Quando un cliente assegna una licenza a un utente, questa diventa una licenza attiva. Nel calcolo del numero totale di utenti di un cliente vengono conteggiate solo le licenze attive.

Cliente

Un cliente Google inizia con un account Google Workspace configurato dal rivenditore. Durante la configurazione dell'account del cliente, il rivenditore fornisce un nome di dominio principale, un indirizzo email alternativo e un indirizzo fisico. Quindi, il rivenditore crea anche un abbonamento per ogni SKU di prodotto a disposizione del cliente. Il cliente ospita ogni singolo account utente. Per maggiori informazioni, consulta la pagina Ordinare un nuovo account cliente.

Piani

Un piano definisce i termini di fatturazione di un rivenditore con Google. Questi piani non definiscono la relazione di fatturazione tra un rivenditore e i suoi clienti. I rivenditori definiscono i propri termini di fatturazione con i propri clienti.

L'API Reseller supporta il sistema di pagamento posticipato mensile di Google Workspace, che ha diversi piani di pagamento disponibili:

  • ANNUAL_MONTHLY_PAY: impegno annuale con pagamenti mensili
  • ANNUAL_YEARLY_PAY: impegno annuale con un pagamento annuale
  • FLEXIBLE: piano non basato su impegno con pagamenti mensili
  • TRIAL: piano di prova senza costi
    • La durata del periodo di prova è variabile fino a un massimo di 30 giorni.
    • Limite di invio giornaliero di Gmail di 500 messaggi per utente.
  • FREE: piano senza costi solo per gli abbonamenti a Cloud Identity Free Edition

Per ulteriori informazioni su questi piani, consulta l'articolo Scegliere un piano di pagamento per i clienti.

Abbonamento

Un abbonamento gestisce la relazione tra il piano di pagamento di un cliente Google e lo SKU di un prodotto, le licenze utente, lo stato della prova senza costi di 30 giorni e le opzioni di rinnovo. Uno dei ruoli principali di un rivenditore è la gestione degli abbonamenti del cliente Google.

Nell'API dei rivenditori, una sottoscrizione è una risorsa API principale. Definisce le impostazioni per un piano di pagamento, le licenze, la prova senza costi di 30 giorni, il rinnovo e l'ordine di acquisto di un rivenditore. Un cliente può avere più di un abbonamento, uno per ogni SKU di prodotto assegnato dal rivenditore al cliente.

Ogni abbonamento ha un identificatore univoco, ovvero subscriptionId. Poiché un subscriptionId cambia quando cambia la sottoscrizione, non utilizzare un valore subscriptionId come chiave per i dati permanenti. Questa chiave non funzionerà se l'abbonamento cambia.

Per saperne di più, vedi Gestire gli abbonamenti.

Prodotti e SKU di prodotto

Un prodotto è un'offerta commerciale di un insieme specializzato di funzionalità e servizi Google. Un prodotto può avere versioni personalizzate di termini, prezzi e altri dettagli del contratto. Ognuna di queste versioni del prodotto è identificata da uno SKU di prodotto. In questa versione, l'API dei rivenditori offre un abbonamento per ogni SKU nei prodotti Google Workspace, Google Vault e Google Drive. Per maggiori informazioni, consulta la pagina Prodotti e SKU.