Google Workspace と Google Chrome の利用資格を管理する

このページでは、Google Workspace と Google Chrome プロダクトの顧客の利用資格を管理する方法について説明します。

前提条件

続行する前に、販売パートナーアカウントに単一の Google Workspace 請求先アカウントがあるか、複数の Google Workspace 請求先アカウントがあるかを判断します。このトピックについて詳しくは、複数の Google Workspace 請求先アカウントスターターガイドをご覧ください。

利用資格を作成する

準備

続行する前に、Customer の設定が必要です。

利用資格を作成する手順は次のとおりです。

顧客名で listPurchasableSkus を呼び出し、PurchasableSkus のリストを取得する

ListPurchasableSkusRequest
{
  "customer": "accounts/123/customers/abc",
  "createEntitlementPurchase": {
    "product": "products/-"
  }
}
ListPurchasableSkusResponse
{
  "purchasableSkus": [
    {
      "sku": {
        "name": "products/product_id/skus/sku_id1",
        "product": {
          "name": "products/product_id",
        }
      }
    },
    {
      "sku": {
        "name": "products/product_id/skus/sku_id2",
        "product": {
          "name": "products/product_id",
        },
      }
    }
  ]
}

選択した PurchasableSku で、queryEligibleBillingAccounts メソッドを使用して、利用資格の支払いに使用できる、Google Workspace BillingAccount のセットを見つけます。

特定の通貨で支払う場合は、その通貨を持つ BillingAccount を選択します。

QueryEligibleBillingAccountsRequest
{
  "customer": "accounts/123/customers/abc",
  "skus": ["products/product_id/skus/sku_id1"]
}
QueryEligibleBillingAccountsResponse
{
  "skuPurchaseGroups": [
    {
      "skus": [
        "products/product_id/skus/sku_id1"
      ],
      "billingAccountPurchaseInfos": [
        {
          "billingAccount": {
            "name": "accounts/123/billingAccounts/billing_account_id1",
            "displayName": "Google_Workspace_USD_US_1",
            "currencyCode": "USD",
            "regionCode": "US"
          }
        },
        {
          "billingAccount": {
            "name": "accounts/123/billingAccounts/billing_account_id2",
            "displayName": "Google_Workspace_CAD_CA_1",
            "currencyCode": "CAD",
            "regionCode": "CA"
          }
        }
      ]
    }
  ]
}

選択した PurchasableSku と BillingAccount で、listPurchasableOffers メソッドを使用して、利用可能な PurchasableOffer を見つけます。

ListPurchasableOffersRequest
{
  "customer": "accounts/123/customers/abc",
  "createEntitlementPurchase": {
    "sku": "products/product_id/skus/sku_id1",
    "billingAccount": "accounts/123/billingAccounts/billing_account_id2"
  }
}
ListPurchasableOffersResponse
{
  "purchasableOffers": [
    {
      "offer": {
        "name": "accounts/123/offers/offer_id1",
      },
      "sku": {
        "name": "products/product_id/skus/sku_id1",
      },
      "plan": {
        "paymentPlan": "FLEXIBLE",
        "paymentCycle": {
          "duration": 1,
          "periodType": "MONTH"
        }
      },
    }
  ],
}

この時点で、Entitlement と PurchasableOffer の支払いを行う BillingAccount が作成されています。create メソッドを使用して利用資格の作成を開始します。
1. Entitlement を作成し、オファー、billingAccount、その他の必須パラメータを入力します。
```
CreateEntitlementRequest
{
  "parent": "accounts/123/customers/abc",
  "entitlement": {
    "offer": "accounts/123/offers/offer_id1",
    "maxUnits": 100,
    "billingAccount": "accounts/123/billingAccounts/billing_account_id2"
  }
}
CreateEntitlementResponse
{
  "name": "operations/operation_id1"
}
```

Google Workspace の利用資格のお支払いプランを変更する

準備

無料または試用版のお支払い plan による Google Workspace の利用資格には、Google Workspace の請求先アカウントがありません。Entitlement のお支払いプランを有料のお支払いプランに変更するには、Google Workspace の請求先アカウントを選択するための追加の手順がいくつかあります。

Google Workspace の利用資格のお支払いプランを変更するには、次の手順を行います。

