Dopo aver ordinato l'account di un cliente, puoi creare una serie di abbonamenti diversi:
- Un abbonamento con impegno annuale
- Un abbonamento flessibile
- Una prova senza costi di 30 giorni
- Un abbonamento a prezzo scontato
Per ulteriori informazioni sui prodotti utilizzati in questi abbonamenti, consulta la pagina Prodotti e SKU.
Se non hai ordinato l'account di questo cliente, puoi trasferire un abbonamento.
I clienti con customerType = 'team'
possono acquistare solo le versioni Essentials ed Enterprise Essentials di Google Workspace. Se provi ad acquistare uno degli altri abbonamenti a Google Workspace, viene visualizzato l'errore Customer is not eligible to purchase this subscription
. I clienti che acquistano abbonamenti Essentials o basati sull'utilizzo potrebbero non essere in grado di gestire i piani con impegno annuale e avere opzioni di upgrade e downgrade limitate.
crea una sottoscrizione
Per creare un abbonamento per l'account di un nuovo cliente, utilizza la seguente richiesta HTTP POST
e includi il token di autorizzazione:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
CUSTOMER_ID
è il nome di dominio principale del cliente o l'identificatore univoco del cliente restituito al recupero dell'account di un cliente del rivenditore.
Crea un piano con impegno annuale
Per gli abbonamenti con piano con impegno annuale, non tutti gli SKU hanno le stesse impostazioni di rinnovo predefinite. Ti consigliamo di superare sempre renewalSettings
. Crea
un abbonamento con impegno annuale con 10 utenze:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions { "kind": "reseller#subscription", "customerId": "CUSTOMER_ID", "skuId": "SKU_ID", "plan": { "planName": "ANNUAL_MONTHLY_PAY" }, "seats": { "kind": "subscriptions#seats", "numberOfSeats": 10 }, renewalSettings: { "renewalType": 'RENEW_CURRENT_USERS_MONTHLY_PAY' }, "purchaseOrderId": "PURCHASE_ORDER_ID" }
Sostituisci quanto segue:
CUSTOMER_ID
: nome di dominio principale del cliente o identificatore univoco del cliente.SKU_ID
: l'identificatore univoco dello SKU. Per maggiori informazioni, consulta la pagina Prodotti e ID SKU.PURCHASE_ORDER_ID
: un ID ordine di acquisto facoltativo che puoi usare per monitorare l'utilizzo.
Una risposta riuscita restituisce uno stato HTTP 200
e le impostazioni del nuovo abbonamento per un piano con impegno annuale. ANNUAL_MONTHLY_PAY
viene restituito come
ANNUAL
in tutte le risposte dell'API.
Di seguito è riportato un esempio di risposta a un piano annuale:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"purchaseOrderId": "my_example.com_annual_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"skuName": "Google Workspace Business Standard"
}
Crea un piano flessibile
Per creare un abbonamento flessibile per l'account di un nuovo cliente, utilizza
la seguente richiesta HTTP POST
e includi il token di autorizzazione:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions { "kind": "reseller#subscription", "customerId": "CUSTOMER_ID", "skuId": "SKU_ID", "plan": { "planName": "FLEXIBLE" }, "seats": { "kind": "subscriptions#seats", "maximumNumberOfSeats": 10 }, "purchaseOrderId": "PURCHASE_ORDER_ID" }
Sostituisci quanto segue:
CUSTOMER_ID
: nome di dominio principale del cliente o identificatore univoco del cliente.SKU_ID
: l'identificatore univoco dello SKU. Per maggiori informazioni, consulta la pagina Prodotti e ID SKU.PURCHASE_ORDER_ID
: un ID ordine di acquisto facoltativo che puoi usare per monitorare l'utilizzo.
Di seguito è riportato un esempio di risposta a un piano flessibile:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "FLEXIBLE",
"isCommitmentPlan": false
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 10,
"licensedNumberOfSeats": 0
},
"trialSettings": {
"isInTrial": false
},
"purchaseOrderId": "my_example_flex_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"skuName": "Google Workspace Business Standard"
}
Crea una prova senza costi
Per creare un abbonamento di prova senza costi di 30 giorni per l'account di un nuovo cliente, utilizza la seguente richiesta HTTP POST
e includi il token di autorizzazione:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions { "kind": "reseller#subscription", "customerId": "CUSTOMER_ID", "skuId": "SKU_ID", "plan": { "planName": "TRIAL" }, "seats": { "kind": "subscriptions#seats", "maximumNumberOfSeats": 10 }, "purchaseOrderId": "PURCHASE_ORDER_ID" }
Sostituisci quanto segue:
CUSTOMER_ID
: nome di dominio principale del cliente o identificatore univoco del cliente.SKU_ID
: l'identificatore univoco dello SKU. Per maggiori informazioni, consulta la pagina Prodotti e ID SKU.PURCHASE_ORDER_ID
: un ID ordine di acquisto facoltativo che puoi usare per monitorare l'utilizzo.
Di seguito è riportato un esempio di risposta a un piano di prova senza costi di 30 giorni:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "TRIAL",
"isCommitmentPlan": false
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 10,
"licensedNumberOfSeats": 0
},
"trialSettings": {
"isInTrial": true,
"trialEndTime": "1331648420142"
},
"purchaseOrderId": "my_example_trial_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"skuName": "Google Workspace Business Standard"
}
Crea un abbonamento con sconto
Google potrebbe fornire un codice promozionale per creare abbonamenti a una tariffa scontata. Per scontare un abbonamento, devi fornire il codice deal nella chiamata insert
dell'abbonamento. Se il cliente cambia lo SKU originale, lo sconto viene rimosso.
Per creare un abbonamento con impegno annuale a sconto per l'account di un nuovo cliente, utilizza la seguente richiesta HTTP POST
e includi il token di autorizzazione:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions { "kind": "reseller#subscription", "customerId": "CUSTOMER_ID", "skuId": "SKU_ID", "plan": { "planName": "ANNUAL_MONTHLY_PAY" }, "seats": { "kind": "subscriptions#seats", "numberOfSeats": 10 }, renewalSettings: { "renewalType": 'RENEW_CURRENT_USERS_MONTHLY_PAY' }, "purchaseOrderId": "PURCHASE_ORDER_ID", "dealCode": "GOOGLE_CONTRACT_DEAL_CODE" }
Sostituisci quanto segue:
CUSTOMER_ID
: nome di dominio principale del cliente o identificatore univoco del cliente.SKU_ID
: l'identificatore univoco dello SKU. Per maggiori informazioni, consulta la pagina Prodotti e ID SKU.PURCHASE_ORDER_ID
: un ID ordine di acquisto facoltativo che puoi usare per monitorare l'utilizzo.GOOGLE_CONTRACT_DEAL_CODE
: un codice sconto disponibile da Google.
Di seguito è riportato un esempio di risposta a un piano annuale di sconto:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"purchaseOrderId": "my_example.com_annual_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"dealCode": "GOOGLE_CONTRACT_DEAL_CODE",
"skuName": "Google Workspace Business Standard"
}
Trasferire un abbonamento
Se non hai ordinato l'account del cliente utilizzando l'operazione Ordina un nuovo account cliente, utilizza il token di trasferimento del cliente durante la creazione di un abbonamento per quel cliente.
Per creare un abbonamento per un account cliente che non hai ordinato, utilizza la seguente richiesta HTTP POST
:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions?customerAuthToken=TOKEN_VALUE
Sostituisci quanto segue:
CUSTOMER_ID
: nome di dominio principale del cliente o identificatore univoco del cliente.TOKEN_VALUE
: un token di trasferimento fornito dal cliente. Dopo che il cliente ha generato il token, quest'ultimo è valido per 30 giorni.
Per ulteriori informazioni su come i clienti ricevono un token di trasferimento, consulta il Centro assistenza Google Workspace.
Per trasferire l'abbonamento di un cliente del piano di impegno annuale, utilizza la seguente richiesta HTTP POST
e includi il token di autorizzazione:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions?customerAuthToken=auth token { "customerId": "CUSTOMER_ID", "skuId": "SKU_ID", "plan": { "planName": "ANNUAL_MONTHLY_PAY" }, "seats": { "numberOfSeats": 10, "licensedNumberOfSeats": 10 }, "purchaseOrderId": "PURCHASE_ORDER_ID" }
Sostituisci quanto segue:
CUSTOMER_ID
: nome di dominio principale del cliente o identificatore univoco del cliente.SKU_ID
: l'identificatore univoco dello SKU. Per maggiori informazioni, consulta la pagina Prodotti e ID SKU.PURCHASE_ORDER_ID
: un ID ordine di acquisto facoltativo che puoi usare per monitorare l'utilizzo.
Una risposta corretta restituisce un codice di stato HTTP 200
e le impostazioni dell'abbonamento trasferito per un piano di impegno annuale:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"purchaseOrderId": "example.com_annual_1",
"status": "ACTIVE",
"resourceUiUrl": "URL to customer's Admin console dashboard",
"skuName": "Google Workspace Business Standard"
}
Limitazioni per il trasferimento
Se trasferisci un abbonamento a Google Workspace con un abbonamento a Google Drive o a Google Vault associato, utilizza l'operazione batch
per trasferire tutti gli abbonamenti con lo stato ACTIVE
. Se trasferisci singolarmente ogni abbonamento si verifica un errore.
Il trasferimento di abbonamenti sospesi è consentito solo se il motivo della sospensione è PENDING_TOS_ACCEPTANCE
, TRIAL_ENDED
o RENEWAL_WITH_TYPE_CANCEL
.
Quando si trasferisce uno SKU precedente, subscriptions.list
restituisce un skuId
dello SKU che deve essere trasferito. Il valore skuId
dello SKU
effettivamente restituito dal cliente viene restituito come transferInfo.currentLegacySkuId
. Per un elenco completo di skuIds
e dei prodotti utilizzati da questi piani, consulta la pagina Prodotti e SKU.
I trasferimenti non funzionano con i codici promozionali di sconto.