Tworzenie i przenoszenie subskrypcji

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

  • subskrypcję z zobowiązaniem rocznym,
  • subskrypcję elastyczną,
  • 30-dniową bezpłatną wersję próbną,
  • subskrypcję z rabatem.

Więcej informacji o produktach, z których korzystają te subskrypcje, znajdziesz w sekcji Produkty i kody SKU.

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

Klienci z customerType = 'team' mogą kupować tylko wersje Google Workspace Essentials i Google Workspace Enterprise Essentials. Jeśli spróbujesz kupić inne subskrypcje Google Workspace, pojawi się błąd: Customer is not eligible to purchase this subscription (Klient nie może kupić tej subskrypcji). Klienci kupujący subskrypcje Essentials lub subskrypcje oparte na wykorzystaniu mogą nie mieć możliwości korzystania z abonamentów z zobowiązaniem rocznym oraz mogą mieć ograniczone opcje przejścia na wyższą lub niższą wersję.

Tworzenie subskrypcji

Aby utworzyć subskrypcję na nowym 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

CUSTOMER_ID to podstawowa nazwa domeny klienta lub jego unikalny identyfikator zwracany podczas pobierania konta klienta odsprzedawcy.

Tworzenie abonamentu z zobowiązaniem rocznym

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

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: domena podstawowa klienta lub jego unikalny identyfikator.
  • SKU_ID: unikalny identyfikator jednostki magazynowej (SKU). Więcej informacji znajdziesz w sekcji Produkty i identyfikatory SKU.
  • PURCHASE_ORDER_ID: opcjonalny identyfikator zamówienia, którego możesz użyć do śledzenia wykorzystania.

Pomyślna odpowiedź zwraca kod stanu HTTP 200 oraz ustawienia nowej subskrypcji w abonamencie z zobowiązaniem rocznym. ANNUAL_MONTHLY_PAY jest zwracany jako ANNUAL we wszystkich odpowiedziach interfejsu API.

Oto przykład odpowiedzi dotyczącej abonamentu 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ć subskrypcję elastyczną na nowym 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: domena podstawowa klienta lub jego unikalny identyfikator.
  • SKU_ID: unikalny identyfikator jednostki magazynowej (SKU). Więcej informacji znajdziesz w sekcji Produkty i identyfikatory SKU.
  • PURCHASE_ORDER_ID: opcjonalny identyfikator zamówienia, którego możesz użyć do śledzenia wykorzystania.

Oto przykład odpowiedzi dotyczącej abonamentu elastycznego:

{
  "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-dniową bezpłatną wersję próbną na nowym 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": "TRIAL"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

Zastąp następujące elementy:

  • CUSTOMER_ID: domena podstawowa klienta lub jego unikalny identyfikator.
  • SKU_ID: unikalny identyfikator jednostki magazynowej (SKU). Więcej informacji znajdziesz w sekcji Produkty i identyfikatory SKU.
  • PURCHASE_ORDER_ID: opcjonalny identyfikator zamówienia, którego możesz użyć do śledzenia wykorzystania.

Oto przykład odpowiedzi dotyczącej 30-dniowej bezpłatnej wersji próbnej:

{
  "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 z rabatem. Aby zastosować rabat na subskrypcję, musisz podać kod oferty w wywołaniu insert subskrypcji. Jeśli klient zmieni pierwotny kod SKU, rabat zostanie usunięty.

Aby utworzyć subskrypcję z zobowiązaniem rocznym z rabatem na nowym 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: domena podstawowa klienta lub jego unikalny identyfikator.
  • SKU_ID: unikalny identyfikator jednostki magazynowej (SKU). Więcej informacji znajdziesz w sekcji Produkty i identyfikatory SKU.
  • PURCHASE_ORDER_ID: opcjonalny identyfikator zamówienia, którego możesz użyć do śledzenia wykorzystania.
  • GOOGLE_CONTRACT_DEAL_CODE: kod rabatowy dostępny w Google.

Oto przykład odpowiedzi dotyczącej abonamentu rocznego 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 zamawiasz 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: domena podstawowa klienta lub jego unikalny identyfikator.
  • TOKEN_VALUE: token przeniesienia podany przez klienta. Po wygenerowaniu token jest ważny przez 30 dni.

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

Aby przenieść subskrypcję klienta z abonamentem z zobowiązaniem rocznym, 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: domena podstawowa klienta lub jego unikalny identyfikator.
  • SKU_ID: unikalny identyfikator jednostki magazynowej (SKU). Więcej informacji znajdziesz w sekcji Produkty i identyfikatory SKU.
  • PURCHASE_ORDER_ID: opcjonalny identyfikator zamówienia, którego możesz użyć do śledzenia wykorzystania.

Pomyślna odpowiedź zwraca kod stanu HTTP 200 oraz ustawienia przeniesionej subskrypcji w abonamencie z zobowiązaniem rocznym:

{
  "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 abonament Google Workspace powiązany z subskrypcją Dysk Google lub Google Vault, użyj batch operacji aby przenieść wszystkie subskrypcje ze stanem ACTIVE. Przenoszenie każdej subskrypcji osobno powoduje błąd.

Przenoszenie 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 subscriptions.list zwraca skuId kodu SKU, który należy przenieść. skuId kodu SKU, który faktycznie ma klient, jest zwracany jako transferInfo.currentLegacySkuId. Pełną listę skuIds oraz produktów używanych w tych abonamentach znajdziesz w sekcji Produkty i kody SKU.

Przenoszenie nie działa z kodami ofert rabatowych.