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

地址的第 2 行。

locality

string

San Francisco 城市就是一个 locality 值的例子。

addressLine3

string

地址的第 3 行。

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

更新客户账号的设置。