Skip to main content
POST
设置 Google Ads Advertisers SERP 任务
设置 Google Ads 广告商 SERP 任务。返回 Ads Transparency 平台中指定关键词和位置的广告商信息。仅在设置任务时向您的账户收费。

示例

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
keyword
string
必填

用于搜索广告商的关键词

location_name
string

搜索引擎位置的完整名称

location_code
integer

搜索引擎位置代码

priority
integer

任务优先级

postback_url
string

用于发送任务结果的 URL

pingback_url
string

任务完成时的通知 URL

postback_data
string

Postback 数据类型;仅支持 advanced

响应

成功响应

version
string

API 的当前版本

status_code
integer

通用状态码

status_message
string

一般信息消息

time
string

执行时间(秒)

cost
number

任务总成本(美元)

tasks_count
integer

tasks 数组中的任务数量

tasks_error
integer

返回错误的 tasks 数组中的任务数量

tasks
string[]

任务对象数组

tasks[].id
string

UUID 格式的任务标识符

tasks[].status_code
integer

任务状态码

tasks[].status_message
string

任务状态消息

tasks[].cost
number

任务成本(美元)

tasks[].result_count
integer

结果数组中的元素数量