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

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

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

始める前に、Notifications サブ 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