擷取(&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. 如要建立網域驗證客戶，請要求客戶直接購買訂閱方案並驗證網域，然後轉移訂閱方案。

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

    1. 確認記錄中沒有舊的顧客資料，且主要網域名稱與不重複的 Google 顧客 ID 相符。已刪除的帳戶恢復後，系統會將其視為新帳戶，並指派新的 customerId。
    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"
}

更改下列內容：

  • DOMAIN_NAME：客戶的網域，例如 example.com。
  • NAME：客戶名稱，例如 Alex Cruz。
  • ORGANIZATION_NAME：客戶的機構名稱，例如 Example Organization。
  • POSTAL_CODE：顧客的郵遞區號，例如 94043。
  • 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"
}