Tworzenie i przenoszenie subskrypcji

Po złożyć zamówienie na konto klienta, możesz tworzyć wiele różnych subskrypcji:

  • Subskrypcja z rocznym zobowiązaniem
  • Subskrypcja elastyczna
  • 30-dniowy bezpłatny okres próbny
  • Subskrypcja ze zniżką

Więcej informacji o usługach wykorzystywanych w tych subskrypcjach znajdziesz na stronie Produkty i kody SKU.

Jeśli nie zostało ono złożone przez Ciebie, możesz przenieść subskrypcję.

Klienci korzystający z customerType = 'team' mogą kupować tylko wersje Essentials i Wersje Google Workspace Enterprise Essentials. Jeśli spróbujesz dokonać zakupu z pozostałych subskrypcji Google Workspace, błąd – Customer is not eligible to purchase this subscription. Klienci zakup Essentials lub subskrypcji opartych na wykorzystaniu może nie być w stanie obsłużyć Abonamenty roczne z ograniczonymi opcjami przejścia na wyższą lub niższą wersję usługi.

Tworzenie subskrypcji

Aby utworzyć subskrypcję dla nowo utworzonego konta klienta, skorzystaj z to żądanie HTTP POST i podaj token autoryzacji:

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

CUSTOMER_ID jest albo nazwa domeny podstawowej klienta lub niepowtarzalny identyfikator klienta zwrócony podczas odzyskanie konta klienta sprzedawcy.

Tworzenie abonamentu z rocznym zobowiązaniem

W przypadku abonamentu z rocznym zobowiązaniem nie wszystkie kody SKU mają takie same domyślnych ustawieniach odnawiania. Zalecamy, aby zawsze pomijać renewalSettings. Utwórz subskrypcję z 10 stanowiskami z rocznym zobowiązaniem:

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. nazwę użytkownika lub unikalny identyfikator klienta.
  • SKU_ID: unikalna jednostka magazynowa (SKU). Więcej informacji: Produkty i Identyfikatory SKU.
  • PURCHASE_ORDER_ID: opcjonalne zamówienie Identyfikator, którego możesz użyć do śledzenia użytkowania.

Pomyślna odpowiedź zwraca stan HTTP 200 oraz kod nowej subskrypcji ustawień abonamentu z rocznym zobowiązaniem. ANNUAL_MONTHLY_PAY jest zwracany jako ANNUAL we wszystkich odpowiedziach interfejsu API.

Oto przykład odpowiedzi na abonament roczny:

{
  "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ą dla nowo utworzonego konta klienta, użyj opcji to żądanie HTTP POST i podaj 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. nazwę użytkownika lub unikalny identyfikator klienta.
  • SKU_ID: unikalna jednostka magazynowa (SKU). Więcej informacji: Produkty i Identyfikatory SKU.
  • PURCHASE_ORDER_ID: opcjonalne zamówienie Identyfikator, którego możesz użyć do śledzenia użytkowania.

Oto przykład odpowiedzi w przypadku 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"
}

Utwórz bezpłatną wersję próbną

Aby utworzyć 30-dniowy bezpłatny okres próbny dla nowo utworzonego konta klienta użyj następującego żądania HTTP POST i dołącz autoryzację token:

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. nazwę użytkownika lub unikalny identyfikator klienta.
  • SKU_ID: unikalna jednostka magazynowa (SKU). Więcej informacji: Produkty i Identyfikatory SKU.
  • PURCHASE_ORDER_ID: opcjonalne zamówienie Identyfikator, którego możesz użyć do śledzenia użytkowania.

Poniżej znajdziesz przykładową odpowiedź dotyczącą 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 podać kod zniżkowy na tworzenie subskrypcji ze zniżką stawki. Aby obniżyć rabat, musisz podać kod zniżkowy w wywołanie insert subskrypcji. Jeśli klient zmieni kod SKU zostanie usunięty.

Aby utworzyć rabat na subskrypcję rocznego zobowiązania dla nowo utworzonej usługi klienta, użyj następującego żądania HTTP POST i dołącz parametr 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. nazwę użytkownika lub unikalny identyfikator klienta.
  • SKU_ID: unikalna jednostka magazynowa (SKU). Więcej informacji: Produkty i Identyfikatory SKU.
  • PURCHASE_ORDER_ID: opcjonalne zamówienie Identyfikator, którego możesz użyć do śledzenia użytkowania.
  • GOOGLE_CONTRACT_DEAL_CODE: dostępny kod zniżkowy od Google.

Oto przykład odpowiedzi na temat rabatu na abonament roczny:

{
  "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 konto klienta nie zostało złożone przez Ciebie za pomocą zamawianie nowego konta klienta podczas tworzenia subskrypcji dla tego klienta.

Aby utworzyć subskrypcję dla konta klienta, które nie zostało złożone przez Ciebie, skorzystaj z następujące żądanie 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. nazwę użytkownika lub unikalny identyfikator klienta.
  • TOKEN_VALUE: token przeniesienia udostępniony 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 Google Workspace.

Aby przenieść subskrypcję klienta z abonamentem z rocznym zobowiązaniem, użyj to żądanie HTTP POST i podaj 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. nazwę użytkownika lub unikalny identyfikator klienta.
  • SKU_ID: unikalna jednostka magazynowa (SKU). Więcej informacji: Produkty i Identyfikatory SKU.
  • PURCHASE_ORDER_ID: opcjonalne zamówienie Identyfikator, którego możesz użyć do śledzenia użytkowania.

Pomyślna odpowiedź zwraca stan HTTP 200. i ustawieniach przeniesionej subskrypcji, abonament z rocznym zobowiązaniem:

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

Przenoszenie subskrypcji Google Workspace z powiązanym Dyskiem Google lub subskrypcji Google Vault, użyj Operacja batch aby przenieść wszystkie subskrypcje o stanie ACTIVE. Przenoszenie każdej w przypadku subskrypcji – powoduje to błąd.

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

W przypadku przenoszenia starszej wersji SKU, subscriptions.list zwraca skuId kodu SKU, który chcesz przenieść. skuId kodu SKU, który Parametr customervactually zwraca wartość transferInfo.currentLegacySkuId. Dla pełną listę skuIds oraz usług objętych tymi abonamentami znajdziesz na stronie Produkty i kody SKU.

Przenoszenie nie działa w przypadku kodów zniżkowych.