最初の 2 つの手順は、既存の Entitlement に無料または試用版のお支払いプランがある場合にのみ必要です。

オファーで、lookupOffer メソッドを使用して、オファーに関する Sku 情報を見つけます。

LookupOfferRequest
{
  "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1"
}
LookupOffer respones
{
  "name": "accounts/123/offers/offer_id1",
  "sku": {
    "name": "products/product_id/skus/sku_id1",
   }
}

顧客と Sku で、queryEligibleBillingAccounts メソッドを使用して、この Entitlement の支払いに使用できる BillingAccount のセットを見つけます。特定の通貨で支払う場合は、その通貨を持つ BillingAccount を選択します。

 QueryEligibleBillingAccountsRequest
 {
   "customer": "accounts/123/customers/abc",
   "skus": ["products/product_id/skus/sku_id1"]
 }
 QueryEligibleBillingAccountsResponse
 {
   "skuPurchaseGroups": [
     {
       "skus": [
         "products/product_id/skus/sku_id1"
       ],
       "billingAccountPurchaseInfos": [
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/billing_account_id1",
             "displayName": "Google_Workspace_USD_US_1",
             "currencyCode": "USD",
             "regionCode": "US"
           }
         },
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/billing_account_id2",
             "displayName": "Google_Workspace_CAD_CA_1",
             "currencyCode": "CAD",
             "regionCode": "CA"
           }
         }
       ]
     }
   ]
 }
 ```

Entitlement と BillingAccount で、listPurchasableOffers メソッドを使用して PurchasableOffer 見つけます。既存の利用資格に有料プランがある場合は、BillingAccount は不要です。この場合は、既存の BillingAccount が使用されます。お支払いプランを変更するには、purchase_option フィールドを changeOfferPurchase にする必要があります

ListPurchasableOffersRequest
{
  "customer": "accounts/123/customers/abc",
  "changeOfferPurchase": {
    "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1",
    "billingAccount": "accounts/123/billingAccounts/billing_account_id2"
  }
}
ListPurchasableOffersResponse
{
  "purchasableOffers": [
    {
      "offer": {
        "name": "accounts/123/offers/offer_id1",
      },
      "sku": {
        "name": "products/product_id/skus/sku_id1",
      },
      "plan": {
        "paymentPlan": "FLEXIBLE",
        "paymentCycle": {
          "duration": 1,
          "periodType": "MONTH"
        }
      },
    }
  ],
}

この時点で、Entitlement、Offer、BillingAccount が作成されています。changeOffer メソッドを使用して、お支払いプランの変更を開始します。

ChangeOfferRequest
{
  "name": "accounts/abc/customers/123/entitlements/entitlement_id1",
  "offer": "accounts/abc/offers/offer_id1",
  "billing_account": "accounts/abc/billingAccounts/billing_account_id2",
  "parameters": [{
    "name": "max_units",
    "value": {
      "int64Value": "100"
    }
  }]
}
ChangeOfferResponse
{
  "name": "operations/operation_id1"
}

Google Workspace の利用資格をアップグレードまたはダウングレードする

Google Workspace の利用資格をアップグレードまたはダウングレードするには、次の手順に従います。

利用資格で、listPurchasableSkus メソッドを呼び出し、アップグレードやダウングレードに使用できる PurchasableSkus のリストを取得します。

ListPurchasableSkusRequest
{
  "customer": "accounts/123/customers/abc",
  "changeOfferPurchase": {
    "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1",
    "changeType": "UPGRADE"
  }
}
ListPurchasableSkusResponse
{
  "purchasableSkus": [
    {
      "sku": {
        "name": "products/product_id/skus/sku_id1",
        "product": {
          "name": "products/product_id",
        }
      }
    },
    {
      "sku": {
        "name": "products/product_id/skus/sku_id2",
        "product": {
          "name": "products/product_id",
        },
      }
    }
  ]
}

PurchasableSku で queryEligibleBillingAccounts メソッドを使用して、Entitlement の支払いに使用できる BillingAccount のセットを見つけます。

特定の通貨で支払う場合は、その通貨を持つ BillingAccount を選択します。

 QueryEligibleBillingAccountsRequest
 {
   "customer": "accounts/123/customers/abc",
   "skus": ["products/product_id/skus/sku_id1"]
 }
 QueryEligibleBillingAccountsResponse
 {
   "skuPurchaseGroups": [
     {
       "skus": [
         "products/product_id/skus/sku_id1"
       ],
       "billingAccountPurchaseInfos": [
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/billing_account_id1",
             "displayName": "Google_Workspace_USD_US_1",
             "currencyCode": "USD",
             "regionCode": "US"
           }
         },
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/billing_account_id2",
             "displayName": "Google_Workspace_CAD_CA_1",
             "currencyCode": "CAD",
             "regionCode": "CA"
           }
         }
       ]
     }
   ]
 }
 ```

