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

Reseller API を使用してお客様の情報を取得して更新するには、次のいずれかの方法でお客様を検索します。

  • お客様の一意の識別子（例: 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"
}