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, których dotyczą 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

Wartość CUSTOMER_ID to nazwa domeny podstawowej klienta lub jego unikalny identyfikator zwrócony podczas pobierania konta klienta odsprzedanego.

Tworzenie abonamentu z zobowiązaniem rocznym

W przypadku subskrypcji w abonamencie z zobowiązaniem rocznym nie wszystkie kody SKU mają te same domyślne ustawienia odnowienia. Zalecamy, aby zawsze przekazywać wartość renewalSettings. Utwórz subskrypcję z zobowiązaniem rocznym na 10 stanowisk:

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 te elementy:

  • CUSTOMER_ID: nazwa domeny podstawowej 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 zwracana 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 te elementy:

  • CUSTOMER_ID: nazwa domeny podstawowej 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 te elementy:

  • CUSTOMER_ID: nazwa domeny podstawowej 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 do subskrypcji, musisz podać kod oferty w wywołaniu insert subskrypcji. Jeśli klient zmieni pierwotny kod SKU, rabat zostanie usunięty.

Aby utworzyć subskrypcję z rabatem i zobowiązaniem rocznym 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 te elementy:

  • CUSTOMER_ID: nazwa domeny podstawowej 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 te elementy:

  • CUSTOMER_ID: nazwa domeny podstawowej klienta lub jego unikalny identyfikator.
  • TOKEN_VALUE: token przeniesienia podany 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 administratora.

Aby przenieść subskrypcję klienta w abonamencie 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 te elementy:

  • CUSTOMER_ID: nazwa domeny podstawowej 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 subskrypcję Google Workspace powiązaną z subskrypcją Dysku Google lub Google Vault, użyj batch operacji aby przenieść wszystkie subskrypcje ze stanem ACTIVE. Przenoszenie każdej subskrypcji osobno spowoduje 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 operacja subscriptions.list zwraca wartość skuId kodu SKU, który należy przenieść. Wartość skuId kodu SKU, który faktycznie ma klient, jest zwracana jako transferInfo.currentLegacySkuId. Pełną listę wartości skuIds oraz produktów używanych w tych abonamentach znajdziesz w sekcji Produkty i kody SKU.

Przenoszenie nie działa z kodami ofert rabatowych.