Method: subscriptions.insert

Crea o trasferisci una sottoscrizione.

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

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

Se trasferisci un abbonamento a G Suite con un abbonamento a Google Drive o Google Vault associato, utilizza l'operazione in batch per trasferire tutti questi abbonamenti. Per maggiori informazioni, 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ò trattarsi del nome di dominio principale del cliente o dell'identificatore univoco del cliente. Se il nome di dominio di un cliente cambia, non è possibile utilizzare il nome di dominio precedente per accedere al cliente, ma è sempre possibile utilizzare l'identificatore univoco del cliente (restituito dall'API). Ti consigliamo di archiviare l'identificatore univoco nei tuoi sistemi, ove applicabile.

Parametri di query

Parametri
customerAuthToken

string

La stringa di query customerAuthToken è necessaria quando si crea un account del rivenditore che trasferisce l'abbonamento di un cliente diretto o trasferisce l'abbonamento di un altro cliente di un rivenditore alla tua gestione del rivenditore. Si tratta di un token di autenticazione esadecimale necessario per completare il trasferimento dell'abbonamento. Per ulteriori informazioni, consulta 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.