行項目

GET accounts/:account_id/line_items

現在のアカウントに関連付けられている一部またはすべての行項目の詳細を取得します。

リソースURL

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

パラメーター

名前 説明
account_id
必須

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

タイプ: 文字列

例: 18ce54d4x5t

campaign_ids
任意

カンマ区切りのIDリストを指定して、応答の範囲を特定のキャンペーンの行項目のみに設定します。最大200件のIDを指定できます。

タイプ: 文字列

例: 8gdx6

count
任意

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

タイプ: 整数

デフォルト: 200
最小、最大: 11000
cursor
任意

結果の次のページを取得するためのカーソルを指定します。詳細については、「ページネーション」を参照してください。

タイプ: 文字列

例: 8x7v00oow

funding_instrument_ids
任意

カンマ区切りのIDリストを指定して、応答の範囲を特定のお支払い方法の行項目のみに設定します。最大200件のIDを指定できます。

タイプ: 文字列

例: lygyi

line_item_ids
任意

カンマ区切りのIDリストを指定して、応答の範囲を目的の行項目のみに設定します。最大200件のIDを指定できます。

タイプ: 文字列

例: 8v7jo

q
任意

リソースをnameごとに範囲設定する任意のクエリ。

タイプ: 文字列

最小および最長の長さ: 1255
sort_by
任意

サポートされている属性で昇順または降順に並べ替えます。詳細については、「並べ替え」を参照してください。

タイプ: 文字列

例: created_at-asc

with_deleted
任意

削除した結果をリクエストに含めます。

タイプ: ブール値

デフォルト: false
使用可能な値: truefalse
with_draft
任意

リクエストに下書きキャンペーンの結果を含めます。

タイプ: ブール値

デフォルト: false
使用可能な値: truefalse
with_total_count
任意

total_count応答属性を含めます。

: このパラメーターとcursorとは相互に排他的です。

: total_countを含むリクエストの場合、レート制限が低くなります。現在15分あたり200に設定されています。

タイプ: ブール値

デフォルト: false
使用可能な値: truefalse

リクエストの例

GET https://ads-api.x.com/10/accounts/18ce54d4x5t/line_items?line_item_ids=8v7jo

応答の例

{
  "request": {
    "params": {
      "line_item_ids": [
        "8v7jo"
      ],
      "account_id": "18ce54d4x5t"
    }
  },
  "next_cursor": null,
  "data": [
    {
      "bid_strategy": "MAX",
      "advertiser_user_id": 756201191646691328,
      "name": "Untitled",
      "placements": [
        "ALL_ON_TWITTER"
      ],
      "start_time": null,
      "bid_amount_local_micro": 100000,
      "advertiser_domain": null,
      "target_cpa_local_micro": null,
      "primary_web_event_tag": null,
      "pay_by": "ENGAGEMENT",
      "product_type": "PROMOTED_TWEETS",
      "end_time": null,
      "duration_in_days": 1,
      "total_budget_amount_local_micro": null,
      "objective": "ENGAGEMENTS",
      "id": "8v7jo",
      "entity_status": "ACTIVE",
      "goal": "ENGAGEMENT",
      "frequency_cap": 5,
      "categories": [],
      "currency": "USD",
      "created_at": "2017-05-27T08:04:00Z",
      "updated_at": "2017-05-27T08:06:25Z",
      "campaign_id": "8gdx6",
      "creative_source": "MANUAL",
      "deleted": false
    }
  ]
}

GET accounts/:account_id/line_items/:line_item_id

現在のアカウントに関連付けられている特定の行項目を取得します。

リソースURL

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

パラメーター

名前 説明
account_id
必須

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

タイプ: 文字列

例: 18ce54d4x5t

line_item_id
必須

リクエスト内で操作する行項目への参照。

タイプ: 文字列

例: 8v7jo

with_deleted
任意

削除した結果をリクエストに含めます。

タイプ: ブール値

デフォルト: false
使用可能な値: truefalse

リクエストの例

GET https://ads-api.x.com/10/accounts/18ce54d4x5t/line_items/8v7jo

応答の例

