Method: subscriptions.insert
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[],[],null,["# Method: subscriptions.insert\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates or transfer a subscription.\n\nCreate a subscription for a customer's account that you ordered using the [Order a new customer account](/workspace/admin/reseller/v1/reference/customers/insert) method. For more information about creating a subscription for different payment plans, see [manage subscriptions](/workspace/admin/reseller/v1/how-tos/manage_subscriptions#create_subscription).\\\\\n\nIf you did not order the customer's account using the customer insert method, use the customer's `customerAuthToken` when creating a subscription for that customer.\n\nIf transferring a G Suite subscription with an associated Google Drive or Google Vault subscription, use the [batch operation](/workspace/admin/reseller/v1/how-tos/batch) to transfer all of these subscriptions. For more information, see how to [transfer subscriptions](/workspace/admin/reseller/v1/how-tos/manage_subscriptions#transfer_a_subscription).\n\n### HTTP request\n\n`POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customerId` | `string` This can be either the customer's primary domain name or the customer's unique identifier. If the domain name for a customer changes, the old domain name cannot be used to access the customer, but the customer's unique identifier (as returned by the API) can always be used. We recommend storing the unique identifier in your systems where applicable. |\n\n### Query parameters\n\n| Parameters ||\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customerAuthToken` | `string` The `customerAuthToken` query string is required when creating a resold account that transfers a direct customer's subscription or transfers another reseller customer's subscription to your reseller management. This is a hexadecimal authentication token needed to complete the subscription transfer. For more information, see the [administrator help center](//support.google.com/a/bin/answer.py?answer=142336). |\n\n### Request body\n\nThe request body contains an instance of [Subscription](/workspace/admin/reseller/reference/rest/v1/subscriptions#Subscription).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Subscription](/workspace/admin/reseller/reference/rest/v1/subscriptions#Subscription).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/apps.order`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
