ターゲティング候補

GET accounts/:account_id/targeting_suggestions

最初の選択を補完する、キーワードまたはユーザーターゲティング候補を最大50個取得します。

リソースURL

https://ads-api.x.com/10/accounts/:account_id/targeting_suggestions

パラメーター

名前 説明
account_id
必須

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

タイプ: 文字列

例: 18ce54d4x5t

suggestion_type
必須

返される候補のタイプを指定します。

タイプ: 列挙

使用可能な値: KEYWORDUSER_ID

targeting_values
必須

候補にシード値を提供するキーワードまたはユーザーIDのいずれかのカンマ区切りのコレクション。

: 2つのタイプの候補を混在させることはできません。

例: 756201191646691328

count
任意

個別のリクエストごとに試行および取得するレコード数を指定します。

タイプ: 整数

デフォルト: 30
最小、最大: 150

リクエストの例

GET https://ads-api.x.com/10/accounts/18ce54d4x5t/targeting_suggestions?suggestion_type=KEYWORD&targeting_values=developers&count=2"

応答の例

{
  "data": [
    {
      "suggestion_type": "KEYWORD",
      "suggestion_value": "devs"
    },
    {
      "suggestion_type": "KEYWORD",
      "suggestion_value": "software"
    }
  ],
  "request": {
    "params": {
      "suggestion_type": "KEYWORD",
      "targeting_values": [
        "developers"
      ],
      "count": 2,
      "account_id": "18ce54d4x5t"
    }
  }
}