Creare o trasferire un abbonamento

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.