管理 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 方法开始创建使用权。

创建使用权并填充优惠、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 结算帐号。如需更改付费付款方案使用权的付款方案，您还需要执行几个额外的步骤来选择 Google Workspace 结算帐号。

如需更改 Google Workspace 使用权的付款方案，请按以下步骤操作：

仅当现有使用权具有免费试用或试用付款方案时，才需要执行前两个步骤。

对于优惠，您可以使用 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 方法查找一组可用于支付此项使用权的 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"
        }
      },
    }
  ],
}

此时，您应该拥有使用权、优惠和 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 方法即可检索可用于升级或降级的 PurchasableSku 列表。

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 方法查找一组可用于支付使用权费用的 BillingAccounts。

如果您想以特定币种付款，请选择采用该币种的 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、PurhasableOffer 和 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",
      },
    }
  ],
}

现在您已经有了 TransferableSkus 列表，接下来需要确定使用哪个 BillingAccount 支付使用权。使用 queryEligibleBillingAccounts 方法查找一组可用于每个 TransferableSku 的 BillingAccount。

请注意，某些 TransferableSku 必须共用同一 Google Workspace 结算帐号，因此 queryEligibleBillingAccounts 会返回一个 SKU 群组，以告知您哪些 TransferableSkus 需要使用同一 BillingAccount。如果给定 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"
}