訂購新客戶帳戶

建立新的客戶帳戶前,請考量下列幾點:

建立客戶帳戶

  1. 如要建立客戶帳戶,請使用以下 POST 要求並 包含授權權杖:

    POST https://reseller.googleapis.com/apps/reseller/v1/customers
    
  2. 在新客戶的帳戶中, 建立使用者。 如果回應傳回 HTTP 409 Conflict 狀態碼, customerId已存在,在註冊客戶帳戶之前,您必須 轉移客戶的訂閱

  3. 如果情況適用,請變更客戶的預設語言

  4. 宣傳 使用者授予超級管理員角色。 建立管理員帳戶時,您可以 隨機密碼或提示客戶提供密碼

  5. 通知客戶,他們必須登入管理控制台, 如要啟用,請先透過經銷商簽署 Google Workspace 協議 他們的帳戶。經銷商不得在 簽署《服務條款》 代表客戶

顧客類型

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

  • 已驗證網域的客戶。這些客戶需要 Gmail, 完整的管理員權限。建立這類客戶時,請設定 customerTypedomain
  • 已驗證電子郵件的客戶。這些客戶不是 網域。建立這類客戶時,請將 customerType 設為 team。這類客戶能夠 Essentials 和 Enterprise Essentials Google Workspace 版本。

下列 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 狀態碼,以及新客戶的 每個 ACL 都由一或多個項目組成 而這些項目包含兩項資訊

{
  "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 狀態碼,以及新客戶的 每個 ACL 都由一或多個項目組成 而這些項目包含兩項資訊

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

變更客戶的預設語言

客戶的預設語言只會套用到符合下列條件的使用者 已建立。即使您之後,現有使用者仍會保有目前的語言 更新預設語言。因此,你必須將客戶預設值 再建立一個使用者

新建立的客戶預設語言為英文。如要變更 預設語言,請使用 PATCH敬上 或 UPDATE。 從 Directory API 發出呼叫 客戶 端點

使用 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"
  }
}

後續步驟