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

如要使用經銷商 API 擷取及更新客戶資訊，您可以使用以下兩種方式查詢客戶：

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

擷取客戶的帳戶資訊

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

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

將 CUSTOMER_ID 換成客戶的唯一 ID 或網域名稱。

回覆傳回結果

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

  • 傳回完整的客戶設定。該客戶就是您其中一個現有客戶您可以使用經銷商 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. 為這個新客戶帳戶建立訂閱項目。

更新客戶的設定

使用經銷商 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：客戶的 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"
}