Entitlement と BillingAccount で、listPurchasableOffers メソッドを使用して PurchasableOffer 見つけます。

  ListPurchasableOffersRequest
  {
    "customer": "accounts/123/customers/abc",
    "changeOfferPurchase": {
      "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1",
      "billingAccount": "accounts/123/billingAccounts/billing_account_id2"
    }
  }
  ListPurchasableOffersResponse
  {
    "purchasableOffers": [
      {
        "offer": {
          "name": "accounts/123/offers/offer_id1",
        },
        "sku": {
          "name": "products/product_id/skus/sku_id1",
        },
        "plan": {
          "paymentPlan": "FLEXIBLE",
          "paymentCycle": {
            "duration": 1,
            "periodType": "MONTH"
          }
        },
      }
    ],
  }
  ```

この時点で、Entitlement、PurchhasableOffer、BillingAccount が作成されています。changeOffer メソッドを使用して、アップグレードまたはダウングレードを開始します。

Entitlement オブジェクトを作成し、名前、オファー、billingAccount、必須パラメータを入力します。

   ChangeOfferRequest
   {
     "name": "accounts/abc/customers/123/entitlements/entitlement_id1",
     "offer": "accounts/abc/offers/offer_id1",
     "billing_account": "accounts/abc/billingAccounts/billing_account_id2",
     "parameters": [{
       "name": "max_units",
       "value": {
         "int64Value": "100"
       }
     }]
   }
   ChangeOfferResponse
   {
     "name": "operations/operation_id1"
   }
   ```

利用資格を移行する

このセクションでは、既存の Google Workspace と Chrome の顧客の利用資格を以前のパートナーから移行する方法について説明します。

Partner Sales Console での顧客の移行については、パートナーアカウントまたは Google アカウントへの顧客の移行に関するガイドをご覧ください。

Google Workspace の顧客は、単一のパートナー、または単一のパートナーおよび Google からのみ利用資格を購入できます。

移行中に、既存の利用資格は、新しいパートナーの下で再度作成される前に、自動的にキャンセルされます。顧客がコミットメントプランの利用資格を持っている場合、移行後に新しいコミットメント期間が開始されます。

準備

顧客の利用資格を管理するには、顧客生成の移行トークンが必要です。顧客に連絡し、パートナーの公開 ID を指定して、移行トークンを生成できるようにします。トークンを作成した後、顧客は移行トークンを返送してプロセスを完了する必要があります。これらのトークンは、作成から 14 日後に期限切れになります。また、顧客のドメインまたは Cloud Identity ID も必要です。

顧客が移行トークンを作成するときに、新しい販売パートナーに移行するエンタイトルメントを選択します。このプロセス中に、選択したすべての利用資格を移行する必要があります。

利用資格を移行するには、次の手順に従います。

顧客のドメインのみを所有している場合は、Cloud Channel API を使用して Cloud Identity ID を返すことができます。顧客のドメインで checkCloudIdentityAccountsExist を呼び出します。ドメインが存在する場合、API は顧客の Cloud Identity ID を返します。

customers.import メソッドを使用して顧客のデータをインポートし、転送を開始します。
```
ImportCustomerRequest
{
  "parent": "accounts/abc",
  "domain": "domain"
}
```

顧客の Cloud Identity ID で listTransferableSkus を呼び出し、顧客の transferableSku のリストを取得します。各オブジェクトの transferEligibility を確認して、関連する SKU を購入できることを確認します。

