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

如需使用 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：客户的 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"
}