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

如需使用 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. 如需创建已通过域名验证的客户，请让客户购买直接订阅并验证其域名，然后转移订阅。

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

    1. 确认您的记录中没有主要域名与唯一 Google 客户标识符不匹配的旧客户数据。当已删除的账号恢复后，系统会将其视为具有新 customerId 的新账号。
    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 国家/地区代码。
  • 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"
}