インベントリ項目サービスの検証
inventory-list/validate-inventory-item
サービスは、インベントリ リストで提供するアプリ バンドル ID や生の URL (ドメインまたはアプリ) が現在 Xandr でサポートされているかどうかを判断するために使用されます。 このサービスは、これらの URL とアプリ ID が適切に形成され、サポートされているかどうかを検証し、Xandr ポリシーに違反しているかどうかを示します。
REST API
HTTP メソッド | エンドポイント | 説明 |
---|---|---|
POST |
https://api.appnexus.com/inventory-list/validate-inventory-item (インベントリ リスト JSON) |
インベントリ項目の一覧を検証します。 |
JSON フィールド
フィールド | 種類 | 説明 |
---|---|---|
is_valid |
ブール値 | アプリまたはドメインが適切に形成されているかどうかを示します (HTTP または HTTPS プロトコルを使用する場合など)。
true 場合は、適切に形成されます。 |
is_supported |
ブール値 | アプリまたはドメインが現在 Xandr でサポートされているかどうかを示します (つまり、アプリまたはドメインが監査されているかどうかを示します)。
true 場合はサポートされます。 |
url |
string | 検証するアイテム (ドメインまたはアプリ) に指定した未加工の URL またはアプリ バンドル ID。 必須: POST |
inventory_url |
string | 検証されたアプリまたはドメインの URL。 |
inventory_url_id |
int | インベントリ URL に割り当てられた ID。
inventory_url_id にnull 値がある場合は、インベントリがまだ承認されていないことを意味します。 |
audit_status |
列挙 | ドメインまたはアプリの現在の監査状態。 使用可能な値は次のとおりです。 - audited : ドメインまたはアプリが Xandr インベントリ監査に合格しました。- rejected : ドメインまたはアプリが Xandr インベントリ監査に失敗しました (Xandr ポリシー違反が原因)。 |
app_name |
string | モバイル アプリケーションの名前。 インベントリアイテムがドメインの場合は、 null 値が表示されます。 |
rejection_reason |
string | [audit_status ] フィールドが [rejected ] に設定されている場合に、このドメインまたはアプリが Xandr ポリシー (Violence など) に違反している理由。
audit_status フィールドがrejected に設定されていない場合、このフィールドはnull されます。 |
is_parent_domain |
ブール値 | ドメインにサブドメインも含まれるかどうかを示します。 |
例
インベントリ項目の一覧を検証する
この例では、インベントリ項目の一覧を検証します。
$cat validate-inventory-item
{
"inventory-items": [{
"url": "yahoo.com"
},
{
"url": "breitbart.com"
}
]
}
curl -b cookies -X POST -d @validate-inventory-item "https://api.appnexus.com/inventory-list/validate-inventory-item"
{
"response": {
"status": "OK",
"inventory-items": [
{
"is_valid": true,
"is_supported": true,
"inventory_url": "yahoo.com",
"inventory_url_id": 640,
"app_name": null,
"audit_status": "audited",
"rejection_reason": null,
"is_parent_domain": true,
"visits": null
},
{
"is_valid": true,
"is_supported": true,
"inventory_url": "breitbart.com",
"inventory_url_id": 678,
"app_name": null,
"audit_status": "rejected",
"rejection_reason": "Hate Speech",
"is_parent_domain": false,
"visits": null
}
]
}
}