Dopo aver ordinato l'account di un cliente, puoi creare diversi abbonamenti:
- 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 queste sottoscrizioni, consulta 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 il messaggio di 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 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 è il nome di dominio principale del cliente o l'identificatore univoco del cliente restituito quando si recupera l'account di un cliente rivenduto.
Creare un piano di impegno annuale
Per gli abbonamenti con impegno annuale, non tutti gli SKU hanno le stesse impostazioni di rinnovo predefinite. Ti consigliamo di passare sempre renewalSettings. Crea
un abbonamento con impegno annuale con 10 licenze:
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 nome del dominio principale del cliente o il suo identificatore univoco.SKU_ID: l'identificatore univoco del codice identificativo dell'articolo (SKU). Per ulteriori informazioni, consulta ID prodotti e SKU.PURCHASE_ORDER_ID: un ID ordine di acquisto facoltativo che puoi utilizzare per monitorare l'utilizzo.
Una risposta positiva 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 relativa 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"
}
Creare un piano flessibile
Per creare un abbonamento flessibile 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
{
"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 nome del dominio principale del cliente o il suo identificatore univoco.SKU_ID: l'identificatore univoco del codice identificativo dell'articolo (SKU). Per ulteriori informazioni, consulta ID prodotti e SKU.PURCHASE_ORDER_ID: un ID ordine di acquisto facoltativo che puoi utilizzare 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"
}
Creare una prova senza costi
Per creare un abbonamento di prova senza costi di 30 giorni 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": "TRIAL"
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 10
},
"purchaseOrderId": "PURCHASE_ORDER_ID"
}
Sostituisci quanto segue:
CUSTOMER_ID: il nome del dominio principale del cliente o il suo identificatore univoco.SKU_ID: l'identificatore univoco del codice identificativo dell'articolo (SKU). Per ulteriori informazioni, consulta ID prodotti e SKU.PURCHASE_ORDER_ID: un ID ordine di acquisto facoltativo che puoi utilizzare per monitorare l'utilizzo.
Di seguito è riportato un esempio di risposta relativa 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"
}
Creare una sottoscrizione con sconto
Google potrebbe fornire un codice sconto per la creazione di abbonamenti a un prezzo scontato. Per applicare uno sconto a un abbonamento, devi fornire il codice promozionale nella chiamata insert dell'abbonamento. Se il cliente cambia lo SKU originale, lo sconto viene rimosso.
Per creare un abbonamento con impegno annuale scontato 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": "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 nome del dominio principale del cliente o il suo identificatore univoco.SKU_ID: l'identificatore univoco del codice identificativo dell'articolo (SKU). Per ulteriori informazioni, consulta ID prodotti e SKU.PURCHASE_ORDER_ID: un ID ordine di acquisto facoltativo che puoi utilizzare per monitorare l'utilizzo.GOOGLE_CONTRACT_DEAL_CODE: un codice sconto disponibile da Google.
Di seguito è riportato un esempio di risposta relativa a un piano annuale scontato:
{
"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 quando crei 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: il nome del dominio principale del cliente o il suo identificatore univoco.TOKEN_VALUE: un token di trasferimento fornito dal cliente. Una volta generato, il token è 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 con un 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: il nome del dominio principale del cliente o il suo identificatore univoco.SKU_ID: l'identificatore univoco del codice identificativo dell'articolo (SKU). Per ulteriori informazioni, consulta ID prodotti e SKU.PURCHASE_ORDER_ID: un ID ordine di acquisto facoltativo che puoi utilizzare per monitorare l'utilizzo.
Una risposta positiva 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 Google Vault associato, utilizza l'operazione batch per trasferire tutti gli abbonamenti con stato ACTIVE. Il trasferimento di ogni abbonamento singolarmente genera un errore.
Il trasferimento degli abbonamenti sospesi è consentito solo se il motivo della sospensione è PENDING_TOS_ACCEPTANCE, TRIAL_ENDED o RENEWAL_WITH_TYPE_CANCEL.
Quando trasferisci uno SKU precedente, subscriptions.list restituisce un skuId
dello SKU che deve essere trasferito. Il skuId dello SKU che il
cliente ha effettivamente viene restituito come transferInfo.currentLegacySkuId. Per un
elenco completo dei skuIds e dei prodotti utilizzati da questi piani, consulta
Prodotti e SKU.
I trasferimenti non funzionano con i codici promozionali.