REST Resource: customers

資源：Customer

如果 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 產生的專屬 ID。在要求中，這項資源可以是主網域或 Google 產生的專屬 ID。
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 產品。建立新顧客時必須提供這項屬性。
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

客戶的實際地址。地址可以一到三行，addressline2 和 addressLine3 為選用項目。
organizationName

string

公司或公司部門名稱。此為必要資訊。
contactName

string

客戶聯絡人的姓名。此為必要資訊。

CustomerType

客戶類型

列舉
customerTypeUnspecified 未知的顧客類型
domain 網域或擁有網域的客戶
team 無網域或已驗證電子郵件的客戶

PrimaryAdmin

對團隊客戶而言，主要管理員適用的 JSON 範本

JSON 表示法 
{
  "primaryEmail": string
}
欄位
primaryEmail

string

客戶主要管理員的商家電子郵件地址。

客戶建立時，電子郵件驗證連結會傳送至這個電子郵件地址。主要管理員可存取客戶的管理控制台，包括邀請及撤銷使用者，以及管理客戶的管理需求。

方法

get

 取得客戶帳戶。

insert

 訂購新客戶的帳戶。

patch

 更新客戶帳戶的設定。

update

 更新客戶帳戶的設定。