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

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

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

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

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

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

CUSTOMER_ID は、顧客の一意の識別子またはドメイン名に置き換えてください。

レスポンスが返すもの

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

  • 顧客のすべての設定を返す: 顧客は 既存の顧客です。販売パートナー 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. サブスクリプションを作成します 新規顧客アカウントの。

顧客の設定を更新する

販売パートナー 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"
}