{
  "request": {
    "params": {
      "line_item_id": "8v7jo",
      "account_id": "18ce54d4x5t"
    }
  },
  "data": {
    "bid_strategy": "MAX",
    "advertiser_user_id": 756201191646691328,
    "name": "Untitled",
    "placements": [
      "ALL_ON_TWITTER"
    ],
    "start_time": null,
    "bid_amount_local_micro": 100000,
    "advertiser_domain": null,
    "target_cpa_local_micro": null,
    "primary_web_event_tag": null,
    "pay_by": "ENGAGEMENT",
    "product_type": "PROMOTED_TWEETS",
    "end_time": null,
    "duration_in_days": 1,
    "total_budget_amount_local_micro": null,
    "objective": "ENGAGEMENTS",
    "id": "8v7jo",
    "entity_status": "ACTIVE",
    "goal": "ENGAGEMENT",
    "frequency_cap": 5,
    "categories": [],
    "currency": "USD",
    "created_at": "2017-05-27T08:04:00Z",
    "updated_at": "2017-05-27T08:06:25Z",
    "campaign_id": "8gdx6",
    "creative_source": "MANUAL",
    "deleted": false
  }
}

POST accounts/:account_id/line_items

現在のアカウントに属する、指定したキャンペーンに関連付けられた行項目を作成します。

キャンペーン内のすべての行項目は、product_typeobjectiveが同じである必要があります。

PROMOTED_ACCOUNT商品タイプを使用する場合、ツイートをline_itemに関連付けると、標準のPROMOTED_ACCOUNT配置に加えて、タイムライン配置がモバイルに追加されます。

android_app_store_identifierios_app_store_identifierを設定すると、プロモーション対象のモバイルアプリと一致する行項目のターゲティング条件が自動的に追加されます。たとえば、ios_app_store_identifierを渡すと、iOSPLATFORMターゲティング条件が追加されます。

: キャンペーンあたり100の行項目、全キャンペーンで8,000のアクティブな行項目の制限があります。

リソースURL

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

パラメーター

名前 説明
account_id
必須

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

タイプ: 文字列

例: 18ce54d4x5t

campaign_id
必須

行項目を作成するキャンペーンのID。

タイプ: 文字列

例: 8slvg

objective
必須

この行項目のキャンペーンの目的。

タイプ: 列挙

使用可能な値: APP_ENGAGEMENTSAPP_INSTALLSREACHFOLLOWERSENGAGEMENTSVIDEO_VIEWSPREROLL_VIEWSWEBSITE_CLICKS

placements
必須

この行項目を表示する配置場所。配置の値で構成されるカンマ区切りのリストを指定します。

タイプ: 列挙

使用可能な値: ALL_ON_TWITTERPUBLISHER_NETWORKTAP_BANNERTAP_FULLTAP_FULL_LANDSCAPETAP_NATIVETAP_MRECTTWITTER_PROFILETWITTER_SEARCHTWITTER_TIMELINE

product_type
必須

この行項目に含まれるプロモ商品のタイプ。

タイプ: 列挙

使用可能な値: MEDIAPROMOTED_ACCOUNTPROMOTED_TWEETS

advertiser_domain
必須の場合あり

この広告主のウェブサイトドメイン(プロトコル指定なし)。

: 行項目配置がPUBLISHER_NETWORKに設定されている場合は必須です。

タイプ: 文字列

例: twitter.com

android_app_store_identifier
必須の場合あり

プロモーションされたアプリケーションのGoogle PlayストアID。

: APP_INSTALLSAPP_ENGAGEMENTSの目的には1つ以上のアプリストア(android_app_store_identifierios_app_store_identifierのいずれか)のIDで設定が必要です。

タイプ: 文字列

例: com.twitter.android

bid_amount_local_micro
必須の場合あり

この行項目に関連付けられる入札金額。指定したお支払い方法に関連付けられている通貨が使用されます。米国ドル(USD)の場合、$5.50は5,500,000として表されます。

: bid_strategyMAXまたはTARGETに設定されている場合は必須です。

: 0より大きな値のみが受け入れられます。

タイプ: 長整数型

例: 5500000

categories
必須の場合あり

この広告主の関連するIABカテゴリー。「GET iab_categories」を参照してください。

: 行項目配置がPUBLISHER_NETWORKに設定されている場合は必須です。

タイプ: 文字列

例: IAB3-1

ios_app_store_identifier
必須の場合あり

プロモーションされたアプリケーションのApple App Store IDの数字部分。

