レート制限

Advertiser API には、REST API v1.1 におけるレート制限で説明されているのと同様のレート制限が適用されます。REST API v1.1 と異なり、エンドポイントごとの制限のプログラム的な一覧は提供されていません。エンドポイントのレート制限とリセットウィンドウは、HTTP レスポンスヘッダーで通知されます。Ads API におけるすべてのレート制限は OAuth 1.0A を利用します。

ユーザーレベルと広告アカウントレベルの制限

レート制限には、ユーザートークンレベルと広告アカウントレベルの2種類があります。エンドポイントの一部は広告アカウントレベルのレート制限に対応しています。ユーザートークンとは、認証して Ads API を呼び出すために使用する OAuth access token です。各ユーザートークンは、1つ以上の広告アカウントにアクセスできます。開発者は、レスポンスヘッダーに広告アカウントレベルのレート制限が返される場合はそれを使用し、見つからない場合にのみユーザーレベルの制限を使用してください。ユーザーレベルのレート制限は、次のヘッダーで示されます: x-rate-limit-limit、x-rate-limit-remaining、x-rate-limit-reset 広告アカウントレベルのレート制限が有効なエンドポイントでは、レート制限は次のヘッダーで示されます: x-account-rate-limit-limit、x-account-rate-limit-remaining、x-account-rate-limit-reset。広告アカウントレベルのレート制限は、単一のユーザートークンが複数の広告アカウントにアクセスしてエンティティのデータ（キャンペーンやラインアイテムなど）を同期できるように、GET エンドポイントに対してのみ提供されます。書き込み操作が同じ広告アカウントレベルのレート制限を使用することは保証されません。広告アカウントレベルのレート制限が適用されるエンドポイントでは、ユーザーレベルのレート制限はアプリケーション全体のグローバルなクォータを表す高い値に設定されています。利用可能な場合は、リクエスト量の制御において広告アカウントレベルのレート制限を優先してください。

ベストプラクティス

データベースに最後に同期したタイムスタンプを保存し、該当する場合はデータをリクエストする際に sort_by=updated_at-desc オプションを使用して、最後に同期したタイムスタンプより古いデータに到達した時点で同期処理を停止できるようにします。これにより、同じデータを重複して同期することを回避できます。
1回のリクエストで複数のエンティティをリクエストする: 一部のエンドポイントでは、カンマ区切りの値のリストを指定して、類似する複数のデータを取得できます。これにより、実行する呼び出しの総数を減らし、レート制限をより効率的に活用できます。
リクエストでは「count」の最大値を指定する: GET accounts/:account_id/targeting_criteria のような一部のエンドポイントは、デフォルトの200ではなく1000個のオブジェクトを返すために、countの最大値で呼び出すことが強く推奨されます。

Analytics の同期

Analytics エンドポイントのレート制限の詳細は、Analytics レート制限ガイドをご参照ください。

よくある質問

特定の広告アカウントまたは当社のアプリのレート制限を引き上げることは可能ですか？ 一般的にレート制限を引き上げることはできません。これは最大規模の広告アカウントをサポートするように設定されています。まずは本ドキュメントに記載のベストプラクティスを実装してください。それでもレート制限がスケールや事業目標の達成に影響する場合は、ユースケースおよび関連するリクエストの詳細を添えて、X Ads API の担当窓口までご連絡ください。