# アカウントアクティビティログへのプログラムによるアクセスを追加します ## 新機能 [アクティビティログ API](https://docs.stripe.com/api/v2/iam/activity-logs.md?api-version=2026-04-22.preview) を通じて、アカウントのセキュリティ履歴にプログラムでアクセスできるようになりました。API キーの管理、ユーザーの招待、役割の変更など、Stripe アカウント全体のセキュリティ関連アクティビティの詳細なログを取得できます。新しい API では、[アクティビティログを一覧表示](https://docs.stripe.com/api/v2/iam/activity-logs/list.md?api-version=2026-04-22.preview)エンドポイントが追加されました。このエンドポイントでは、フィルタリングオプションを指定して、アクティビティログのページ分割されたリストを取得できます。 API は次のアクションタイプを追跡します。 - **API キーアクション**: API キーの作成、削除、更新、表示 (`api_key_created`、`api_key_deleted`、`api_key_updated`、`api_key_viewed`) - **ユーザー招待アクション**: ユーザー招待の作成、削除、承諾 (`user_invite_created`、`user_invite_deleted`、`user_invite_accepted`) - **ユーザー役割アクション**: ユーザー役割の更新と削除 (`user_roles_updated`、`user_roles_deleted`) 各 [ActivityLog](https://docs.stripe.com/api/v2/iam/activity-logs/object.md?api-version=2026-04-22.preview) オブジェクトには、アクター、タイムスタンプ、影響を受けたリソース、コンテキストメタデータなど、イベントの詳細が含まれます。 ## 影響 Activity Logs API と連携して、セキュリティ監視と法令遵守のレポートを自動化するシステムを構築できます。これにより、以下が可能になります。 - セキュリティ監査のために API キーのライフサイクルイベントを監視する - ユーザーアクセスの変更とロールの変更を追跡する - 疑わしいアクティビティに対するカスタムアラートシステムを作成する - アクティビティデータを外部の SIEM システムと統合する 以前は、このセキュリティ情報はダッシュボードからのみ利用可能で、手動での確認が必要だったため、自動化機能が制限されていました。 アカウントのセキュリティ履歴にプログラムでアクセスする方法については、[アクティビティログ](https://docs.stripe.com/activity-logs.md)を参照してください。 ## 変更点 #### REST API | Endpoint | Change | Resource | | -------- | ------ | ------------------------------------------------------------------------------------------------------------ | | `list` | Added | [V2.Iam.ActivityLog](/api/v2/iam/activity-logs/object?api-version=2026-04-22.preview#v2_activity_log_object) | #### Ruby | Method | Change | Resource | | ------ | ------ | -------------------------------------------------------------------------------------------------------------- | | `list` | Added | [V2::Iam::ActivityLog](/api/v2/iam/activity-logs/object?api-version=2026-04-22.preview#v2_activity_log_object) | #### Python | Method | Change | Resource | | ------ | ------ | ------------------------------------------------------------------------------------------------------------ | | `list` | Added | [v2.iam.ActivityLog](/api/v2/iam/activity-logs/object?api-version=2026-04-22.preview#v2_activity_log_object) | #### PHP | Method | Change | Resource | | ------ | ------ | ------------------------------------------------------------------------------------------------------------ | | `all` | Added | [V2.Iam.ActivityLog](/api/v2/iam/activity-logs/object?api-version=2026-04-22.preview#v2_activity_log_object) | #### Java | Method | Change | Resource | | ------ | ------ | ------------------------------------------------------------------------------------------------------------ | | `list` | Added | [v2.iam.ActivityLog](/api/v2/iam/activity-logs/object?api-version=2026-04-22.preview#v2_activity_log_object) | #### Node.js | Method | Change | Resource | | ------ | ------ | ------------------------------------------------------------------------------------------------------------ | | `list` | Added | [V2.Iam.ActivityLog](/api/v2/iam/activity-logs/object?api-version=2026-04-22.preview#v2_activity_log_object) | #### Go | Method | Change | Resource | | ------ | ------ | ---------------------------------------------------------------------------------------------------------- | | `List` | Added | [V2IamActivityLog](/api/v2/iam/activity-logs/object?api-version=2026-04-22.preview#v2_activity_log_object) | #### .NET | Method | Change | Resource | | ------ | ------ | ------------------------------------------------------------------------------------------------------------ | | `List` | Added | [V2.Iam.ActivityLog](/api/v2/iam/activity-logs/object?api-version=2026-04-22.preview#v2_activity_log_object) | ## アップグレード #### REST API 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。 - SDK を使用していない場合は、`Stripe-Version: 2026-04-22.preview` を含めるように [API リクエスト](https://docs.stripe.com/api/versioning.md)を更新してください。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Ruby 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Ruby SDK を 最新バージョンにアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Python 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Python SDK を 最新バージョンにアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### PHP 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. PHP SDK を 最新バージョンにアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Java 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Java SDK を 最新バージョンにアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Node.js 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Node SDK を 最新バージョンにアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Go 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Go SDK を 最新バージョンにアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### .NET 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. .NET SDK を 最新バージョンにアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。