获取关键词

应答字段

名称	类型	描述
list	struct[]	返回信息列表
bidword_id	integer	关键词 id
campaign_id	int64	推广计划 id，当获取广告主维度报表时，该值无意义
adgroup_id	int64	广告组 id，当获取广告主维度、推广计划维度报表时，该值无意义
bidword	string	关键词词面，字段长度最小 1 个等宽字符，长度最大 20 等宽字符（即字段最大长度为 20 个中文字或全角标点，40 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。），同一广告组下的关键词词面不允许重复
bid_price	integer	关键词出价，单位为分，关键词出价规则待补充
match_type	enum	关键词匹配方式，关键词匹配方式包括短语、精确、广泛匹配，[枚举详情]
configured_status	enum	暂停状态，[枚举详情]
bidword_status	enum	关键词状态，[枚举详情]
use_group_price	enum	是否使用组出价，[枚举详情]
audit_msg	string	审核原因
created_time	integer	创建时间（时间戳）
last_modified_time	integer	最后修改时间（时间戳）
pc_landing_page_info	struct[]	落地页列表信息
page_type	enum	落地页类型，[枚举详情]
page_url	string	落地页 URL
mini_program_spec	struct	微信小程序落地页数据结构
mini_program_id	string	小程序 id
mini_program_path	string	小程序路径
deep_link_spec	struct	应用直达落地页数据结构
deep_link_url	string	应用直达页 URL，微信朋友圈卡片广告创意形式需要填写 deeplink_ios_appid 或 deeplink_anroid_appid 以支持双端都能应用直达，应用直达页 URL
universal_link_spec	struct	通用链接落地页数据结构
universal_link_url	string	通用链接页 URL
xijing_spec	struct	蹊径落地页数据结构
page_id	int64	落地页 id
customized_param	string	蹊径落地页自定义参数
mobile_landing_page_info	struct[]	落地页列表信息
page_type	enum	落地页类型，[枚举详情]
page_url	string	落地页 URL
mini_program_spec	struct	微信小程序落地页数据结构
mini_program_id	string	小程序 id
mini_program_path	string	小程序路径
deep_link_spec	struct	应用直达落地页数据结构
deep_link_url	string	应用直达页 URL，微信朋友圈卡片广告创意形式需要填写 deeplink_ios_appid 或 deeplink_anroid_appid 以支持双端都能应用直达，应用直达页 URL
universal_link_spec	struct	通用链接落地页数据结构
universal_link_url	string	通用链接页 URL
xijing_spec	struct	蹊径落地页数据结构
page_id	int64	落地页 id
customized_param	string	蹊径落地页自定义参数
page_info	struct	分页配置信息
page	integer	搜索页码
page_size	integer	一页显示的数据条数
total_number	integer	总条数
total_page	integer	总页数

curl --location --request POST '/v1.3/bidword/get' \ --header 'access_token;' \ --header 'timestamp;' \ --header 'nonce;' \ --data-urlencode 'account_id=<ACCOUNT_ID>' \ --data-urlencode 'filtering=[]' \ --data-urlencode 'page=1' \ --data-urlencode 'page_size=10' \ --data-urlencode 'is_deleted=false'

{ "code": 0, "message": "", "message_cn": "", "data": { "list": [ { "campaign_id": "<CAMPAIGN_ID>", "adgroup_id": "<ADGROUP_ID>", "created_time": 1491019858, "last_modified_time": 1491098468, "pc_landing_page_info": [ { "mini_program_spec": [], "deep_link_spec": [], "universal_link_spec": [], "xijing_spec": [] } ], "mobile_landing_page_info": [ { "mini_program_spec": [], "deep_link_spec": [], "universal_link_spec": [], "xijing_spec": [] } ] } ], "page_info": { "page": 1, "page_size": 10, "total_number": 1, "total_page": 1 } } }

请求参数

Header 参数

access_token

string

必需

以Query Parameter方式在请求路径中传递。授权令牌，完成 OAuth 2.0 授权后获得，参考授权认证章节。

默认值:

<ACCESS_TOKEN>

timestamp

string

必需

以Query Parameter方式在请求路径中传递。当前的时间戳，单位为秒，允许客户端请求最大时间误差为300秒。
MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳
MarketingAPI 所使用的时区为GMT+8，例如当时间戳为1494840119时，表示 2018-05-15 17:21:59

默认值:

nonce

string

必需

以Query Parameter方式在请求路径中传递。随机字串标识，不超过32个字符，由调用方自行生成，需保证全局唯一性。

默认值:

<NONCE>

Body 参数application/x-www-form-urlencoded

account_id

integer

必需

广告主帐号 id，有操作权限的帐号 id，不支持代理商 id

示例值:

<ACCOUNT_ID>

filtering

string

可选

过滤条件，若此字段不传或传空则视为无限制条件,详见 [过滤条件]
数组最小长度 1，最大长度 255

示例值:

[]

page

integer

可选

搜索页码，默认值：1
最小值 1，最大值 99999

示例值:

page_size

integer

可选

一页显示的数据条数，默认值：10
最小值 1，最大值 1000

示例值:

is_deleted

string

可选

是否已删除，true：是，false：否
可选值：{ true, false }

示例值:

false

application/json

Body

code

integer

必需

message

string

必需

message_cn

string

必需

data

object

必需

list

array [object {6}]

返回信息列表

必需

page_info

object

分页配置信息

必需

应答字段#

请求参数

返回响应

应答字段