お客様のアカウント情報の取得と更新

Reseller API を使用して顧客情報を取得、更新するには、次の 2 つの方法で顧客を検索します。

  • お客様の一意の識別子（例: C0123456）
  • お客様のドメイン名（例: example.com）

顧客のアカウント情報を取得する

顧客のアカウント情報を取得するには、次の GET リクエストを使用し、認証トークンを含めます。

GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

CUSTOMER_ID は、お客様の固有の ID またはドメイン名に置き換えます。

レスポンスを返す

お客様のアカウント情報を取得すると、次のいずれかのレスポンスが返されることがあります。

  • 顧客の設定全体を返します。お客様は既存のお客様です。Reseller API を使用すると、このお客様のアカウントとサブスクリプションの設定を管理できます。

  • 最小限の顧客アカウント情報を返します。レスポンスで customerId、customerDomain、customerType のみが返された場合、お客様は Google または別の販売パートナーによって管理されています。メールアドレスが確認済みの顧客を、その顧客に対して新たに作成することはできません。このお客様を管理するには、次の手順に沿って操作します。

    1. お客様の移行可能なサブスクリプションをすべて取得して、サブスクリプションを移行できるかどうかと、移行に必要なユーザーシートの最小数を確認します。
    2. 定期購入を移行します。

  • Multiple teams exist on this domain を返します。このドメインには、1 つ以上のチームタイプのお客様が関連付けられています。このドメインに別のチームを追加する手順は次のとおりです。

    1. 顧客アカウントを注文する。
    2. ドメインの所有権証明済みの顧客を作成するには、お客様に Google から直接サブスクリプションを購入してドメインの所有権を証明し、既存のチームを引き継ぐようご案内し、その後 サブスクリプションをパートナーのアカウントに移行していただくようご案内します。

  • HTTP 404 エラーを返します。お客様は Google を初めて利用するため、アカウントをお持ちではありません。このお客様を管理するには、次の手順に沿って操作します。

    1. 顧客レコードに、顧客のプライマリ ドメイン名と一意の Google 顧客 ID が一致しない可能性のある古い顧客データが含まれていないことを確認します。以前に削除された Google アカウントが復元されると、新しいアカウントとして扱われ、アカウントが同じ customerDomain 値を保持していても、新しい customerId 値が割り当てられます。
    2. 新しいお客様アカウントを注文します。
    3. この新しいお客様アカウントのサブスクリプションを作成します。

顧客の設定を更新する

Reseller API を使用して customerType を更新することはできませんが、team のお客様のドメインを確認して domain のお客様になることはできます。

顧客の設定を更新するには、次の PUT リクエストを使用し、顧客の一意の識別子を含めます。

PUT https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

JSON リクエストの本文は、次の顧客設定を更新します。

{
  "customerId": "C0CUSTOMER_ID123456",
  "customerDomain": "DOMAIN_NAME",
  "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）。

成功した JSON レスポンスは、HTTP 200 ステータス コードと更新された顧客設定を返します。

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME",
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}