Panoramica dell'API dei rivenditori

Google offre prodotti agli utenti tramite canali di distribuzione come i rivenditori Google Workspace autorizzati. Quando utilizzi l'API Reseller, devi comprendere le relazioni concettuali tra rivenditori, clienti, piani di pagamento, SKU prodotto e licenze.

Rivenditore

Un rivenditore acquista le licenze utente da Google e le rivende ai clienti. Un rivenditore può gestire direttamente gli abbonamenti dei clienti o collaborare con un integratore di servizi per gestire i clienti durante la personalizzazione di più servizi.

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, ma ai rivenditori viene addebitato il numero di licenze ordinate. Per aumentare il numero di licenze, i rivenditori possono utilizzare il metodo subscriptions.changeSeats.
  • Flessibile: ogni volta che un cliente crea un nuovo utente, Google addebita al rivenditore la licenza. Il contratto del rivenditore con Google descrive il prezzo, le specifiche e il numero massimo di licenze.

Oltre a gestire le licenze utente, il rivenditore o i suoi partner integratori di servizi forniscono ai clienti servizi quali formazione, promozioni, pubblicità, prezzi, personalizzazioni dell'implementazione, 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. Solo le licenze attive vengono conteggiate nel numero totale di utenti di un cliente.

Cliente

Un cliente Google inizia con un account Google Workspace configurato dal rivenditore. Quando configura l'account, il rivenditore fornisce un nome di dominio principale, un'email alternativa e un indirizzo fisico. Il rivenditore crea anche un abbonamento per ogni SKU di prodotto disponibile per il cliente. Il cliente ospita ogni account utente. Per saperne di più, vedi Ordinare un nuovo account cliente.

Piani

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

L'API Reseller supporta il sistema di post-pagamento mensile di Google Workspace, che prevede i seguenti piani di pagamento:

  • ANNUAL_MONTHLY_PAY: impegno annuale con pagamenti mensili.
  • ANNUAL_YEARLY_PAY: Impegno annuale con un pagamento annuale.
  • FLEXIBLE: piano senza impegno con pagamenti mensili.
  • TRIAL: Piano di prova senza costi.
    • La durata della prova è variabile fino a 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 saperne di più, vedi Scegliere un piano di pagamento per i clienti.

Abbonamento

Un abbonamento gestisce il rapporto tra il piano di pagamento, lo SKU del prodotto, le licenze utente, lo stato della prova senza costi di 30 giorni e le opzioni di rinnovo di un cliente Google. Un ruolo principale di un rivenditore è gestire questi abbonamenti.

Nell'API Reseller, un abbonamento è 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ù abbonamenti, uno per ogni SKU prodotto assegnato.

Ogni abbonamento ha un identificatore univoco, subscriptionId. Poiché un subscriptionId cambia quando cambia l'abbonamento, non utilizzarlo come chiave per i dati persistenti.

Per saperne di più, consulta Gestire gli abbonamenti.

Prodotti e SKU prodotto

Un prodotto è un'offerta commerciale di servizi e applicazioni Google. Un prodotto può avere versioni personalizzate di termini, prezzi e altri dettagli dell'accordo. Ogni versione è identificata da uno SKU prodotto. L'API Reseller offre abbonamenti per gli SKU nei prodotti Google Workspace, Google Vault e Google Drive. Per ulteriori informazioni, vedi Prodotti e SKU.