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

locality 值的範例為 San Francisco 城市。
addressLine3

string

地址的第 3 行。
postalCode

string

postalCode 範例為郵遞區號 (例如 94043)。建立新客戶時必須選取這個屬性。
addressLine1

string

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

string

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

string

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

客戶類型

客戶的類型

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

主要管理員

如果您是 TEAM 客戶，主要管理員的 JSON 範本

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

string

客戶主要管理員的企業電子郵件。

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

方法

get

 取得客戶帳戶。

insert

 訂購新客戶的帳戶。

patch

 更新客戶帳戶的設定。

update

 更新客戶帳戶的設定。