Tworzenie i przenoszenie subskrypcji

Po zamówieniu konta klienta możesz utworzyć kilka różnych subskrypcji:

  • subskrypcja z zobowiązaniem rocznym,
  • elastyczny abonament,
  • 30-dniowy bezpłatny okres próbny
  • subskrypcję z rabatem,

Więcej informacji o usługach, z których korzystają te subskrypcje, znajdziesz w artykule Usługi i identyfikatory SKU.

Jeśli nie zamawiasz konta tego klienta, możesz przenieść subskrypcję.

Klienci z customerType = 'team' mogą kupić tylko wersje Essentials i Enterprise Essentials Google Workspace. Jeśli spróbujesz kupić którąkolwiek z pozostałych subskrypcji Google Workspace, pojawi się błąd Customer is not eligible to purchase this subscription. Klienci kupujący subskrypcje Essentials lub subskrypcje oparte na wykorzystaniu mogą nie być w stanie obsługiwać planów z rocznym zobowiązaniem i mają ograniczone opcje przejścia na wyższą lub niższą wersję.

Tworzenie subskrypcji

Aby utworzyć subskrypcję na nowo utworzonym koncie klienta, użyj tego żądania HTTP POST i dołącz token autoryzacji:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions

Wartość CUSTOMER_ID to nazwa domeny podstawowej klienta lub jego unikalny identyfikator zwracany podczas pobierania konta klienta, któremu sprzedano usługę.

Tworzenie rocznego planu zobowiązań

W przypadku subskrypcji z rocznym zobowiązaniem nie wszystkie kody SKU mają takie same domyślne ustawienia odnowienia. Zalecamy zawsze przekazywać wartość renewalSettings. Utwórz roczną subskrypcję zobowiązania z 10 stanowiskami:

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"
}

Zastąp następujące elementy:

  • CUSTOMER_ID: nazwa domeny podstawowej klienta lub jego unikalny identyfikator.
  • SKU_ID: unikalny identyfikator jednostki magazynowej (SKU). Więcej informacji znajdziesz w artykule Usługi i identyfikatory SKU.
  • PURCHASE_ORDER_ID: opcjonalny identyfikator zamówienia, którego możesz używać do śledzenia wykorzystania.

Odpowiedź świadcząca o powodzeniu zwraca stan HTTP 200 i ustawienia nowej subskrypcji w przypadku rocznego zobowiązania. ANNUAL_MONTHLY_PAY jest zwracany jako ANNUAL we wszystkich odpowiedziach API.

Oto przykład odpowiedzi dotyczącej pakietu rocznego:

{
  "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"
}

Tworzenie abonamentu elastycznego

Aby utworzyć elastyczną subskrypcję na nowo utworzonym koncie klienta, użyj tego żądania HTTP POST i dołącz token autoryzacji:

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"
}

Zastąp następujące elementy:

  • CUSTOMER_ID: nazwa domeny podstawowej klienta lub jego unikalny identyfikator.
  • SKU_ID: unikalny identyfikator jednostki magazynowej (SKU). Więcej informacji znajdziesz w artykule Usługi i identyfikatory SKU.
  • PURCHASE_ORDER_ID: opcjonalny identyfikator zamówienia, którego możesz używać do śledzenia wykorzystania.

Oto przykład odpowiedzi dotyczącej elastycznego planu:

{
  "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"
}

Tworzenie bezpłatnej wersji próbnej

Aby utworzyć 30-dniowy bezpłatny okres próbny dla nowo utworzonego konta klienta, użyj tego żądania HTTP POST i dołącz token autoryzacji:

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"
}

Zastąp następujące elementy:

  • CUSTOMER_ID: nazwa domeny podstawowej klienta lub jego unikalny identyfikator.
  • SKU_ID: unikalny identyfikator jednostki magazynowej (SKU). Więcej informacji znajdziesz w artykule Usługi i identyfikatory SKU.
  • PURCHASE_ORDER_ID: opcjonalny identyfikator zamówienia, którego możesz używać do śledzenia wykorzystania.

