订购新客户帐号

在创建新的客户账号之前，请考虑以下事项：

创建客户账号

  1. 如需创建客户账号，请使用以下 POST 请求并 包含授权令牌：

    POST https://reseller.googleapis.com/apps/reseller/v1/customers

  2. 在新客户的账号中 创建用户。 如果响应返回 HTTP 409 Conflict 状态代码， “customerId”已存在。在注册客户账号之前，您必须 转移客户的订阅。

  3. 如果适用，请更改客户的默认语言。

  4. 推广 授予超级用户角色。 创建管理员账号时，您可以生成 随机密码，或提示用户提供密码。

  5. 通知客户，他们必须登录管理控制台，并 签署《通过转销商购买 Google Workspace 协议》才能激活 其账号。转销商不得在 。

客户类型

您可以在 Google Workspace 中创建两种客户：

  • 通过域名验证的客户。这些客户需要 Gmail 完整的管理员权限。创建此类客户时，请将 customerType 至 domain。
  • 通过电子邮件验证的客户。这些客户并不拥有或管理 网域。创建此类客户时，请将 customerType 设置为 team。此类客户可以购买 基本功能版和企业基本功能版 Google Workspace 各版本。

以下 JSON 请求正文是一个已通过域名验证的客户的示例：

{
  "customerDomain": "DOMAIN_NAME",
  "customerType": "domain",
  "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。

成功的响应将返回一个 HTTP 200 状态代码以及新客户的 信息：

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME",
  "customerType": "domain",
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

以下 JSON 请求正文是一个通过电子邮件验证的客户示例：

{
  "customerDomain": "DOMAIN_NAME",
  "customerType": "team",
  "primaryAdmin": {
    "primaryEmail": "EMAIL_ADDRESS"
  },
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
 "alternateEmail": "EMAIL_ADDRESS"
}

成功的响应将返回一个 HTTP 200 状态代码以及新客户的 信息：

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME,
  "customerType": "team",
  "primaryAdmin": {
    "primaryEmail": "EMAIL_ADDRESS"
  },
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

更改客户的默认语言

客户的默认语言仅适用于符合以下条件的新用户： 创建。现有的用户仍然保留他们当前的语言，即便您保留了该语言， 请更新默认语言。因此，您必须设置客户默认值 然后再创建用户

新创建的客户的默认语言为英语。要更改 默认语言，请使用 PATCH 或 UPDATE 来自 Directory API 的调用 客户 端点。

使用 Directory API 更新客户的默认 language 值：

PATCH https://reseller.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID

添加以下 JSON 请求正文：

{
  "language":"LANGUAGE_CODE"
}

替换以下内容：

  • CUSTOMER_ID：您的 客户 - 例如 C0123456
  • LANGUAGE_CODE：可接受的值 语言代码 例如，es 表示西班牙语。

成功的 JSON 响应会返回 HTTP 200 状态代码以及更新后的 客户资源：

{
  "alternateEmail": "EMAIL_ADDRESS",
  "customerCreationTime": "2022-12-12T23:04:10.620Z",
  "customerDomain": "DOMAIN_NAME",
  "id": "CUSTOMER_ID",
  "kind": "admin#directory#customer",
  "language": "LANGUAGE_CODE",
  "postalAddress": {
    "contactName": "NAME",
    "countryCode": "COUNTRY_CODE",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE"
  }
}

后续步骤