おすすめ

GET accounts/:account_id/recommendations

ステータス: クローズドベータ版

この広告アカウントに関連付けられているキャンペーンのお勧めを取得します。現時点では、お勧めはお支払い方法ごとに1つに制限されています。

リソースURL

https://ads-api.x.com/5/accounts/:account_id/recommendations

パラメーター

名前 説明
account_id
必須

利用するアカウントのID。リソースのパス内に表示され、通常、GET accountsを除くすべての広告主APIリクエストに必須のパラメーターです。指定するアカウントは、認証済みユーザーに関連付けられている必要があります。

タイプ: 文字列

例: 18ce54d4x5t

リクエストの例

GET https://ads-api.x.com/5/accounts/18ce54d4x5t/recommendations

応答の例

"request": {
  "params": {
    "account_id": "18ce54d4x5t"
  }
},
"total_count": 1,
"data": [
  {
    "funding_instrument_id": "gpvzb",
    "id": "62ce8zza1q0w",
    "account_id": "18ce54d4x5t",
    "status": "PENDING",
    "message": "Recommendation for testing",
    "created_at": "2016-11-14T23:07:54Z",
    "updated_at": "2016-11-14T23:07:54Z"
  }
]

GET accounts/:account_id/recommendations/:recommendation_id

ステータス: クローズドベータ版

この広告アカウントに関連付けられている特定のキャンペーンのお勧めを取得します。

キャンペーンのお勧めには、キャンペーン構造に対して提案された一連の変更がすべて含まれており、オブジェクトツリーとして表示されます。応答ツリーはバッチAPIエンドポイントと連動させて利用することを目的としていますが、必要に応じて単一の更新エンドポイントにマッピングすることもできます(作成とPOST、更新とPUT、削除とDELETE)。

リソースURL

https://ads-api.x.com/5/accounts/:account_id/recommendations/:recommendation_id

パラメーター

名前 説明
account_id
必須

利用するアカウントのID。リソースのパス内に表示され、通常、GET accountsを除くすべての広告主APIリクエストに必須のパラメーターです。指定するアカウントは、認証済みユーザーに関連付けられている必要があります。

タイプ: 文字列

例: 18ce54d4x5t

recommendation_id
必須

リクエストで操作するお勧めIDへの参照

タイプ: 文字列

例: 62ce8zza1q0w

リクエストの例

GET https://ads-api.x.com/5/accounts/18ce54d4x5t/recommendations/62ce8zza1q0w

応答の例

