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

要使用 Reseller API 检索和更新客户信息，请执行以下操作： 您可以通过以下两种方式查找客户：

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

检索客户的账号信息

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

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

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

响应返回

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

• 返回完整的客户设置。该客户是 现有客户。借助转销商 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"
}