Dopo ordinare l'account di un cliente, puoi creare varie sottoscrizioni:
- 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 da questi abbonamenti, vedi Prodotti e SKU.
Se non hai ordinato l'account di questo cliente, puoi trasferire un abbonamento.
I clienti con customerType = 'team'
possono acquistare solo Essentials e
Versioni Enterprise Essentials di Google Workspace. Se provi ad acquistare
qualsiasi altro abbonamento a Google Workspace, riceverai
errore: Customer is not eligible to purchase this subscription
. Clienti
l'acquisto di Essentials o di abbonamenti basati sull'utilizzo potrebbe non essere in grado
Piani con impegno annuale e opzioni limitate di upgrade e downgrade.
crea una sottoscrizione
Per creare un abbonamento per l'account di un cliente appena creato, 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
rappresenta
il nome di dominio principale del cliente o l'identificatore univoco del cliente restituito quando
il recupero dell'account di un cliente del rivenditore.
Creare un piano di impegno annuale
Per gli abbonamenti con piano con impegno annuale, non tutti gli SKU hanno lo stesso
impostazioni di rinnovo predefinite. Ti consigliamo di trasmettere 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
: il dominio principale del cliente nome utente o l'identificatore univoco del cliente.SKU_ID
: codice identificativo dell'articolo (SKU) identificativo dell'utente. Per ulteriori informazioni, vedi Prodotti e ID SKU:PURCHASE_ORDER_ID
: un ordine di acquisto facoltativo ID che puoi usare per monitorare l'utilizzo.
Una risposta corretta restituisce uno stato 200
HTTP e il codice
le impostazioni di 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 per 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"
}
Creare un piano flessibile
Per creare un abbonamento flessibile per un account cliente appena creato, 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
: il dominio principale del cliente nome utente o l'identificatore univoco del cliente.SKU_ID
: codice identificativo dell'articolo (SKU) identificativo dell'utente. Per ulteriori informazioni, vedi Prodotti e ID SKU:PURCHASE_ORDER_ID
: un ordine di acquisto facoltativo ID che puoi usare per monitorare l'utilizzo.
Di seguito è riportato un esempio di risposta relativa 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 un cliente appena creato
utilizza la seguente richiesta HTTP POST
e includi l'autorizzazione
token:
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
: il dominio principale del cliente nome utente o l'identificatore univoco del cliente.SKU_ID
: codice identificativo dell'articolo (SKU) identificativo dell'utente. Per ulteriori informazioni, vedi Prodotti e ID SKU:PURCHASE_ORDER_ID
: un ordine di acquisto facoltativo ID che puoi usare per monitorare l'utilizzo.
Di seguito è riportato un esempio di risposta relativa al 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 una sottoscrizione sconto
Google potrebbe fornire un codice promozionale per creare abbonamenti a prezzo scontato
di conversione. Per applicare uno sconto a un abbonamento, devi fornire il codice promozionale in
la chiamata insert
dell'abbonamento. Se il cliente cambia
SKU originale, lo sconto viene rimosso.
Per creare un abbonamento con impegno annuale scontato per un account appena creato
l'account del cliente, utilizza la seguente richiesta HTTP POST
e includi
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
: il dominio principale del cliente nome utente o l'identificatore univoco del cliente.SKU_ID
: codice identificativo dell'articolo (SKU) identificativo dell'utente. Per ulteriori informazioni, vedi Prodotti e ID SKU:PURCHASE_ORDER_ID
: un ordine di acquisto facoltativo ID che puoi usare per monitorare l'utilizzo.GOOGLE_CONTRACT_DEAL_CODE
: un codice sconto disponibile di Google.
Di seguito è riportato un esempio di risposta per un piano annuale con 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 il ordinare un nuovo account cliente usa il token di trasferimento del cliente quando crei un abbonamento per il 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
: il dominio principale del cliente nome utente o l'identificatore univoco del cliente.TOKEN_VALUE
: un token di trasferimento fornito dal tuo al cliente. Una volta generato dal cliente, il token è valido per 30 giorni.
Per ulteriori informazioni su come i clienti ricevono un token di trasferimento, consulta le Centro assistenza Google Workspace.
Per trasferire l'abbonamento di un cliente con piano con 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
: il dominio principale del cliente nome utente o l'identificatore univoco del cliente.SKU_ID
: codice identificativo dell'articolo (SKU) identificativo dell'utente. Per ulteriori informazioni, vedi Prodotti e ID SKU:PURCHASE_ORDER_ID
: un ordine di acquisto facoltativo ID che puoi usare per monitorare l'utilizzo.
Una risposta corretta restituisce uno stato HTTP 200
del codice e le impostazioni dell'abbonamento trasferito per
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 i trasferimenti
Se trasferisci un abbonamento a Google Workspace con un Google Drive associato
o a Google Vault, utilizza
Operazione batch
per trasferire tutti gli abbonamenti con stato ACTIVE
. Trasferimento di ogni
un abbonamento alla volta causa un errore.
Il trasferimento di abbonamenti sospesi è consentito solo se il motivo della sospensione è
PENDING_TOS_ACCEPTANCE
, TRIAL_ENDED
o RENEWAL_WITH_TYPE_CANCEL
.
Durante il trasferimento di uno SKU precedente, subscriptions.list
restituisce un skuId
dello SKU che deve essere trasferito. Il valore skuId
dello SKU che
in realtà viene restituito come transferInfo.currentLegacySkuId
. Per un
un elenco completo di skuIds
e i prodotti utilizzati da questi piani; consulta
Prodotti e SKU.
I trasferimenti non funzionano con i codici promozionali di sconto.