ログ サービスの変更

概要

読み取り専用の変更ログおよび変更ログ詳細サービスは、一連のオブジェクトに対して行われた変更に関する情報を取得するために、他のサービス (以下に示す) と組み合わせて使用されます。 このページでは、これら 2 つのサービスを使用して、関心のあるログに記録された変更の一覧を取得する方法について説明します。 変更ログ サービスは、 "member"、 "advertiser"、または "member_advertiser" ユーザーの種類を持つユーザーのみが使用できます。

変更の ID を取得するための REST API

変更ログ サービスの JSON フィールド

エンドポイントへの入力として受け入れられるフィールド

エンドポイントからの応答で返されるフィールド

変更の詳細を取得するための REST API

変更ログの詳細サービスの JSON フィールド

変更ログの詳細サービスでエンドポイントへの入力として受け入れられるフィールド

変更ログの詳細サービスのエンドポイントからの応答で返されるフィールド

changes オブジェクト

例

を使用して変更ログの詳細を取得する GET

手順 1: /change-log を呼び出して、目的のトランザクションを取得する resource_id

GET を /change-logします。

$ curl -b cookies 'https://api.appnexus.com/change-log?service=line-item&resource_id=13984849'
{
"response": {
"change_logs": [
{
"transaction_id": "4ba6d032-68ef-544e-9f01-49aa6b36b0b4",
"created_on": "2021-02-12 15:24:27",
"resource_id": 13984849
},
{
"transaction_id": "0ee74310-f580-5001-8007-2f71f84a5454",
"created_on": "2021-02-12 15:14:50",
"resource_id": 13984849
}
],
"start_element": 0,
"num_elements": 100,
"count": 2,
"status": "OK"
}
}

GETパラメーターを使用して/change-log"additional_fields"します。

$ curl -b cookies 'https://api.appnexus.com/change-log?service=line-item&resource_id=13984849&additional_fields=request_source,user_id,object_json'
{
"response": {
"change_logs": [
{
"transaction_id": "2b11b163-c8a6-5c8b-b3d2-6e580d41d929",
"object_json": "{\"id\":13984849,\"code\":null,...}",
"created_on": "2021-03-03 17:05:53",
"user_id": [redacted],
"resource_id": 13984849,
"request_source": "LIAA-blkupld"
},
...
],
"start_element": 0,
"num_elements": 1,
"count": 1,
"status": "OK"
}
}

手順 2: を使用して /change-log-detail を呼び出す transaction_id

GET を /change-log-detailします。

$ curl -b cookies 'https://api.appnexus.com/change-log-detail?service=line-item&transaction_id=0ee74310-f580-5001-8007-2f71f84a5454'
{
"response": {
"change_log_details": [
{
"transaction_id": "0ee74310-f580-5001-8007-2f71f84a5454",
"member_id": 364,
"raw_json": "{\"line-item\":{\"advertiser_id\":4143132,\"currency\":\"GBP\",...}",
"plugin_id": "",
"method": "PUT",
"changes": [
{
"field_name": "advertiser_id",
"old_value": 4143132,
"new_value": 4143132,
"changed": false
},
...
],
"session_id": "authn:234473:42824ee8a5453:nym2",
"internal_txn": false,
"url": "https://hbapi-proxy-production/line-item?id=13984849&advertiser_id=4143132",
"request_source": "LIAA-blkupld",
"num_of_changes": 2,
"created_on": "2021-03-03 17:05:53",
"user_id": [redacted int value],
"modified_by_admin": true,
"admin_id": 0,
"user_full_name": "Test User",
"resource_id": 13984849,
"client_ip": "[redacted]",
"ip_info": "[redacted]"
}
],
"start_element": 0,
"num_elements": 1,
"count": 1,
"status": "OK"
}
}

を使用して変更ログの詳細を取得する POST

手順 1: JSON 形式の変更ログ要求を作成する

JSON ファイルには、表示する変更ログの service と resource_id 、変更ログを特定の期間に制限するための min_timestamp と max_timestamp が含まれている必要があります。 クエリ文字列で start_element または num_elements を使用することもできます。

JSON を作成します。

$ cat change-log.json
{
"change-log" : {
"service" : "advertiser",
"resource_id": "5260730",
"min_timestamp" : "2021-03-03 17:00:00",
"max_timestamp" : "2021-03-03 18:00:00"
}
}

手順 2: 変更ログ サービスに要求を POST する

POST transaction_idを含む基本的な変更ログ情報を取得するための JSON 要求。

POST を /change-logします。

$ curl -b cookies -X POST -d @change-log.json 'https://api.appnexus.com/change-log'
{
"response": {
"change_logs": [
{
"transaction_id": "016ac252-aa30-5d10-a7a0-b5b3d88df832",
"created_on": "2021-03-03 17:16:07",
"resource_id": 5260730
}
],
"start_element": 0,
"num_elements": 100,
"count": 1,
"status": "OK"
}
}

手順 3: JSON 形式の変更ログ詳細要求を作成する

JSON ファイルには、詳細を表示する変更ログの service と transaction_id が含まれている必要があります。

JSON を作成します。

$ cat change-log-detail.json
{
"change-log-detail" : {
"service" : "advertiser",
"transaction_id": "016ac252-aa30-5d10-a7a0-b5b3d88df832",
"previous_object": "true"
}
}

手順 4: 変更ログ詳細サービスに要求を POST する

POST transaction_idに対応する変更の詳細な変更ログを取得する JSON 要求。

POST を /change-log-detailします。

$ curl -b cookies -X POST -d @change-log-detail.json 'https://api.appnexus.com/change-log-detail'
{
"response": {
"change_log_details": [
{
"transaction_id": "016ac252-aa30-5d10-a7a0-b5b3d88df832",
"member_id": 7823,
"raw_json":"{\"advertiser\":{\"id\":0,\"code\":\"0080459398\",...}",
"plugin_id": "",
"method": "POST",
"changes": [
{
"field_name": "allow_safety_pacing",
"old_value": null,
"new_value": null,
"changed": false
},
{
"field_name": "billing_address1",
"old_value": null,
"new_value": "New Address",
"changed": true
},
...
],
"session_id": "authn:206221:8d1c33b7fadc3:ams3",
"internal_txn": false,
"url": "https://api.appnexus.com/advertiser",
"request_source": "direct",
"num_of_changes": 25,
"created_on": "2021-03-03 17:16:07",
"user_id": [redacted],
"modified_by_admin": true,
"admin_id": 0,
"user_full_name": "Test",
"resource_id": 5260730,
"client_ip": "[redacted]",
"ip_info": "[redacted]"
}
],
"start_element": 0,
"num_elements": 1,
"count": 1,
"status": "OK"
}
}