在创建新客户账号之前,请考虑以下事项:
- 可能需要遵守国家/地区代码限制。如需确认客户所在的国家/地区是否已获准进行转销,请查看 Partner Sales Console。
- 如果该账号是通过从个人 Gmail 账号升级为包含域名的企业电子邮件账号而创建的,请确保该账号已解锁其他 Google Workspace 设置。如需了解详情,请参阅为您的团队创建企业电子邮件地址和创建企业电子邮件别名。
创建客户账号
如需创建客户账号,请使用以下
POST
请求并添加授权令牌:POST https://reseller.googleapis.com/apps/reseller/v1/customers
在新客户的账号中,创建用户。如果响应返回 HTTP
409 Conflict
状态代码,则表示customerId
已存在。在注册客户账号之前,您必须转移客户的订阅。更改客户的默认语言(如果适用)。
将用户提升为超级用户角色。创建管理员账号时,您可以生成临时随机密码,也可以提示客户提供密码。
请通知客户,他们必须登录管理控制台并签署“通过转销商购买 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" }
更改客户的默认语言
客户的默认语言仅会应用于在创建时为新用户设置的语言。即使您更新了默认语言,现有用户仍会保留其当前语言。因此,您必须先设置客户的默认语言,然后才能创建任何用户。
新创建的客户的默认语言为英语。如需更改默认语言,请使用 Directory API 客户端点中的 PATCH
或 UPDATE
调用。
使用 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" } }