Creare o trasferire un abbonamento

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

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

Per ulteriori informazioni sui prodotti utilizzati da questi abbonamenti, consulta la pagina 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 provi ad acquistare 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 utilizzare i piani con impegno annuale e avere opzioni di upgrade e downgrade limitate.

Creare un abbonamento

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

Il CUSTOMER_ID è il nome di dominio principale del cliente o l'identificatore univoco del cliente restituito quando recuperi l'account di un cliente rivenduto.

Creare un piano con impegno annuale

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

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 di dominio principale del cliente o l'identificatore univoco del cliente.
  • SKU_ID: l'identificatore univoco del codice identificativo dell'articolo (SKU). Per ulteriori informazioni, consulta la pagina Prodotti e ID SKU.
  • PURCHASE_ORDER_ID: un ID ordine di acquisto facoltativo che puoi utilizzare per monitorare l'utilizzo.

Una risposta riuscita 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 del 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 di dominio principale del cliente o l'identificatore univoco del cliente.
  • SKU_ID: l'identificatore univoco del codice identificativo dell'articolo (SKU). Per ulteriori informazioni, consulta la pagina Prodotti e ID SKU.
  • PURCHASE_ORDER_ID: un ID ordine di acquisto facoltativo che puoi utilizzare per monitorare l'utilizzo.

Di seguito è riportato un esempio di risposta del 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 di dominio principale del cliente o l'identificatore univoco del cliente.
  • SKU_ID: l'identificatore univoco del codice identificativo dell'articolo (SKU). Per ulteriori informazioni, consulta la pagina Prodotti e ID SKU.
  • PURCHASE_ORDER_ID: un ID ordine di acquisto facoltativo che puoi utilizzare per monitorare l'utilizzo.

Di seguito è riportato un esempio di risposta del 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 un abbonamento con sconto

Google potrebbe fornire un codice offerta per la creazione di abbonamenti a un prezzo scontato. Per scontare un abbonamento, devi fornire il codice offerta nella chiamata insert dell'abbonamento. 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 di dominio principale del cliente o l'identificatore univoco del cliente.
  • SKU_ID: l'identificatore univoco del codice identificativo dell'articolo (SKU). Per ulteriori informazioni, consulta la pagina Prodotti e ID 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 del 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 ordine di 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 di dominio principale del cliente o l'identificatore univoco del cliente.
  • TOKEN_VALUE: un token di trasferimento fornito dal cliente. Dopo che il cliente ha generato il token, questo è valido per 30 giorni.

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

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 di dominio principale del cliente o l'identificatore univoco del cliente.
  • SKU_ID: l'identificatore univoco del codice identificativo dell'articolo (SKU). Per ulteriori informazioni, consulta la pagina Prodotti e ID 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 del 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 trasferisci uno SKU legacy, subscriptions.list restituisce un skuId dello SKU da trasferire. 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 la pagina Prodotti e SKU.

I trasferimenti non funzionano con i codici offerta con sconto.