アカウント サービスの変更に関するプッシュ通知を受け取る

ACCOUNT_SERVICE_CHANGE 通知を登録すると、AccountService リソースが作成、更新、削除されたときにリアルタイムでアラートを受け取ることができます。これは、マルチアカウント サービス関係を管理するサードパーティ プロバイダや企業にとって特に有益です。

アカウント サービスの変更をサブスクライブすると、API をポーリングすることなく、アカウント サービスの提案、承認、更新、削除をすぐに検出できます。

始める前に、通知サブ API の概要で説明されている要件に従ってコールバック URI が構成されていることを確認してください。

アカウント サービスの変更をサブスクライブする

アカウント サービスの変更を登録するには、registeredEvent を ACCOUNT_SERVICE_CHANGE に設定して、notificationsubscriptions リソースに POST リクエストを送信します。

特定のターゲット アカウントを登録する

次のサンプル リクエストは、特定の販売アカウントのアカウント サービスの変更を登録します。

POST https://merchantapi.googleapis.com/notifications/v1/accounts/{ACCOUNT_ID}/notificationsubscriptions/

{
  "registeredEvent": "ACCOUNT_SERVICE_CHANGE",
  "targetAccount": "accounts/{TARGETACCOUNT_ID}",
  "callBackUri": "https://example.com/callback"
}

次のように置き換えます。

  • ACCOUNT_ID: サブスクリプションを所有し、通知を受信するアカウントの識別子。
  • TARGETACCOUNT_ID: 通知を受け取るアカウントの識別子。

すべての子アカウントで登録する

複数の販売者アカウントを管理しているプロバイダと企業は、allManagedAccounts: true を設定することで、管理対象のすべてのアカウントでアカウント サービスの変更を購読できます。

POST https://merchantapi.googleapis.com/notifications/v1/accounts/{ACCOUNT_ID}/notificationsubscriptions/

{
  "registeredEvent": "ACCOUNT_SERVICE_CHANGE",
  "allManagedAccounts": true,
  "callBackUri": "https://example.com/callback"
}

呼び出しが成功すると、一意のサブスクリプション ID を含むサブスクリプションの name 識別子が返されます。

{
  "name":"accounts/{ACCOUNT_ID}/notificationsubscriptions/{SUBSCRIPTION_ID}",
  "registeredEvent": "ACCOUNT_SERVICE_CHANGE",
  "allManagedAccounts": true,
  "callBackUri": "https://example.com/callback"
}

アカウント サービスの変更ペイロードをデコードする

アカウント サービスの変更が発生すると、コールバック URI は base64 エンコードされたメッセージを受信します。デコードされたペイロードは ResourceChangeMessage 形式に準拠しています。

{
  "account": "accounts/{TARGETACCOUNT_ID}",
  "managingAccount": "accounts/{ACCOUNT_ID}",
  "resourceType": "ACCOUNT_SERVICE",
  "resource": "accounts/{TARGETACCOUNT_ID}/services/{SERVICE_ID}",
  "operation": "CREATE",
  "eventTime": "2026-08-25T10:00:00Z"
}

ペイロード フィールドとルール

  • account: 変更されたサービス エンティティ（accounts/{merchant_id}）を所有するターゲット アカウント。
  • managingAccount: 販売者のアカウント（accounts/{service_provider_id}）を管理するアカウント。
  • resourceType: 変更されたリソースタイプ（ACCOUNT_SERVICE）。
  • resource: アカウント サービスの完全なリソース名（accounts/{account}/services/{service} など）。
  • operation: リソースに対して実行されるオペレーション:
    • CREATE: 新しいアカウント サービスの関係が作成されました。
    • UPDATE: 既存のアカウント サービスの構成または権限が変更されました。
    • DELETE: アカウント サービスの関係が削除されました。
  • eventTime: イベントが生成された時点のタイムスタンプ。このタイムスタンプを使用して、イベントの順序が正しくなるようにします。

テスト アカウントのサービス変更通知

次のサンプル リクエストを使用して、コールバック エンドポイントがアカウント サービスの変更メッセージを正しく受信、確認、デコードするかどうかをテストします。

curl --request POST \
'https://{YOUR_CALLBACK_URI}' \
--header 'Content-Type: application/json' \
--header 'Accept: text/plain' \
--data '{"message":{"data": "ewogICJhY2NvdW50IjogImFjY291bnRzLzEyMzQiLAogICJtYW5hZ2luZ0FjY291bnQiOiAiYWNjb3VudHMvNTY3OCIsCiAgInJlc291cmNlVHlwZSI6ICJBQ0NPVU5UX1NFUlZJQ0UiLAogICJyZXNvdXJjZSI6ICJhY2NvdW50cy8xMjM0L3NlcnZpY2VzLzEyMyIsCiAgIm9wZXJhdGlvbiI6ICJDUkVBVEUiLAogICJldmVudFRpbWUiOiAiMjAyNi0wOC0yNVQxMDowMDowMFoiCn0="}}'

この呼び出しに応答して、コールバック URI は許容可能な HTTP ステータス コード（200 OK など）を返す必要があります。デコードされたメッセージには次の内容が含まれます。

{
  "account": "accounts/1234",
  "managingAccount": "accounts/5678",
  "resourceType": "ACCOUNT_SERVICE",
  "resource": "accounts/1234/services/123",
  "operation": "CREATE",
  "eventTime": "2026-08-25T10:00:00Z"
}
前へ
Product status changes