데이터 API / DataForSEO / SERP

Setting Google Ads Search SERP Tasks

Queues the ads running against a keyword on Google, returning a task id in tasks[0].id. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. The live twin answers immediately and is simpler for a single query; queue when the batch would outlast a tool call.

파라미터

경로, 쿼리, 헤더 파라미터가 없습니다.

요청 본문

advertiser_idsstring[]선택
Advertiser identifiers; required if target is not specified
targetstring선택
Domain name associated with an advertiser account; required if advertiser_ids is not specified
location_namestring선택
Full name of search engine location
location_codeinteger선택
Search engine location code
location_coordinatestring선택
GPS coordinates of a location
priorityinteger선택
Task priority
postback_urlstring선택
URL for sending task results
pingback_urlstring선택
Notification URL of a completed task
postback_datastring선택
Postback datatype; only advanced is supported

요청 예시

curl -X POST "https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ads_search/task_post" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "advertiser_ids": [
    "<string>"
  ],
  "target": "<string>",
  "location_name": "<string>",
  "location_code": 0,
  "location_coordinate": "<string>",
  "priority": 0,
  "postback_url": "<string>",
  "pingback_url": "<string>"
}'

응답

응답 필드

versionstring선택
The current version of the API
status_codeinteger선택
General status code
status_messagestring선택
General informational message
timestring선택
Execution time, seconds
costnumber선택
Total tasks cost, USD
tasks_countinteger선택
The number of tasks in the tasks array
tasks_errorinteger선택
The number of tasks in the tasks array returned with an error
tasksstring[]선택
Array of task objects
idstring선택
Task identifier in UUID format
status_codeinteger선택
Task status code
status_messagestring선택
Task status message
costnumber선택
Cost of the task, USD
result_countinteger선택
Number of elements in the result array