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 la sezione Prodotti e SKU.

Se non hai ordinato l'account del cliente, puoi trasferire un abbonamento.

I clienti con customerType = 'team' possono acquistare solo le versioni Google Workspace Essentials e Google Workspace Enterprise Essentials di Google Workspace. Se tenti di acquistare altri abbonamenti a Google Workspace, ricevi il seguente 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 utilizzare i piani di impegno annuale e avere opzioni di upgrade e downgrade limitate.

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

Creare un piano di impegno annuale

Per gli abbonamenti con piano con impegno annuale, non tutti gli SKU hanno le stesse impostazioni di rinnovo predefinite. Ti consigliamo di trasmettere 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, vedi ID prodotto e SKU.
  • PURCHASE_ORDER_ID: un ID ordine di acquisto facoltativo che puoi utilizzare per monitorare l'utilizzo.

Una risposta positiva 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 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: 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, vedi 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 di 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 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: 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, vedi 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 con sconto

Google potrebbe fornire un codice offerta per creare abbonamenti a una tariffa scontata. Per scontare un abbonamento, devi fornire il codice promozionale nella chiamata all'abbonamento insert. Se il cliente modifica lo SKU originale, lo sconto viene rimosso.

Per creare un abbonamento con impegno annuale scontato 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: 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, vedi 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 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 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 saperne di più su come i clienti ottengono un token di trasferimento, consulta il Centro assistenza amministratore.

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 nome del dominio principale del cliente o l'identificatore univoco del cliente.
  • SKU_ID: l'identificatore univoco SKU (Stock Keeping Unit). Per ulteriori informazioni, vedi 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 al 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. L'skuId dello SKU effettivamente in possesso del 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.