次の方法で共有

API の使用の制約

  • [アーティクル]

入力と出力の調整

優れたパフォーマンスを確保するために、すべてのアカウントは 1 分あたり 100 回の読み取りと 1 分あたり 60 回の書き込みに制限されます。 この制限は、メンバー レベルの API によってプログラムによって適用されます。 つまり、1 人のメンバーに対して 2 人の API ユーザーが存在する場合、調整制限を共有します (つまり、2 人のユーザーが 1 分あたり平均 50 読み取りを行い、4 人のユーザーが 1 分あたり平均 25 読み取りを行うことができます)。 1 分あたりの読み取りまたは書き込みが必要な場合は、Xandr アカウントの担当者にお問い合わせください。

すべての応答には、 "dbg_info" API 呼び出しと応答に関する情報を伝達するオブジェクトが含まれます。これは Xandr 内部でのみ使用され、サポートの問い合わせ中に要求される可能性があります。

改ページ

指定された GET 応答で返すことができるオブジェクトの最大数は 100 です。 100 を超えるオブジェクトを取得するには、GET 要求のクエリ文字列に と num_elements をstart_element指定して、結果を改ページ処理できます。 たとえば、次の要求は、応答の最初の 50 個のオブジェクトを返します。

$ curl -b cookies -c cookies 'https://api.adnxs.net/creative?start_element=0&num_elements=50'

次の 50 を取得するには、 を設定 start_element=50するだけです。

  • 最初の要素は要素 0 です。
  • すべての GET 応答には、その GET 要求に一致する要素の合計数を示す "count" プロパティがあります。
  • これは、GET 以外の方法で要求されるクリエイティブ検索サービスなどのレポート以外のサービスにも適用されます。

例

$ curl -b cookies -c cookies 'https://api.adnxs.net/segment/1?start_element=0&num_elements=100'
$ curl -b cookies -c cookies 'https://api.adnxs.net/creative/1?start_element=0&num_elements=100'

認証頻度

認証後、トークンは 2 時間有効なままになります。 この時間内に再認証する必要はありません。 再認証を行う場合は、API を使用すると、5 分間に 10 回正常に認証できることに注意してください。 この 5 分以内にそれ以降の認証が試行されると、エラーが発生します。

ヒント

呼び出し応答で "NOAUTH" error_idを検索し、受信した後にのみ再認証することをお勧めします。

オブジェクトの制限

Xandr は、プラットフォームで使用できる期限切れでないクリエイティブの数を制限します。 さらに、Xandr では、1 つのドメイン リストで使用できるドメインの数と、1 つのプロファイルで使用できる特定のターゲットの数が制限されます。 クリエイティブを除くすべてのオブジェクト タイプでは、アクティブオブジェクトと非アクティブオブジェクトの両方が制限に対してカウントされます。 クリエイティブの場合、期限切れでないオブジェクトのみが制限に対してカウントされます。 クリエイティブは、45 日以内に配信も変更もされていない場合に有効期限が切れます。

ヒント

オブジェクト制限サービスを使用すると、制限を表示し、使用状況を事前に監視できます。 また、オブジェクトの制限に関してよく寄せられる質問については、「 オブジェクトの制限 - FAQ」を参照してください。