建立新客戶帳戶前,請考量以下事項:
- 可能會受到國家/地區代碼限制。如要確認客戶所在國家/地區是否核准轉售,請查看 Partner Sales Console。
- 如果您是從個人 Gmail 帳戶升級為含有網域名稱的企業電子郵件帳戶,請確認帳戶已解鎖其他 Google Workspace 設定。詳情請參閱「為團隊成員建立企業電子郵件地址」和「建立企業電子郵件別名」。
建立客戶帳戶
如要建立客戶帳戶,請使用下列
POST
要求,並附上授權權杖:POST https://reseller.googleapis.com/apps/reseller/v1/customers
在新客戶的帳戶中建立使用者。如果回應傳回 HTTP
409 Conflict
狀態碼,表示customerId
已存在。註冊客戶帳戶前,您必須轉移客戶的訂閱項目。如適用,請變更客戶的預設語言。
將使用者升級為超級管理員角色。建立管理員帳戶時,您可以產生隨機臨時密碼,或提示客戶提供密碼。
請通知客戶,他們必須登入管理控制台,並透過經銷商協議簽署 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
:客戶的 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" } }