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 行组成。addressline2 和 addressLine3 是可选的。
organizationName

string

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

string

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

CustomerType

客户类型

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

PrimaryAdmin

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

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

string

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

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

方法

get

 获取客户账号。

insert

 为新客户订购账号。

patch

 更新客户账号的设置。

update

 更新客户账号的设置。