ProfileBioUpdate や ProfilePictureUpdate など関心のあるイベントを購読し、対象ユーザーの User ID でフィルタリングできます。該当するイベントは、その User ID に対してサブ秒レイテンシでアプリに配信されます。
X Activity API はオープンベータとして提供されています。オープンベータ期間中は、不具合、破壊的変更、未完成の機能が含まれる可能性があります。皆さまからのフィードバックは非常に貴重です。問題は developer community forums でご報告ください。
配信メカニズム
- 永続的な HTTP ストリーミング
- Webhook
サポートされているイベントタイプ
| カテゴリ | イベント名 | 説明 |
|---|---|---|
| プロフィール | ProfileBioUpdate | ユーザーがプロフィールの自己紹介を更新したときにトリガーされます |
| プロフィール | ProfilePictureUpdate | ユーザーがプロフィール画像を更新したときにトリガーされます |
| プロフィール | ProfileBannerUpdate | ユーザーがプロフィールバナーを更新したときにトリガーされます |
| プロフィール | ProfileGeoUpdate | ユーザーがプロフィールの位置情報を更新したときにトリガーされます |
| プロフィール | ProfileUrlUpdate | ユーザーがプロフィールのウェブサイト URL を更新したときにトリガーされます |
| プロフィール | ProfileScreennameUpdate | ユーザーが表示名を更新したときにトリガーされます |
| プロフィール | ProfileVerifiedBadgeUpdate | ユーザーが認証バッジを更新したときにトリガーされます |
注: XAA はポストを配信しません。リアルタイムのポスト配信については、開発者がリアルタイムでポストをフィルタリングおよびストリーミングできる Filtered Stream エンドポイントをご確認ください。
イベントのプライバシーと認証
公開イベント
- プロフィール更新（自己紹介、画像、バナー、所在地、URL、ユーザー名の変更）
プライベートイベント
- ユーザーは OAuth 2.0 を用いてあなたのアプリケーションで認証を行う必要があります
- あなたのアプリケーションは適切な OAuth スコープを取得する必要があります
- ユーザーはあなたのアプリによるこれらのイベントへのアクセスを明示的に許可する必要があります
- プライベートイベントのサブスクリプションは、あなたのアプリケーションを承認したユーザーに対してのみ作成できます
サブスクリプション上限
| パッケージのティア | 最大サブスクリプション数 |
|---|---|
| Free | 利用不可 |
| Basic | 50 |
| Pro | 2,500 |
| Enterprise | 20,000 |
| Partner | 100,000 |
アカウントの設定これらのエンドポイントにアクセスするには、以下が必要です。
- 承認済みの開発者アカウント
- Project 内にあるDeveloper Appのキーとトークンを使用した認証