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

如需使用 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：客户的电子邮件地址，例如 cruz@example.com。

成功的 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"
}