检索和更新客户的帐号信息

如需使用 Reseller API 检索和更新客户信息，您可以通过以下两种方式查找客户：

• 客户的唯一标识符，例如 C0123456
• 客户的域名，例如 example.com

检索客户的帐号信息

如需检索客户的帐号信息，请使用以下 GET 请求并包含授权令牌：

GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

将 CUSTOMER_ID 替换为客户的唯一标识符或域名。

响应返回

检索客户的帐号信息时，您可能会收到以下响应之一：

• 返回完整的客户设置。该客户是您的现有客户之一。借助 Reseller API，您可以管理此客户的帐号和订阅设置。

• 返回最少的客户帐号信息。如果响应仅返回 customerId、customerDomain 和 customerType，则表示 Google 或其他转销商负责管理客户。您无法为客户创建其他通过电子邮件验证的客户。如需管理此客户，请按以下步骤操作：

  1. 检索客户的所有可转移订阅，以了解是否可以转移订阅以及转移的用户席位数下限。
  2. 转移订阅。

• 返回 Multiple teams exist on this domain。此网域关联了一个或多个团队客户。如需向此网域添加其他团队，请按以下步骤操作：

  1. 订购客户帐号。
  2. 如需为网域创建已通过域名验证的客户，请让客户通过 Google 购买直接订阅并验证其域名，接管现有团队，然后将订阅转移到您的帐号。

• 返回 HTTP 404 错误。客户是 Google 的新客户，没有帐号。若要管理此客户，请按以下步骤操作：

  1. 确认您的客户记录未保留可能与客户主域名与唯一 Google 客户标识符不匹配的旧客户数据。当先前删除的 Google 帐号恢复时，会被视为新帐号并且具有新的 customerId 值，即使该帐号可能保留相同的 customerDomain 值也是如此。
  2. 订购新的客户帐号。
  3. 为此新客户账号创建订阅。

更新客户设置

使用 Reseller API 时，您无法更新 customerType，但可以验证 team 客户的域名并成为 domain 客户。

如需更新客户设置，请使用以下 PUT 请求，并在其中添加客户的唯一标识符：

PUT https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

JSON 请求正文会更新以下客户设置：

{
  "customerId": "C0CUSTOMER_ID123456",
  "customerDomain": "DOMAIN_NAME",
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

替换以下内容：

• DOMAIN_NAME：您的客户的网域，例如 example.com
• NAME：客户的名称，例如 Alex Cruz。
• ORGANIZATION_NAME：您客户的组织名称，例如 Example Organization。
• POSTAL_CODE：客户的邮政编码，例如 94043。
• COUNTRY_CODE：客户的 ISO 国家/地区代码（由 2 个字符组成）。
• EMAIL_ADDRESS：客户的电子邮件地址，例如 [e-mail]。

成功的 JSON 响应将返回 HTTP 200 状态代码和更新后的客户设置：

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME",
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}