シートサービス
重要
この機能は現在、クローズド ベータ版です。 参加に興味がある場合は、Xandr の担当者にお問い合わせください。
購入者シート ID 製品を使用すると、外部入札者は Xandr メンバー ID を使用するのではなく、カスタム購入者 ID で入札できます。 これにより、外部の入札者は、Xandr インベントリに入札するときに、独自のシステムから購入者 ID を利用でき、よりシームレスなレポートと取引の設定が可能になります。
シート サービスは、入札者の新しいシートを登録するために使用されるまったく新しい API サービスです。 これは、API への呼び出し後に手動で行うか、入札者が入札応答で新しいシート ID で入札したときにリアルタイムで行うことができます。
シートサービスは、入札者の座席 ID を格納するために使用されます。 これらのシート ID は、入札応答で使用され、トランザクション レポートに記録されます。
HTTP メソッド | エンドポイント | 説明 |
---|---|---|
GET | https://api.adnxs.com/seat/BIDDER_ID |
入札者にアタッチされているすべてのシートを表示するには |
GET | https://api.adnxs.com/seat/BIDDER_ID/SEAT_ID |
API シート識別子を使用して既存のシートを表示するには |
取得 | https://api.adnxs.com/seat?bidder_id=BIDDER_ID&code=SEATCODE |
API bidder シート ID を使用して既存のシートを表示するには |
POST | https://api.adnxs.com/seat/BIDDER_ID |
新しいシートを追加する |
PUT | https://api.adnxs.com/seat/BIDDER_ID/SEAT_ID |
API シート識別子を使用して既存のシートを変更する |
PUT | https://api.adnxs.com/seat?bidder_id=BIDDER_ID&co6de=SEATCODE |
bidder シート ID を使用して既存のシートを変更する |
フィールド | 種類 | 説明 |
---|---|---|
bidder_id |
int | 入札者の ID。 これは読み取り専用フィールドです。 |
code |
string | Bidder シート ID。 |
id |
int | シートの ID。 これは読み取り専用フィールドです。 |
name |
string | このシートの購入者の名前。 注: 自動登録シートでは、標準の名前付け規則が seat_codeされます (入札者名) |
次の API 呼び出しの例は、新しいシートをアップロードしたり、既存のシートを編集したりする方法を示しています。
$ cat seats.json
{
"seats": [{
"bidder_id": 1,
"code": "sdfg54VVsh",
"name": "sdfg54VVsh(Bidder)"
},
{
"bidder_id": 129,
"code": "54Gfa762Gbse",
"name": "54Gfa762Gbse(Bidder)"
}
]
}
$ curl -b cookies -c cookies -X POST -d @seats.json "https://api.adnxs.com/seat/1"
{
"response": {
"status": "OK",
"num_elements": 100,
"seats": [
{
"bidder_id": 1,
"code": "sdfg54VVsh",
"created_on": "2018-12-13 15:31:13",
"id": 11,
"last_activity": "2018-12-13 15:31:13",
"name": "sdfg54VVsh(Bidder)"
},
{
"bidder_id": 1,
"code": "54Gfa762Gbse",
"created_on": "2018-12-13 17:09:26",
"id": 22,
"last_activity": "2018-12-13 17:09:26",
"name": "54Gfa762Gbse(Bidder)"
}
]
}
}
$ cat seats.json
{
"seats": [{
"bidder_id": 1,
"code": "sdfg54VVsh",
"name": "Bidder seat name"
}
]
}
$ curl -b cookies -c cookies -X PUT -d @seats.json "https://api.adnxs.com/seat/1/11"
{
"response": {
"status": "OK",
"num_elements": 100,
"seats": [
{
"bidder_id": 1,
"code": "sdfg54VVsh",
"created_on": "2018-12-13 15:31:13",
"id": 11,
"last_activity": "2018-12-13 15:31:13",
"name": "Bidder seat name"
}
]
}
}
$ curl -b cookies -c cookies -X GET "https://api.adnxs.com/seat/1/22"
{
"response": {
"status": "OK",
"num_elements": 100,
"seats": [
{
"bidder_id": 1,
"code": "54Gfa762Gbse",
"created_on": "2018-12-13 17:09:26",
"id": 22,
"last_activity": "2018-12-13 17:09:26",
"name": "54Gfa762Gbse(Bidder)"
}
]
}
}
$ curl -b cookies -c cookies -X GET "https://api.adnxs.com/seat/1"
{
"response": {
"status": "OK",
"num_elements": 100,
"seats": [
{
"bidder_id": 1,
"code": "sdfg54VVsh",
"created_on": "2018-12-13 15:31:13",
"id": 11,
"last_activity": "2018-12-13 15:31:13",
"name": "sdfg54VVsh(Bidder)"
},
{
"bidder_id": 1,
"code": "54Gfa762Gbse",
"created_on": "2018-12-13 17:09:26",
"id": 22,
"last_activity": "2018-12-13 17:09:26",
"name": "54Gfa762Gbse(Bidder)"
}
]
}
}