建立新的客戶帳戶前,請考量下列幾點:
- 國家/地區代碼可能設有限制。確認客戶的 國家/地區獲準轉售,請查看 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
。這類客戶能夠 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" } }