REST Resource: customers

资源:客户

当 Google 客户的账号通过转销商注册后,该客户的 Google 服务订阅将由此转销商管理。客户由主域名和实际地址描述。

JSON 表示法
{
  "customerId": string,
  "customerDomain": string,
  "postalAddress": {
    object (Address)
  },
  "phoneNumber": string,
  "alternateEmail": string,
  "resourceUiUrl": string,
  "customerDomainVerified": boolean,
  "kind": string,
  "customerType": enum (CustomerType),
  "primaryAdmin": {
    object (PrimaryAdmin)
  }
}
字段
customerId

string

此属性始终会作为 Google 生成的唯一标识符返回在响应中。在请求中,此属性可以是主要网域,也可以是 Google 生成的唯一标识符。

customerDomain

string

客户的主域名字符串。创建新客户时,customerDomain 是必填字段。添加客户时,请勿在域名中添加 www 前缀。

postalAddress

object (Address)

客户的地址信息。每个字段的字符数限制为 255 个字符。

phoneNumber

string

客户联系电话号码。必须以“+”开头,后跟国家/地区代码。号码的其余部分可以是连续的数字,也可以遵循电话本地格式惯例,但必须是真实的电话号码,例如“123”就不能用。如果此字段无效,系统会静默忽略。

alternateEmail

string

与转销商工具中的“客户电子邮件地址”一样,如果客户的服务发生问题(例如服务中断或安全问题),此电子邮件地址是辅助联系方式。在创建新的“网域”客户时,此属性为必填属性,且不应与 customerDomain 使用相同的网域。创建“团队”客户时,无需使用 alternateEmail 字段。

resourceUiUrl

string

指向客户管理控制台信息中心的网址。只读网址由 API 服务生成。如果您的客户端应用要求客户在管理控制台中完成任务,则需要使用此参数。

customerDomainVerified

boolean

客户的主域名是否已通过验证。

kind

string

将资源标识为客户。值:reseller#customer

customerType

enum (CustomerType)

用于标识客户的类型。可接受的值包括:

  • domain:表示通过域名验证的客户(默认)。
  • team:表示已通过电子邮件验证的客户。

如需了解详情,请参阅受管理的团队

primaryAdmin

object (PrimaryAdmin)

客户的第一位管理员的详细信息(如果客户为团队客户,则存在)。

地址

客户地址的 JSON 模板。

JSON 表示法
{
  "countryCode": string,
  "kind": string,
  "region": string,
  "addressLine2": string,
  "locality": string,
  "addressLine3": string,
  "postalCode": string,
  "addressLine1": string,
  "organizationName": string,
  "contactName": string
}
字段
countryCode

string

如需了解 countryCode 信息,请参阅 ISO 3166 国家/地区代码元素。确认相应国家/地区已获批准转销 Google 产品。创建新客户时,此属性为必填属性。

kind

string

将资源标识为客户地址。值:customers#address

region

string

region 值示例:加利福尼亚州的值为 CA

addressLine2

string

地址的第二行。

locality

string

locality 值的示例是城市 San Francisco

addressLine3

string

地址的第三行。

postalCode

string

postalCode 示例是邮政编码,例如 94043。创建新客户时,此属性为必填属性。

addressLine1

string

客户的实际地址。地址可以由 1 到 3 行组成。addressline2addressLine3 是可选的。

organizationName

string

公司或公司部门名称。这是必填字段。

contactName

string

客户联系人的姓名。这是必填字段。

CustomerType

客户类型

枚举
customerTypeUnspecified 客户类型未知
domain 拥有域名或域名所有权的客户
team 无域名或通过电子邮件地址验证的客户

PrimaryAdmin

适用于团队客户的主要管理员的 JSON 模板

JSON 表示法
{
  "primaryEmail": string
}
字段
primaryEmail

string

客户主管理员的企业电子邮件地址。

系统会在创建客户时向此电子邮件地址发送电子邮件验证链接。主要管理员可以访问客户的管理控制台,包括邀请和移除用户以及管理客户的管理需求。

方法

get

获取客户账号。

insert

为新客户订购账号。

patch

更新客户账号的设置。

update

更新客户账号的设置。