Creare o trasferire un abbonamento

Dopo aver ordinato l'account di un cliente, puoi creare una serie di abbonamenti diversi:

  • Un abbonamento con impegno annuale
  • Un abbonamento flessibile
  • Prova senza costi di 30 giorni
  • Un abbonamento con sconto

Per ulteriori informazioni sui prodotti utilizzati da questi abbonamenti, 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 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 hanno opzioni di upgrade e downgrade limitate.

Creare 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 durante il recupero dell'account di un cliente rivenduto.

Creare un piano di impegno annuale

Per gli abbonamenti con piano di 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 posti:

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 l'identificatore univoco del cliente.
  • SKU_ID: l'identificatore univoco SKU (Stock Keeping Unit). Per ulteriori informazioni, consulta ID prodotto e SKU.
  • PURCHASE_ORDER_ID: Un ID ordine di acquisto facoltativo che puoi utilizzare per monitorare l'utilizzo.

Una risposta riuscita restituisce lo 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 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 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 l'identificatore univoco del cliente.
  • SKU_ID: l'identificatore univoco SKU (Stock Keeping Unit). Per ulteriori informazioni, consulta ID prodotto 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 per 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 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": "TRIAL"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

Sostituisci quanto segue:

  • CUSTOMER_ID: il nome del dominio principale del cliente o l'identificatore univoco del cliente.
  • SKU_ID: l'identificatore univoco SKU (Stock Keeping Unit). Per ulteriori informazioni, consulta ID prodotto 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 per 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 scontato

Google potrebbe fornire un codice offerta per creare abbonamenti a una tariffa scontata. Per scontare 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 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": "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 l'identificatore univoco del cliente.
  • SKU_ID: l'identificatore univoco SKU (Stock Keeping Unit). Per ulteriori informazioni, consulta ID prodotto 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 su Google.

Di seguito è riportato un esempio di risposta per 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 questo 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 l'identificatore univoco del cliente.
  • TOKEN_VALUE: Un token di trasferimento fornito dal tuo cliente. Una volta generato, il token è valido per 30 giorni.

Per ulteriori informazioni su come i clienti ottengono un token di trasferimento, consulta il Centro assistenza Google Workspace.

Per trasferire l'abbonamento di un cliente con 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 l'identificatore univoco del cliente.
  • SKU_ID: l'identificatore univoco SKU (Stock Keeping Unit). Per ulteriori informazioni, consulta ID prodotto e SKU.
  • PURCHASE_ORDER_ID: Un ID ordine di acquisto facoltativo che puoi utilizzare per monitorare l'utilizzo.

Una risposta riuscita restituisce un codice di stato HTTP 200 e le impostazioni dell'abbonamento trasferito per un piano con 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 uno alla volta 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 viene trasferito uno SKU legacy, subscriptions.list restituisce un skuId dello SKU da trasferire. Il skuIddello SKU effettivamente posseduto dal cliente viene restituito come transferInfo.currentLegacySkuId. Per un elenco completo di skuIds e dei prodotti utilizzati da questi piani, consulta Prodotti e SKU.

I trasferimenti non funzionano con i codici delle offerte scontate.