擷取(&A) 更新客戶帳戶和#39 的帳戶資訊

如要使用 Reseller API 擷取及更新客戶資訊，您可以透過下列任一方式查詢客戶：

  • 顧客的專屬 ID，例如 C0123456
  • 客戶的網域名稱，例如 example.com

擷取客戶的帳戶資訊

如要擷取客戶的帳戶資訊，請使用下列 GET 要求，並附上授權權杖：

GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

將 CUSTOMER_ID 替換成客戶的專屬 ID 或網域名稱。

回覆傳回

擷取顧客的帳戶資訊時，您可能會收到下列其中一種回應：

  • 傳回完整的顧客設定。顧客是你的現有顧客。您可以使用 Reseller API 管理這個客戶的帳戶和訂閱設定。

  • 傳回最少的客戶帳戶資訊。如果回應只傳回 customerId、customerDomain 和 customerType，表示客戶是由 Google 或其他經銷商管理。您無法為該顧客建立其他已驗證電子郵件的顧客。如要管理這名顧客，請按照下列步驟操作：

    1. 為客戶擷取所有可轉移的訂閱項目，瞭解訂閱項目是否可轉移，以及轉移的最低使用者席位數。
    2. 轉移訂閱方案。

  • 退貨 Multiple teams exist on this domain。這個網域與一或多個團隊客戶相關聯。如要將其他團隊新增至這個網域，請按照下列步驟操作：

    1. 訂購客戶帳戶。
    2. 如要為網域建立網域驗證客戶，請要求客戶透過 Google 購買直接訂閱方案並驗證網域、接管現有團隊，然後將訂閱方案轉移至您的帳戶。

  • 傳回 HTTP 404 錯誤。客戶是 Google 新手，沒有帳戶。如要管理這類客戶，請按照下列步驟操作：

    1. 確認顧客記錄中沒有舊顧客資料，以免顧客主要網域名稱與 Google 顧客專屬 ID 不符。復原先前刪除的 Google 帳戶時，系統會將其視為新帳戶，並指派新的 customerId 值，即使帳戶可能保留相同的 customerDomain 值也一樣。
    2. 訂購新的客戶帳戶。
    3. 為這個新客戶帳戶建立訂閱方案。

更新客戶的設定

使用 Reseller API 時，您無法更新 customerType，但可以驗證team客戶的網域，並成為domain客戶。

如要更新客戶的設定，請使用下列 PUT 要求，並加入客戶的專屬 ID：

PUT https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

JSON 要求主體會更新下列客戶設定：

{
  "customerId": "C0CUSTOMER_ID123456",
  "customerDomain": "DOMAIN_NAME",
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

更改下列內容：

  • ：客戶的網域，例如 example.comDOMAIN_NAME
  • NAME：客戶的姓名，例如 Alex Cruz。
  • ORGANIZATION_NAME：客戶機構的名稱，例如「Example Organization」。
  • ：顧客的郵遞區號，例如 94043。POSTAL_CODE
  • COUNTRY_CODE：顧客的 2 個字元 ISO 國家/地區代碼。
  • EMAIL_ADDRESS：顧客的電子郵件地址，例如 cruz@example.com。

如果 JSON 回應成功，系統會傳回 HTTP 200 狀態碼和更新後的客戶設定：

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME",
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}