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

如需使用 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：客户的 2 个字符 ISO 国家/地区代码。
• 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"
}