擷取(&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"
}

更改下列內容：

  • 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"
}