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)

客户的第一管理员详细信息(如果客户是 TEAM 客户)。

地址

客户地址的 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 产品是否已获准转售 Google 产品。创建新客户时,此属性是必需的。

kind

string

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

region

string

region 值的一个示例是加利福尼亚州的 CA

addressLine2

string

地址的第 2 行。

locality

string

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

addressLine3

string

地址的第 3 行。

postalCode

string

postalCode 是邮政编码(例如 94043)示例。创建新客户时,此属性是必需的。

addressLine1

string

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

organizationName

string

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

contactName

string

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

客户类型

客户类型

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

主管理员

面向 TEAM 客户的主管理员的 JSON 模板

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

string

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

客户创建时,系统会将验证电子邮件发送到此电子邮件地址。主管理员有权访问客户的管理控制台,包括邀请和逐出用户以及管理客户的管理需求。

方法

get

获取客户帐号。

insert

订购新客户的帐号。

patch

更新客户帐号的设置。

update

更新客户帐号的设置。