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

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

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

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

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

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

CUSTOMER_ID は、お客様の一意の識別子またはドメイン名に置き換えます。

レスポンスの戻り値

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

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

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

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

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

    1. お客様のアカウントを注文する。
    2. ドメインの所有権証明済み顧客を作成するには、お客様に直接定期購入を購入してドメインの所有権を証明していただき、その後定期購入を移行していただきます。

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

    1. プライマリ ドメイン名と一意の Google 顧客 ID が一致しない古い顧客データがレコードに含まれていないことを確認します。削除されたアカウントが復元されると、新しい 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"
}