ユーザーレベルおよび広告アカウントレベルの制限
ベストプラクティス
-
データベースに最後に同期したタイムスタンプを保存し、該当する場合は
sort_by=updated_at-descオプションを付けてデータをリクエストすることで、最後に同期したタイムスタンプより古いデータに達した時点で同期処理を停止できるようにします。これにより、同じデータの重複同期を回避できます。 - 1 回のリクエストで複数のエンティティを取得する: 一部の endpoint では、カンマ区切りの値リストを指定して、類似データをまとめて取得できます。これにより、総リクエスト数を削減し、レートリミットをより効率的に活用できます。
- リクエストでは「count」の最大値を指定する: GET accounts/:account_id/targeting_criteria などの endpoint では、デフォルトの 200 ではなく 1000 個のオブジェクトを返すため、count の最大値で呼び出すことを強く推奨します。
アナリティクスの同期
よくある質問
レートリミットのスコープ
このドキュメントにおけるスコープ
- Category: 指定されたカテゴリに属するすべての endpoint は、各ウィンドウにつき単一の割り当て上限内でレートリミットの対象となります。
- Endpoint: 各 endpoint には、各ウィンドウごとに個別の割り当て上限が設定されています。
X Ads API レートリミット一覧
X Ads API のレートリミット
| endpoint の種類 | endpoint またはカテゴリ単位のスコープ | 1分間ウィンドウあたりのレートリミット |
|---|---|---|
| 書き込み (POST, PUT, DELETE) | カテゴリ | 450 |
| オーディエンス | endpoint | 1500 |
| endpoint の種類 | endpoint またはカテゴリ単位のスコープ | 15分間ウィンドウあたりのレートリミット |
|---|---|---|
| 分析 (同期) | カテゴリ | 250 |
| コアエンティティの読み取り (Line Items、Campaigns など) その他のアカウントの読み取り (:account_id を含むその他の GET endpoint) | endpoint (広告アカウントレベル) endpoint (広告アカウントの一部レベル) | 10,000 2000 |
| ターゲティング条件 (下記以外) | カテゴリ | 400 |
| ターゲティング条件 (tv_markets、tv_shows) | endpoint | 2000 |
| オーディエンスインサイト | カテゴリ | 400 |
| キーワードインサイト | カテゴリ | 500 |
| グローバル読み取り (:account_id を含まない GET endpoint) | endpoint | 5 |
| コンバージョン | endpoint | 60,000 |