: APP_INSTALLSAPP_ENGAGEMENTSの目的には1つ以上のアプリストア(android_app_store_identifierios_app_store_identifierのいずれか)のIDで設定が必要です。

タイプ: 文字列

例: 333903271

primary_web_event_tag
必須の場合あり

プライマリウェブイベントタグのID。この行項目に関連するキャンペーンのエンゲージメントをより正確に追跡できるようになります。

: 行項目の目標がWEBSITE_CONVERSIONSに設定されている場合は必須です。

タイプ: 文字列

例: nvo4z

advertiser_user_id
任意

PREROLL_VIEWS広告をプロモーションするユーザー名のTwitterユーザーID。特定のクライアントアプリケーションのみこのパラメーターを使用できます。

タイプ: 長整数型

例: 312226591

audience_expansion
任意

すでにターゲティングしているユーザーに類似するユーザーをターゲティングすることによって、キャンペーンのリーチを広げるために使用されます。

: デフォルトでは、拡張は適用されません。

タイプ: 列挙

使用可能な値: BROADDEFINEDEXPANDED

bid_strategy
任意

入札メカニズム。

AUTOは、日別予算とキャンペーンの配信日に基づいて自動的に入札を最適化します。

MAXは上限許容入札単価を設定し、目的がREACHまたはFOLLOWERSに設定されている場合は使用できません

TARGETは、1日の入札単価の平均を指定したbid_amount_local_microの20%以内に設定しようとします。目的がREACHFOLLOWERSWEBSITE_CLICKSのいずれかに設定されている場合に使用できます。

: AUTOに設定されている場合、bid_amount_local_microは無視されます。

: デフォルト値は目的に基づいて設定されます。

タイプ: 列挙

使用可能な値: AUTOMAXTARGET

duration_in_days
任意

frequency_capが達成される期間。

タイプ: 整数

使用可能な値: 1730

end_time
任意

行項目の配信が停止される時間。ISO 8601で表されます。

タイプ: 文字列

例: 2017-10-05T00:00:00Z

entity_status
任意

行項目のステータス。

タイプ: 列挙

デフォルト: ACTIVE
使用可能な値: ACTIVEDRAFTPAUSED
frequency_cap
任意

広告をユーザーに配信できる最大回数。

: REACHENGAGEMENTSVIDEO_VIEWSPREROLL_VIEWSの目的でのみサポートされます。

タイプ: 整数

例: 5

goal
任意

この行項目で使用する最適化設定。APP_INSTALLAPP_ENGAGEMENTSにはAPP_CLICKSAPP_INSTALLSのオプションが利用可能で、サポートされるMACTパートナーの使用が必須となる場合があります。

: デフォルト値は目的に基づいて設定されます。

タイプ: 列挙

使用可能な値: APP_CLICKSAPP_INSTALLSENGAGEMENTFOLLOWERSLINK_CLICKSMAX_REACHPREROLLPREROLL_STARTSREACH_WITH_ENGAGEMENTVIDEO_VIEWVIEW_3S_100PCTVIEW_6SVIEW_15SWEBSITE_CONVERSIONS
name
任意

行項目の名前。

タイプ: 文字列

例: demo

最小および最長の長さ: 1255
pay_by
任意

この行項目の課金の単位。この設定は、APP_INSTALLSの目的を使用する行項目でのみ変更できます。

: デフォルトpay_byは、キャンペーン目的と行項目の入札単価に基づいて自動的に設定されます。

タイプ: 列挙

使用可能な値: APP_CLICK

start_time
任意

行項目の配信が開始される時間。ISO 8601で表されます。

タイプ: 文字列

例: 2017-07-05T00:00:00Z

total_budget_amount_local_micro
任意

行項目に割り当てる合計予算額。指定したお支払い方法に関連付けられている通貨が使用されます。米国ドル(USD)の場合、$37.50は37,500,000として表されます。

タイプ: 長整数型

例: 37500000

リクエストの例

POST https://ads-api.x.com/10/accounts/18ce54d4x5t/line_items?campaign_id=8slvg&objective=ENGAGEMENTS&product_type=PROMOTED_TWEETS&placements=ALL_ON_TWITTER&bid_amount_local_micro=3210000&entity_status=PAUSED

応答の例