ListTransferableSkusRequest
{
  "parent": "accounts/abc",
  "cloudIdentityId": "cloud_identity_id"
}
ListTransferableSkusResponse
{
  "transferableSku": [
    {
      "sku": {
           "name": "products/product_id/skus/voice_sku_id1",
      },
    },
    {
      "sku": {
           "name": "products/product_id/skus/google_workspace_sku_id2",
      },
    },
    {
      "sku": {
           "name": "products/product_id/skus/google_workspace_chrome_sku_id3",
      },
    }
  ],
}

TransferableSku のリストが作成されたので、利用資格の支払いに使用する BillingAccount を決定する必要があります。queryEligibleBillingAccounts メソッドを使用して、各 TransferableSku で使用できる BillingAccount のセットを見つけます。

特定の TransferableSku は、同じ Google Workspace 請求先アカウントを共有する必要があります。そのため、queryEligibleBillingAccounts は、どの TransferableSku が同じ BillingAccount を使用する必要があるかを示す sku グループを返します。特定の SKU グループに複数の Google Workspace 請求先アカウントがある場合は、いずれかの Google Workspace 請求先アカウントを選択して、グループ内のすべての TransferableSku に使用できます。

QueryEligibleBillingAccountsRequest
{
  "customer": "accounts/123/customers/abc",
  "skus": ["products/product_id/skus/voice_sku_id1","products/product_id/skus/google_workspace_sku_id2","google_workspace_chrome_sku_id3"]
}
QueryEligibleBillingAccountsResponse
 {
   "skuPurchaseGroups": [
     {
       "skus": [
         "products/product_id/skus/voice_sku_id1"
       ],
       "billingAccountPurchaseInfos": [
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/voice_billing_account_id1",
             "displayName": "Google_Workspace_Voice_USD_US_1",
             "currencyCode": "USD",
             "regionCode": "US"
           }
         }
       ]
     },
     {
       "skus": [
         "products/product_id/skus/google_workspace_sku_id2","google_workspace_chrome_sku_id3"
       ],
       "billingAccountPurchaseInfos": [
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/gw_billing_account_id1",
             "displayName": "Google_Workspace_USD_US_1",
             "currencyCode": "USD",
             "regionCode": "US"
           }
         },
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/gw_billing_account_id2",
             "displayName": "Google_Workspace_CAD_CA_1",
             "currencyCode": "CAD",
             "regionCode": "CA"
           }
         }
       ]
     }
   ]
 }
 ```

TransferableSku と BillingAccount のペアごとに listTransferableOffers メソッドを使用して、使用可能な TransferableOffers を見つけます。この時点で、TransferableSku、BillingAccounts、TransferableOffer で構成されるタプルのリストが作成されます。

ListTransferableOffersRequest
{
  "parent": "accounts/abc",
  "cloudIdentityId": "cloud_identity_id",
  "sku": "products/product_id/skus/voice_sku_id1",
  "billingAccount": "ccounts/123/billingAccounts/voice_billing_account_id1"
}
ListTransferableOffersResponse
   {
     "transferableOffers": [
       {
         "offer": {
           "name": "accounts/123/offers/voice_offer_id1",
         },
         "sku": {
           "name": "products/product_id/skus/voice_sku_id1",
         },
         "plan": {
           "paymentPlan": "FLEXIBLE",
           "paymentCycle": {
             "duration": 1,
             "periodType": "MONTH"
           }
         },
       }
     ],
   }

タプルごとに、対応する新しい Entitlement オブジェクトを作成します。各 Entitlement には、Offer、BillingAccount、必須パラメータが必要です。transferEntitlements メソッドを呼び出して転送を実行します。

TransferEntitlementsRequest
{
  "parent": "accounts/abc/customers/123",
  "entitlements": [
    {
      "offer": "accounts/123/offers/voice_offer_id1",
      "maxUnits": 100,
      "billingAccount": "accounts/123/billingAccounts/voice_billing_account_id1"
    },
    {
      "offer": "accounts/123/offers/gw_offer_id2",
      "maxUnits": 150,
      "billingAccount": "accounts/123/billingAccounts/gw_billing_account_id1"
    }
    {
      "offer": "accounts/123/offers/gw_chrome_offer_id3",
      "maxUnits": 200,
      "billingAccount": "accounts/123/billingAccounts/gw_billing_account_id1"
    }
  ]
}
TransferEntitlementsResponse
{
  "name": "operations/operation_id1"
}