在创建新的客户帐号之前,请考虑以下事项:
- 可能需要遵守国家/地区代码限制。如需确认客户所在的国家/地区是否已获准转销,请查看 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
:客户的 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 端点中的 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" } }