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