新しいお客様のアカウントを注文する

新しいお客様アカウントを作成する前に、次の点を考慮してください。

顧客アカウントを作成する

  1. 顧客アカウントを作成するには、次の POST リクエストを使用し、認証トークンを含めます。

    POST https://reseller.googleapis.com/apps/reseller/v1/customers

  2. 新しいお客様のアカウント内で、ユーザーを作成します。レスポンスで HTTP 409 Conflict ステータス コードが返された場合、customerId はすでに存在します。お客様のアカウントを登録する前に、お客様のサブスクリプションを移行する必要があります。

  3. 必要に応じて、お客様のデフォルト言語を変更します。

  4. ユーザーを特権管理者ロールに昇格させます。管理者アカウントを作成する際に、一時的なランダム パスワードを生成するか、お客様にパスワードの提供を求めることができます。

  5. アカウントを有効にするには、管理コンソールにログインして販売パートナー経由の Google Workspace 契約に署名する必要があることをお客様に通知します。販売パートナーがお客様に代わって利用規約に署名することは禁止されています。

顧客の種類

Google Workspace では、次の 2 種類のお客様を作成できます。

  • ドメインの所有権を証明済みのお客様。このようなお客様は 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: 顧客の一意の識別子（例: 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"
  }
}

次のステップ