Oto przykład odpowiedzi dotyczącej 30-dniowego bezpłatnego okresu próbnego:

{
  "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"
}

Tworzenie subskrypcji z rabatem

Google może udostępnić kod oferty umożliwiający tworzenie subskrypcji po obniżonej cenie. Aby zastosować rabat do subskrypcji, musisz podać kod zniżkowy w wywołaniu insert subskrypcji. Jeśli klient zmieni oryginalny kod SKU, rabat zostanie usunięty.

Aby utworzyć subskrypcję z rocznym zobowiązaniem i rabatem na nowo utworzonym koncie klienta, użyj tego żądania HTTP POST i dołącz token autoryzacji:

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"
}

Zastąp następujące elementy:

  • CUSTOMER_ID: nazwa domeny podstawowej klienta lub jego unikalny identyfikator.
  • SKU_ID: unikalny identyfikator jednostki magazynowej (SKU). Więcej informacji znajdziesz w artykule Usługi i identyfikatory SKU.
  • PURCHASE_ORDER_ID: opcjonalny identyfikator zamówienia, którego możesz używać do śledzenia wykorzystania.
  • GOOGLE_CONTRACT_DEAL_CODE: kod rabatowy dostępny w Google.

Oto przykład odpowiedzi dotyczącej rocznego planu z rabatem:

{
  "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"
}

Przenoszenie subskrypcji

Jeśli nie zamówisz konta klienta za pomocą operacji zamawiania nowego konta klienta, podczas tworzenia subskrypcji dla tego klienta użyj tokena przeniesienia klienta.

Aby utworzyć subskrypcję na koncie klienta, którego nie zamawiasz, użyj tego żądania HTTP:POST

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions?customerAuthToken=TOKEN_VALUE

Zastąp następujące elementy:

  • CUSTOMER_ID: nazwa domeny podstawowej klienta lub jego unikalny identyfikator.
  • TOKEN_VALUE: token przeniesienia przekazany przez klienta. Po wygenerowaniu tokena przez klienta jest on ważny przez 30 dni.

Więcej informacji o tym, jak klienci mogą uzyskać token przeniesienia, znajdziesz w Centrum pomocy Google Workspace.

Aby przenieść subskrypcję klienta z rocznym abonamentem, użyj tego żądania HTTP POST i dołącz token autoryzacji:

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"
}

Zastąp następujące elementy:

  • CUSTOMER_ID: nazwa domeny podstawowej klienta lub jego unikalny identyfikator.
  • SKU_ID: unikalny identyfikator jednostki magazynowej (SKU). Więcej informacji znajdziesz w artykule Usługi i identyfikatory SKU.
  • PURCHASE_ORDER_ID: opcjonalny identyfikator zamówienia, którego możesz używać do śledzenia wykorzystania.

Pomyślna odpowiedź zwraca kod stanu HTTP 200 oraz ustawienia przeniesionej subskrypcji w przypadku rocznego planu zobowiązania:

{
  "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"
}

Ograniczenia dotyczące przenoszenia

Jeśli przenosisz subskrypcję Google Workspace z powiązaną subskrypcją Google Drive lub Google Vault, użyj batchoperacji, aby przenieść wszystkie subskrypcje ze stanem ACTIVE. Przenoszenie poszczególnych subskrypcji pojedynczo powoduje błąd.

Przeniesienie zawieszonych subskrypcji jest dozwolone tylko wtedy, gdy przyczyną zawieszenia jest PENDING_TOS_ACCEPTANCE, TRIAL_ENDED lub RENEWAL_WITH_TYPE_CANCEL.

Podczas przenoszenia starszego kodu SKU interfejs subscriptions.list zwraca skuId kodu SKU, który należy przenieść. skuIdSKU, które ma klient, jest zwracane jako transferInfo.currentLegacySkuId. Pełną listę skuIds i usług, które są używane w tych planach, znajdziesz na stronie Usługi i SKU.

Przenoszenie nie działa z kodami zniżkowymi.