Reseller API を使用してお客様の情報を取得および更新するには、次の 2 つの方法のいずれかでお客様を検索します。
- 顧客の一意の識別子(例:
C0123456
) - お客様のドメイン名(例:
example.com
)
お客様のアカウント情報を取得する
お客様のアカウント情報を取得するには、次の GET
リクエストを使用して認証トークンを含めます。
GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID
CUSTOMER_ID
は、顧客の一意の識別子またはドメイン名に置き換えます。
レスポンスの戻り値
お客様のアカウント情報を取得すると、次のいずれかのレスポンスが返されます。
顧客の設定全体を返します。このお客様は既存のお客様の一人です。Reseller API を使用して、このお客様のアカウントとサブスクリプションの設定を管理できます。
最小限の顧客アカウント情報を返します。レスポンスで
customerId
、customerDomain
、customerType
のみが返された場合は、Google または別の販売パートナーがお客様を管理しています。メールによる確認済みのお客様を新たに作成することはできません。このお客様を管理する手順は次のとおりです。- お客様の移行可能なすべてのサブスクリプションを取得して、サブスクリプションを移行できるかどうかと、移行の対象となるユーザーの最小数を確認します。
- サブスクリプションを移行します。
Multiple teams exist on this domain
を返します。このドメインには、1 つまたは複数のチームお客様が関連付けられています。このドメインに別のチームを追加する手順は次のとおりです。- お客様アカウントを注文します。
- ドメインの所有権証明済みのお客様を作成するには、Google 経由で直接サブスクリプションを購入してドメインの所有権を証明し、既存のチームを引き継いで、サブスクリプションをお客様のアカウントに移行するようお客様に依頼します。
HTTP
404
エラーを返します。お客様は Google を初めて利用し、アカウントを持っていない。このお客様を管理する手順は次のとおりです。- 顧客のプライマリ ドメイン名と一意の Google 顧客 ID が一致しない古い顧客データが顧客レコードに保持されていないことを確認します。以前に削除した Google アカウントが復元されると、そのアカウントが同じ
customerDomain
値を保持している場合でも、新規アカウントとして扱われ、新しいcustomerId
値が設定されます。 - 新規のお客様アカウントを注文します。
- この新しいお客様アカウントにサブスクリプションを作成します。
- 顧客のプライマリ ドメイン名と一意の Google 顧客 ID が一致しない古い顧客データが顧客レコードに保持されていないことを確認します。以前に削除した Google アカウントが復元されると、そのアカウントが同じ
顧客の設定を更新する
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" }