{
  "data": {
    "bid_strategy": "MAX",
    "advertiser_user_id": 756201191646691328,
    "name": "Untitled",
    "placements": [
      "ALL_ON_TWITTER"
    ],
    "start_time": null,
    "bid_amount_local_micro": 3210000,
    "advertiser_domain": null,
    "target_cpa_local_micro": null,
    "primary_web_event_tag": null,
    "pay_by": "ENGAGEMENT",
    "product_type": "PROMOTED_TWEETS",
    "end_time": null,
    "duration_in_days": null,
    "total_budget_amount_local_micro": null,
    "objective": "ENGAGEMENTS",
    "frequency_cap": null,
    "id": "95lya",
    "entity_status": "PAUSED",
    "goal": "ENGAGEMENT",
    "categories": [],
    "currency": "USD",
    "created_at": "2017-06-23T01:59:22Z",
    "updated_at": "2017-06-23T01:59:22Z",
    "campaign_id": "8slvg",
    "creative_source": "MANUAL",
    "deleted": false
  },
  "request": {
    "params": {
      "placements": [
        "ALL_ON_TWITTER"
      ],
      "bid_amount_local_micro": 3210000,
      "product_type": "PROMOTED_TWEETS",
      "objective": "ENGAGEMENTS",
      "entity_status": "PAUSED",
      "account_id": "18ce54d4x5t",
      "campaign_id": "8slvg"
    }
  }
}

POST batch/accounts/:account_id/line_items

1回のリクエストで新しい行項目をバッチ作成できます。

バッチリクエスト

  • 現在の最大バッチサイズは40です。
  • すべてのパラメーターはリクエストボディで送信され、application/jsonContent-Typeが必須です。
  • バッチリクエストはグループ単位で失敗または成功となります。エラーの場合も、成功の場合も、API応答には、最初のリクエストの項目の順序が保持されます。

バッチ応答

バッチAPIの応答は、項目のコレクションを順番どおりに返します。その点を除くと、バッチAPIの構造は、対応する単一項目のエンドポイントと同じです。

バッチエラー

  • リクエストレベルのエラー(最大バッチサイズの超過など)は、errorsオブジェクトの応答に表示されます。
  • 項目レベルのエラー(必須行項目パラメーターの不足など)は、operation_errorsオブジェクトの応答に表示されます。

リソースURL

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

パラメーター

名前 説明
operation_type
必須

実行中の、項目ごとの操作タイプ。

タイプ: 列挙

使用可能な値: CreateDeleteUpdate

params
必須
行項目オブジェクトのすべてのパラメーターを含むJSONオブジェクト。必須および任意の行項目パラメーターの一覧については、こちらを参照してください。

リクエストの例

POST 'Content-Type: application/json' https://ads-api.x.com/10/batch/accounts/18ce54d4x5t/line_items

[  
  {  
    "operation_type":"Create",
    "params":{  
      "campaign_id":"8yn7m",
      "objective":"ENGAGEMENTS",
      "product_type":"PROMOTED_TWEETS",
      "placements":"ALL_ON_TWITTER",
      "bid_amount_local_micro":3210000,
      "entity_status":"PAUSED"
    }
  }
]

応答の例

{
  "data": [
    {
      "bid_strategy": "MAX",
      "advertiser_user_id": 756201191646691328,
      "name": "Untitled",
      "placements": [
        "ALL_ON_TWITTER"
      ],
      "start_time": null,
      "bid_amount_local_micro": 3210000,
      "advertiser_domain": null,
      "target_cpa_local_micro": null,
      "primary_web_event_tag": null,
      "pay_by": "ENGAGEMENT",
      "product_type": "PROMOTED_TWEETS",
      "end_time": null,
      "total_budget_amount_local_micro": null,
      "objective": "ENGAGEMENTS",
      "id": "9cqi0",
      "entity_status": "PAUSED",
      "goal": "ENGAGEMENT",
      "categories": [],
      "currency": "USD",
      "created_at": "2017-07-07T17:42:20Z",
      "updated_at": "2017-07-07T17:42:20Z",
      "campaign_id": "8yn7m",
      "creative_source": "MANUAL",
      "deleted": false
    }
  ],
  "request": [
    {
      "params": {
        "placements": [
          "ALL_ON_TWITTER"
        ],
        "bid_amount_local_micro": 3210000,
        "product_type": "PROMOTED_TWEETS",
        "objective": "ENGAGEMENTS",
        "entity_status": "PAUSED",
        "account_id": "18ce54d4x5t",
        "campaign_id": "8yn7m"
      },
      "operation_type": "Create"
    }
  ]
}

