訂購新客戶帳戶

建立新的客戶帳戶前,請先考量以下事項:

建立客戶帳戶

  1. 如要建立客戶帳戶,請使用下列 POST 要求並加入授權權杖:

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

  3. 在適用情況下,變更客戶的預設時區

  4. 使用者升級為超級管理員角色。建立管理員帳戶時,您可以產生臨時的隨機密碼,或提示客戶提供密碼。

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

顧客類型

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

  • 已驗證網域的客戶:這些客戶需要 Gmail 且需要完整的管理員權限建立這類客戶時,請將 customerType 設為 domain
  • 已驗證電子郵件的客戶。這些客戶不是他們擁有或管理的網域。建立這類客戶時,請將 customerType 設為 team。這類客戶可購買 Google Workspace 的 Essentials 和 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:客戶的 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「客戶」端點中的 PATCHUPDATE 呼叫。

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

後續步驟