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

お客様の アカウントを注文した後、 次のようなさまざまなサブスクリプションを作成できます。

  • 年間契約のサブスクリプション
  • フレキシブル サブスクリプション
  • 30 日間の無料トライアル
  • 割引価格のサブスクリプション

これらのサブスクリプションで使用されるプロダクトの詳細については、 プロダクトと SKUをご覧ください。

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

customerType = 'team' のお客様は、Google Workspace の Google Workspace Essentials と Google Workspace Enterprise Essentials エディションのみを購入できます。他の Google Workspace サブスクリプションを購入しようとすると、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 は、お客様のプライマリ ドメイン名、または再販されたお客様のアカウントを 取得したときに返されるお客様の一意の識別子です。

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

年間契約プランのサブスクリプションの場合、すべての 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 HTTP リクエストを使用し、認証トークンを含めます。

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

無料トライアルを作成する

新しいお客様のアカウントの 30 日間の無料トライアル サブスクリプションを作成するには、次の 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": "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: Google から入手できる割引コード。

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

{
  "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 日間有効になります。

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

年間契約プランのお客様のサブスクリプションを移行するには、次の 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 Vault のサブスクリプションに関連付けられている Google Workspace サブスクリプションを移行する場合は、 batch オペレーションを使用して 、ステータスが ACTIVE のすべてのサブスクリプションを移行します。サブスクリプションを 1 つずつ移行すると、エラーが発生します。

サブスクリプションの停止理由が PENDING_TOS_ACCEPTANCE、TRIAL_ENDED、または RENEWAL_WITH_TYPE_CANCEL の場合にのみ、停止されたサブスクリプションの移行が許可されます。

以前の SKU を移行する場合、subscriptions.list は、移行する必要がある SKU の skuId を返します。お客様が実際に所有している SKU の skuId は、transferInfo.currentLegacySkuId として返されます。これらのプランで使用される skuIds の完全なリストとプロダクトについては、 プロダクトと SKU をご覧ください。

移行は、割引特典コードでは機能しません。