订购新客户帐号

在创建新的客户帐号之前,请考虑以下事项:

创建客户帐号

  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:客户的 ISO 国家/地区代码(由 2 个字符组成)。
  • 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"
}

更改客户的默认语言

客户的默认语言仅在创建新用户时才会应用。即使您更新了默认语言,现有用户仍会保留其当前语言。因此,您必须先设置客户默认语言,然后才能创建用户。

新创建的客户的默认语言为英语。如需更改默认语言,请使用 Directory API Customers 端点中的 PATCHUPDATE 调用。

使用 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"
  }
}

后续步骤