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 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ą kupić tylko 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. Klienci kupujący subskrypcje Essentials lub subskrypcje oparte na wykorzystaniu mogą nie mieć możliwości korzystania z abonamentów rocznych i mieć ograniczone opcje przejścia na wyższą lub niższą wersję.

Tworzenie subskrypcji

Aby utworzyć subskrypcję na koncie nowego klienta, użyj tego żądania HTTPPOST i dołącz token autoryzacji:

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

Wartość CUSTOMER_ID to podstawowa nazwa domeny klienta lub jego unikalny identyfikator zwracany podczas pobierania konta klienta odsprzedanego.

Tworzenie rocznego planu zobowiązań

W przypadku subskrypcji w abonamencie z rocznym zobowiązaniem nie wszystkie kody SKU mają takie same domyślne ustawienia odnowienia. Zalecamy zawsze przekazywać wartość renewalSettings. Utwórz subskrypcję z rocznym zobowiązaniem 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 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 nowe ustawienia subskrypcji w przypadku rocznego planu 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ć subskrypcję elastyczną na koncie nowego 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-dniową subskrypcję w bezpłatnej wersji próbnej na koncie nowego 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 pierwotny kod SKU, rabat zostanie usunięty.

Aby utworzyć roczną subskrypcję z rabatem na konto nowego 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 jego tokena przeniesienia.

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 przez klienta 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 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 i przeniesione ustawienia 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 abonament Google Workspace z powiązaną subskrypcją Dysku Google lub Google Vault, użyj batch, aby przenieść wszystkie subskrypcje ze stanem ACTIVE. Przenoszenie każdej subskrypcji pojedynczo powoduje błąd.

Przeniesienie zawieszonych subskrypcji jest możliwe tylko wtedy, gdy powodem zawieszenia jest PENDING_TOS_ACCEPTANCE, TRIAL_ENDED lub RENEWAL_WITH_TYPE_CANCEL.

Podczas przenoszenia starszego kodu SKU funkcja subscriptions.list zwraca skuId kodu SKU, który należy przenieść. skuId SKU, który klient faktycznie ma, jest zwracany jako transferInfo.currentLegacySkuId. Pełną listę skuIds i informacje o tym, które produkty są używane w tych planach, znajdziesz w sekcji Produkty i kody SKU.

Przenoszenie nie działa z kodami zniżkowymi.