訂購新客戶帳戶

建立新客戶帳戶前，請注意下列事項：

建立顧客帳戶

  1. 如要建立客戶帳戶，請使用下列 POST 要求，並附上授權權杖：

    POST https://reseller.googleapis.com/apps/reseller/v1/customers

  2. 在新客戶的帳戶中建立使用者。如果回應傳回 HTTP 409 Conflict 狀態碼，表示 customerId 已存在。註冊客戶帳戶前，請務必轉移客戶的訂閱方案。

  3. 視情況變更客戶的預設語言。

  4. 將使用者升級為超級管理員角色。建立管理員帳戶時，您可以產生臨時隨機密碼，也可以要求客戶提供密碼。

  5. 通知客戶必須登入 Google 管理控制台，並簽署 Google Workspace 經銷商協議，才能啟用帳戶。經銷商不得代表客戶簽署《服務條款》。

顧客類型

您可以在 Google Workspace 中建立兩種客戶：

  • 網域已驗證的客戶：這類客戶需要 Gmail 和完整的管理員存取權。建立這類顧客時，請將 customerType 設為 domain。
  • 已驗證電子郵件的客戶：這類客戶不擁有或管理網域。建立這類顧客時，請將 customerType 設為 team。這些客戶可以購買 Google Workspace 的 Google Workspace Essentials 和 Google Workspace Enterprise Essentials 版本。

以下是已驗證網域的客戶 JSON 要求主體範例：

{
  "customerDomain": "DOMAIN_NAME",
  "customerType": "domain",
  "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。

如果回應成功，系統會傳回 HTTP 200 狀態碼和新客戶的資訊：

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

以下 JSON 要求主體是經過電子郵件驗證的顧客範例：

{
  "customerDomain": "DOMAIN_NAME",
  "customerType": "team",
  "primaryAdmin": {
    "primaryEmail": "EMAIL_ADDRESS"
  },
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
 "alternateEmail": "EMAIL_ADDRESS"
}

如果回應成功，系統會傳回 HTTP 200 狀態碼和新客戶的資訊：

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

變更客戶的預設語言

客戶的預設語言只會套用至新使用者。更新預設語言後，現有使用者仍會保留原先的語言設定。因此，請先設定客戶預設語言，再建立任何使用者。

新客戶的預設語言為英文。如要變更預設語言，請使用 Directory API Customers 端點的 PATCH 或 UPDATE 方法。

使用 Directory API 更新客戶的預設 language 值：

PATCH https://reseller.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID

加入下列 JSON 要求主體：

{
  "language":"LANGUAGE_CODE"
}

更改下列內容：

  • CUSTOMER_ID：顧客的專屬 ID，例如 C0123456。
  • LANGUAGE_CODE：可接受的語言代碼，例如 es 代表西班牙文。

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

{
  "alternateEmail": "EMAIL_ADDRESS",
  "customerCreationTime": "2022-12-12T23:04:10.620Z",
  "customerDomain": "DOMAIN_NAME",
  "id": "CUSTOMER_ID",
  "kind": "admin#directory#customer",
  "language": "LANGUAGE_CODE",
  "postalAddress": {
    "contactName": "NAME",
    "countryCode": "COUNTRY_CODE",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE"
  }
}

後續步驟