PUT accounts/:account_id/line_items/:line_item_id

現在のアカウントに関連付けられている指定された行項目を更新します。

リソースURL

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

パラメーター

名前 説明
account_id
必須

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

タイプ: 文字列

例: 18ce54d4x5t

line_item_id
必須

リクエスト内で操作する行項目への参照。

タイプ: 文字列

例: 8v7jo

advertiser_domain
任意

この広告主のウェブサイトドメイン(プロトコル指定なし)。

: 行項目配置がPUBLISHER_NETWORKに設定されている場合は必須です。

タイプ: 文字列

例: twitter.com

advertiser_user_id
任意

PREROLL_VIEWS広告をプロモーションするユーザー名のTwitterユーザーID。特定のクライアントアプリケーションのみこのパラメーターを使用できます。

タイプ: 長整数型

例: 312226591

android_app_store_identifier
任意

プロモーションされたアプリケーションのGoogle PlayストアID。

: APP_INSTALLSAPP_ENGAGEMENTSの目的には1つ以上のアプリストア(android_app_store_identifierios_app_store_identifierのいずれか)のIDで設定が必要です。

タイプ: 文字列

例: com.twitter.android

audience_expansion
任意

すでにターゲティングしているユーザーに類似するユーザーをターゲティングすることによって、キャンペーンのリーチを広げるために使用されます。

タイプ: 列挙

使用可能な値: BROADDEFINEDEXPANDED

bid_amount_local_micro
任意

この行項目に関連付けられる入札金額。指定したお支払い方法に関連付けられている通貨が使用されます。米国ドル(USD)の場合、$5.50は5,500,000として表されます。

: bid_strategyMAXまたはTARGETに設定されている場合は必須です。

: 0より大きな値のみが受け入れられます。

タイプ: 長整数型

例: 140000

bid_strategy
任意

入札メカニズム。

AUTOは、日別予算とキャンペーンの配信日に基づいて自動的に入札を最適化します。

MAXは上限許容入札単価を設定し、目的がREACHまたはFOLLOWERSに設定されている場合は使用できません

TARGETは、1日の入札単価の平均を指定したbid_amount_local_microの20%以内に設定しようとします。目的がREACHまたはWEBSITE_CLICKSのいずれかに設定されている場合に使用できます。

: AUTOに設定されている場合、bid_amount_local_microは無視されます。

: デフォルト値は目的に基づいて設定されます。

タイプ: 列挙

使用可能な値: AUTOMAXTARGET

categories
任意

この広告主の関連するIABカテゴリー。「GET iab_categories」を参照してください。

: 行項目配置がPUBLISHER_NETWORKに設定されている場合は必須です。

タイプ: 文字列

例: IAB3-1

duration_in_days
任意

frequency_capが達成される期間。

タイプ: 整数

使用可能な値: 1730

end_time
任意

行項目の配信が停止される時間。ISO 8601で表されます。

タイプ: 文字列

例: 2017-10-05T00:00:00Z

entity_status
任意

行項目のステータス。

タイプ: 列挙

使用可能な値: ACTIVEPAUSED

frequency_cap
任意

広告をユーザーに配信できる最大回数。

: REACHENGAGEMENTSVIDEO_VIEWSPREROLL_VIEWSの目的でのみサポートされます。

タイプ: 整数

例: 5

goal
任意

この行項目で使用する最適化設定。APP_INSTALLAPP_ENGAGEMENTSにはAPP_CLICKSAPP_INSTALLSのオプションが利用可能で、サポートされるMACTパートナーの使用が必須となる場合があります。

: デフォルト値は目的に基づいて設定されます。

タイプ: 列挙

使用可能な値: APP_CLICKSAPP_INSTALLSENGAGEMENTFOLLOWERSLINK_CLICKSMAX_REACHPREROLLPREROLL_STARTSREACH_WITH_ENGAGEMENTVIDEO_VIEWVIEW_3S_100PCTVIEW_6SVIEW_15SWEBSITE_CONVERSIONS
ios_app_store_identifier
任意

プロモーションされたアプリケーションのApple App Store IDの数字部分。

