新しいお客様アカウントを作成する前に、次の点に注意してください。
- 国コードの制限が適用される場合があります。お客様の 国が再販を許可されていることを確認するには、 Partner Sales Consoleをご確認ください。
- 個人用 Gmail アカウントからドメイン名付きのビジネス用メールにアップグレードしてアカウントを作成する場合は、アカウントで Google Workspace の追加設定のロックが解除されていることを確認してください。詳しくは、 「 チームのビジネス用メールアドレスを作成する」 および 「ビジネス用メール エイリアスを作成する」をご覧ください。
お客様アカウントを作成する
お客様アカウントを作成するには、次の
POSTリクエストを使用し、承認トークンを含めます。POST https://reseller.googleapis.com/apps/reseller/v1/customers新しいお客様のアカウント内に ユーザーを作成します。 レスポンスで HTTP
409 Conflictステータス コードが返された場合、customerIdはすでに存在します。お客様アカウントを登録する前に、お客様のサブスクリプションを 移行 する必要があります。必要に応じて、 お客様のデフォルトの言語を変更します。
ユーザーを特権管理者ロールに昇格させます。管理者アカウントを作成する際に、仮のランダムなパスワードを生成するか、お客様にパスワードの入力を求めることができます。
お客様に Google 管理コンソールにログインし、リセラー契約を使用して Google Workspace に署名してアカウントを有効にする必要があることを通知します。リセラーがお客様に代わって利用規約に署名することは禁止されています。
お客様の種類
Google Workspace では、次の 2 種類のお客様を作成できます。
- ドメインの所有権証明済みのお客様: 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"
}
}