Method: subscriptions.insert

Crea o trasferisce un abbonamento.

Crea un abbonamento per l'account di un cliente che hai ordinato utilizzando il metodo Ordinare un nuovo account cliente. Per ulteriori informazioni sulla creazione di un abbonamento per diversi piani di pagamento, consulta Gestire gli abbonamenti.\

Se non hai ordinato l'account del cliente utilizzando il metodo di inserimento del cliente, utilizza il customerAuthToken del cliente quando crei un abbonamento per il cliente.

Se trasferisci un abbonamento a G Suite con un abbonamento a Google Drive o Google Vault associato, utilizza l'operazione collettiva per trasferire tutti questi abbonamenti. Per saperne di più, scopri come trasferire gli abbonamenti.

Richiesta HTTP

POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

Può essere il nome di dominio principale del cliente o il suo identificatore univoco. Se il nome di dominio di un cliente cambia, il vecchio nome di dominio non può essere utilizzato per accedere al cliente, ma è sempre possibile utilizzare l'identificatore univoco del cliente (come restituito dall'API). Ti consigliamo di memorizzare l'identificatore univoco nei tuoi sistemi, se applicabile.

Parametri di query

Parametri
customerAuthToken

string

La stringa di query customerAuthToken è obbligatoria quando crei un account rivenduto che trasferisce l'abbonamento di un cliente diretto o l'abbonamento di un altro cliente del rivenditore alla tua gestione del rivenditore. Si tratta di un token di autenticazione esadecimale necessario per completare il trasferimento dell'abbonamento. Per ulteriori informazioni, visita il Centro assistenza per gli amministratori.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di Subscription.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Subscription appena creata.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/apps.order

Per ulteriori informazioni, consulta la Guida all'autorizzazione.