サブスクリプションを作成または移行する

Google Chat の設定 お客様のアカウントを注文する さまざまなサブスクリプションを作成できます

  • 年間契約のサブスクリプション
  • フレキシブルなサブスクリプション
  • 30 日間の無料試用
  • 割引価格の定期購入

これらの定期購入で使用するプロダクトの詳細については、 プロダクトと SKU。

このお客様のアカウントを注文していない場合、 サブスクリプションを移行します。

customerType = 'team' をご利用のお客様が購入できるのは、Essentials と Google Workspace の Enterprise Essentials エディション。購入を試みた場合 その他の Google Workspace サブスクリプションでも error - Customer is not eligible to purchase this subscription。お客様 Essentials または従量制のサブスクリプションでは、 年間契約プランです。アップグレードとダウングレードのオプションは限られています。

サブスクリプションを作成する

新しく作成されたお客様のアカウント用のサブスクリプションを作成するには、 次の POST HTTP リクエストを作成し、認証トークンを含めます。

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

CUSTOMER_ID は、 顧客のプライマリ ドメイン名または一意の ID が 販売パートナー経由で購入されたお客様のアカウントを取得します。

年間契約プランを作成する

年間コミットメント プランのサブスクリプションの場合、SKU はそれぞれ異なる 更新されます常に renewalSettings を渡すことをおすすめします。作成 10 シートの年間契約サブスクリプション:

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

次のように置き換えます。

  • CUSTOMER_ID: 顧客のプライマリ ドメイン 顧客の一意の識別子を指定します
  • SKU_ID: 固有の最小管理単位（SKU） あります。詳細については、次をご覧ください: プロダクトとSKU ID。
  • PURCHASE_ORDER_ID: 注文書（省略可） 使用状況を追跡するために使用できる ID。

成功すると、HTTP 200 ステータスと新しいサブスクリプションのレスポンスが返されます。 設定が必要ですANNUAL_MONTHLY_PAY は次のように返されます。 すべての API レスポンスで ANNUAL。

年間プランに対するレスポンスの例を次に示します。

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

フレキシブル プランを作成する

新規に作成したお客様のアカウント用にフレキシブルなサブスクリプションを作成するには、以下を使用します。 認証トークンを含めます。POST

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

次のように置き換えます。

  • CUSTOMER_ID: 顧客のプライマリ ドメイン 顧客の一意の識別子を指定します
  • SKU_ID: 固有の最小管理単位（SKU） あります。詳細については、次をご覧ください: プロダクトとSKU ID。
  • PURCHASE_ORDER_ID: 注文書（省略可） 使用状況を追跡するために使用できる ID。

フレキシブル プランのレスポンスの例を次に示します。

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

無料トライアルの作成

新規に作成した顧客の 次の POST HTTP リクエストを使用して、認証リクエストを含めます。 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"
}

次のように置き換えます。

  • CUSTOMER_ID: 顧客のプライマリ ドメイン 顧客の一意の識別子を指定します
  • SKU_ID: 固有の最小管理単位（SKU） あります。詳細については、次をご覧ください: プロダクトとSKU ID。
  • PURCHASE_ORDER_ID: 注文書（省略可） 使用状況を追跡するために使用できる ID。

30 日間の無料試用プランのレスポンスの例を次に示します。

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

割引サブスクリプションを作成する

Google は、定期購入を作成するためのディールコードを提供することがあります。割引料金が適用される場合があります。 。サブスクリプションを割引するには、 サブスクリプションの insert 呼び出し。お客様が現在の 元の SKU に対する割引は適用されず、

新規に作成したサービスに対して年間コミットメントの割引サブスクリプションを作成するには、 使用する場合は、次の POST HTTP リクエストを使用して、 認可トークン:

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

次のように置き換えます。

  • CUSTOMER_ID: 顧客のプライマリ ドメイン 顧客の一意の識別子を指定します
  • SKU_ID: 固有の最小管理単位（SKU） あります。詳細については、次をご覧ください: プロダクトとSKU ID。
  • PURCHASE_ORDER_ID: 注文書（省略可） 使用状況を追跡するために使用できる ID。
  • GOOGLE_CONTRACT_DEAL_CODE: 割引コードあり 提供します。

年間プランの割引に対するレスポンスの例を次に示します。

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

定期購入の移行

以下を使用してお客様のアカウントを注文していない場合、 新しいお客様アカウントを注文する お客様の移行トークンを使用して、サブスクリプションを 許可します。

注文していない顧客アカウントのサブスクリプションを作成するには、 次の POST HTTP リクエストを実行します。

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

次のように置き換えます。

  • CUSTOMER_ID: 顧客のプライマリ ドメイン 顧客の一意の識別子を指定します
  • TOKEN_VALUE: プロバイダから提供された移行トークン 提供します。トークンは、お客様が生成したトークンから 30 日間有効です。

お客様が移行トークンを取得する方法について詳しくは、 Google Workspace ヘルプセンターをご覧ください。

年間契約プランのお客様のサブスクリプションを移行するには、 次の POST HTTP リクエストを作成し、認証トークンを含めます。

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

次のように置き換えます。

  • CUSTOMER_ID: 顧客のプライマリ ドメイン 顧客の一意の識別子を指定します
  • SKU_ID: 固有の最小管理単位（SKU） あります。詳細については、次をご覧ください: プロダクトとSKU ID。
  • PURCHASE_ORDER_ID: 注文書（省略可） 使用状況を追跡するために使用できる ID。

成功すると、HTTP 200 ステータスが返されます。 移行されたサブスクリプションの設定を 年間契約プラン:

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

移行の制限事項

Google ドライブが関連付けられている Google Workspace サブスクリプションを移行する場合 または Google Vault サブスクリプションをご利用の場合は、 batch オペレーション ステータスが ACTIVE のすべてのサブスクリプションを移行する必要があります。それぞれの エラーになります。

停止中のサブスクリプションを移行できるのは、停止の理由が以下の場合のみです。 PENDING_TOS_ACCEPTANCE、TRIAL_ENDED、または RENEWAL_WITH_TYPE_CANCEL。

以前の SKU を移行すると、subscriptions.list は skuId を返します。 引き継ぐ必要がある SKU ですskuId である SKU の customerveffectively は transferInfo.currentLegacySkuId として返されます。1 つの skuIds とこれらのプランで使用されるサービスの完全なリストについては、以下をご覧ください。 プロダクトと SKU。

割引ディールコードは移行に対応していません。