: APP_INSTALLSAPP_ENGAGEMENTSの目的には1つ以上のアプリストア(android_app_store_identifierios_app_store_identifierのいずれか)のIDで設定が必要です。

タイプ: 文字列

例: 333903271

name
任意

行項目の名前。

タイプ: 文字列

例: demo

start_time
任意

行項目の配信が開始される時間。ISO 8601で表されます。

タイプ: 文字列

例: 2017-07-05T00:00:00Z

total_budget_amount_local_micro
任意

行項目に割り当てる合計予算額。指定したお支払い方法に関連付けられている通貨が使用されます。米国ドル(USD)の場合、$37.50は37,500,000として表されます。

タイプ: 長整数型

例: 37500000

リクエストの例

PUT https://ads-api.x.com/10/accounts/18ce54d4x5t/line_items/8v7jo?bid_amount_local_micro=140000

応答の例

{
  "data": {
    "bid_strategy": "MAX",
    "advertiser_user_id": 756201191646691328,
    "name": "Untitled",
    "placements": [
      "ALL_ON_TWITTER"
    ],
    "start_time": null,
    "bid_amount_local_micro": 140000,
    "advertiser_domain": null,
    "target_cpa_local_micro": null,
    "primary_web_event_tag": null,
    "pay_by": "ENGAGEMENT",
    "product_type": "PROMOTED_TWEETS",
    "duration_in_days": 1,
    "end_time": null,
    "total_budget_amount_local_micro": null,
    "objective": "ENGAGEMENTS",
    "id": "8v7jo",
    "entity_status": "ACTIVE",
    "goal": "ENGAGEMENT",
    "frequency_cap": 5,
    "categories": [],
    "currency": "USD",
    "created_at": "2017-05-27T08:04:00Z",
    "updated_at": "2017-07-04T22:01:28Z",
    "campaign_id": "8gdx6",
    "creative_source": "MANUAL",
    "deleted": false
  },
  "request": {
    "params": {
      "line_item_id": "8v7jo",
      "bid_amount_local_micro": 140000,
      "account_id": "18ce54d4x5t"
    }
  }
}

DELETE accounts/:account_id/line_items/:line_item_id

現在のアカウントに属する、指定された行項目を削除します。

: 行項目の削除は元に戻すことができず、その後にリソースを削除しようとするとHTTP 404が返されます。

: 行項目が削除されると、もしリクエストにwith_deleted=trueが指定されている場合、子のpromoted_tweetsはGET accounts/:account_id/promoted_tweetsとGET accounts/:account_id/promoted_tweets/:promoted_tweet_idエンドポイントでのみ返されます。これらのpromoted_tweetsは、実際には削除されていません(応答は"deleted": false)。削除はカスケードされません。

リソースURL

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

パラメーター

名前 説明
account_id
必須

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

タイプ: 文字列

例: 18ce54d4x5t

line_item_id
必須

リクエスト内で操作する行項目への参照。

タイプ: 文字列

例: 9f2ix

リクエストの例

DELETE https://ads-api.x.com/10/accounts/18ce54d4x5t/line_items/9f2ix

応答の例

{
  "data": {
    "bid_strategy": "MAX",
    "advertiser_user_id": 756201191646691328,
    "name": "Untitled",
    "placements": [],
    "start_time": null,
    "bid_amount_local_micro": 100000,
    "advertiser_domain": null,
    "target_cpa_local_micro": null,
    "primary_web_event_tag": null,
    "pay_by": "ENGAGEMENT",
    "product_type": "PROMOTED_TWEETS",
    "end_time": "2017-07-21T00:00:00Z",
    "duration_in_days": 1,
    "total_budget_amount_local_micro": null,
    "objective": "ENGAGEMENTS",
    "id": "9f2ix",
    "entity_status": "ACTIVE",
    "goal": "ENGAGEMENT",
    "frequency_cap": 5,
    "categories": [],
    "currency": "USD",
    "created_at": "2017-07-14T00:01:50Z",
    "updated_at": "2017-08-09T07:41:08Z",
    "campaign_id": "90r8n",
    "creative_source": "MANUAL",
    "deleted": true
  },
  "request": {
    "params": {
      "line_item_id": "9f2ix",
      "account_id": "18ce54d4x5t"
    }
  }
}