{
"request": {
  "params": {
    "recommendation_id": "62ce8zza1q0w",
    "account_id": "18ce54d4x5t"
  }
},
"data_type": "recommendations",
  "data": {
  "changes": [
    {
      "entity_type": "campaigns",
      "params": {
        "start_time": "2016-11-08T22:00:00Z",
        "daily_budget_amount_local_micro": 2200000,
        "end_time": "2016-11-16T07:59:00Z",
        "total_budget_amount_local_micro": 12000000,
        "id": "64m0d"
      },
      "operation_type": "Update",
      "dependent_entities": [
        {
          "entity_type": "line_items",
          "params": {
            "name": "Campaign for recommendations",
            "placements": [
              "TWITTER_TIMELINE"
            ],
            "bid_amount_local_micro": 1430000,
            "id": "6f5kq",
            "include_sentiment": "ALL"
          },
          "operation_type": "Update",
          "dependent_entities": [
            {
              "entity_type": "targeting_criteria",
              "params": {
                "id": "a8po6p"
              },
              "operation_type": null,
              "dependent_entities": []
            },
            {
              "entity_type": "targeting_criteria",
              "params": {
                "line_item_id": "6f5kq",
                "name": "election results",
                "targeting_value": "election results",
                "targeting_type": "PHRASE_KEYWORD"
              },
              "operation_type": "Create",
              "dependent_entities": []
            },
            {
              "entity_type": "promoted_tweets",
              "params": {
                "id": "101ftp"
              },
              "operation_type": "Delete",
              "dependent_entities": []
            },
            {
              "entity_type": "targeting_criteria",
              "params": {
                "line_item_id": "6f5kq",
                "name": "Male",
                "targeting_value": 1,
                "targeting_type": "GENDER"
              },
              "operation_type": "Create",
              "dependent_entities": []
            },
            {
              "entity_type": "targeting_criteria",
              "params": {
                "line_item_id": "6f5kq",
                "name": "San Francisco-Oakland-San Jose CA, US",
                "targeting_value": "",
                "targeting_type": "LOCATION"
              },
              "operation_type": "Create",
              "dependent_entities": []
            },
            {
              "entity_type": "promoted_tweets",
              "params": {
                "id": "101fto"
              },
              "operation_type": "Delete",
              "dependent_entities": []
            },
            {
              "entity_type": "promoted_tweets",
              "params": {
                "line_item_id": "6f5kq",
                "display_properties": [],
                "paused": false,
                "approval_status": "ACCEPTED",
                "tweet_id": "91125952589766656"
              },
              "operation_type": "Create",
              "dependent_entities": []
            },
            {
              "entity_type": "targeting_criteria",
              "params": {
                "line_item_id": "6f5kq",
                "name": "Partner audience targeting",
                "targeting_value": "v2cx",
                "targeting_type": "NEGATIVE_BEHAVIOR"
              },
              "operation_type": "Create",
              "dependent_entities": []
            },
            {
              "entity_type": "targeting_criteria",
              "params": {
                "line_item_id": "6f5kq",
                "name": "AGE_21_TO_34",
                "targeting_value": "AGE_21_TO_34",
                "targeting_type": "AGE"
              },
              "operation_type": "Create",
              "dependent_entities": []
            },
            {
              "entity_type": "targeting_criteria",
              "params": {
                "id": "a8po6o"
              },
              "operation_type": "Delete",
              "dependent_entities": []
            },
            {
              "entity_type": "promoted_tweets",
              "params": {
                "line_item_id": "6f5kq",
                "display_properties": [],
                "paused": false,
                "approval_status": "ACCEPTED",
                "tweet_id": "991101965843460096"
              },
              "operation_type": "Create",
              "dependent_entities": []
            },
            {
              "entity_type": "promoted_tweets",
              "params": {
                "line_item_id": "6f5kq",
                "display_properties": [],
                "paused": false,
                "approval_status": "ACCEPTED",
                "tweet_id": "991127212156096516"
              },
              "operation_type": "Create",
              "dependent_entities": []
            },
            {
              "entity_type": "targeting_criteria",
              "params": {
                "line_item_id": "6f5kq",
                "name": "debate",
                "targeting_value": "debate",
                "targeting_type": "NEGATIVE_PHRASE_KEYWORD"
              },
              "operation_type": "Create",
              "dependent_entities": []
            },
            {
              "entity_type": "targeting_criteria",
              "params": {
                "line_item_id": "6f5kq",
                "name": "60004, IL, US",
                "targeting_value": "",
                "targeting_type": "LOCATION"
              },
              "operation_type": "Create",
              "dependent_entities": []
            },
            {
              "entity_type": "targeting_criteria",
              "params": {
                "id": "a8po6n"
              },
              "operation_type": null,
              "dependent_entities": []
            },
            {
              "entity_type": "promoted_tweets",
              "params": {
                "id": "101ftn"
              },
              "operation_type": null,
              "dependent_entities": []
            }
          ]
        }
      ]
    }
  ],
  "funding_instrument_id": "gpvzb",
  "id": "62ce8zza1q0w",
  "account_id": "18ce54d4x5t",
  "status": "PENDING",
  "message": "Recommendation for testing",
  "created_at": "2016-11-14T23:07:54Z",
  "updated_at": "2016-11-14T23:07:54Z"
  }
}