获取创意组件详情
所属权限 | ads_management |
请求地址 | component_detail/get |
请求方法 | GET |
全局参数
全局参数是指每一个接口都需要使用到的参数。详情参考,代码案例参考。
参数名称 | 参数类型 |
---|---|
access_token | 授权令牌,完成 OAuth 2.0 授权后获得,参考授权认证章节 |
timestamp |
当前的时间戳,单位为秒,允许客户端请求最大时间误差为 300 秒。 MarketingAPI 所使用的时间戳,若无特殊说明,均为秒级时间戳 MarketingAPI 所使用的时区为 GMT+8,例如当时间戳为 1494840119 时,表示 2017-05-15 17:21:59 |
nonce | 随机字串标识,不超过 32 个字符,由调用方自行生成,需保证全局唯一性 |
请求参数
标有*的参数为必填项
名称 | 类型 | 描述 |
---|---|---|
account_id
|
integer | 广告主帐号 id,有操作权限的帐号 id,不支持代理商 id |
filtering
|
struct[] | 过滤条件,若此字段不传,或传空则视为无限制条件,详见 [过滤条件] 数组最小长度 1,最大长度 4 |
field*
|
string | 过滤字段 可选值:{ component_id, component_type, component_sub_type } |
operator*
|
enum | 操作符,[枚举详情] 当 field 取值 component_id 时,可选值:{ EQUALS, IN } 当 field 取值 component_type 时,可选值:{ EQUALS, IN } 当 field 取值 component_sub_type 时,可选值:{ EQUALS, IN } 当 field 取值 element_spec_id 时,可选值:{ EQUALS, IN } 当 field 取值 dynamic_creative_id 时,可选值:{ EQUALS } 当 field 取值 data_model_version 时,可选值:{ EQUALS } 当 field 取值 component_custom_name 时,可选值:{ CONTAINS } 当 field 取值 generation_type 时,可选值:{ EQUALS, IN } |
values*
|
string[] | 字段取值,values 数组的个数限制与 operator 的取值相关,详见 [过滤条件] 当 field 取值 component_id 时,数组最小长度 1,最大长度 200 当 field 取值 component_type 时,数组最小长度 1,最大长度 100 可选值:{ UNKNOWN, TITLE, DESCRIPTION, IMAGE, IMAGE_LIST, JUMP_INFO, VIDEO, BRAND, CONSULT, PHONE, FORM, ACTION_BUTTON, CHOSEN_BUTTON, LABEL, SHOW_DATA, MARKETING_PENDANT, APP_GIFT_PACK_CODE, SHOP_IMAGE, COUNT_DOWN, BARRAGE, FLOATING_ZONE, TEXT_LINK, END_PAGE, LIVING_DESC, WECHAT_CHANNELS, SHORT_VIDEO, ELEMENT_STORY, WXGAME_PLAYABLE_PAGE, APP_PROMOTION_VIDEO, VIDEO_SHOWCASE, IMAGE_SHOWCASE, MINI_CARD_LINK, CONSULT_LINK, V2_TITLE, V2_DESCRIPTION, V2_LONG_SUBLINK, V2_SHORT_SUBLINK, V2_LONG_SUBLINK_LIST, V2_SHORT_SUBLINK_LIST, V2_APP_DOWNLOAD, V2_IMAGE_1X1, V2_IMAGE_LIST_1X1, V2_IMAGE_TEXT_1X1, V2_IMAGE_BIG_20X7, V2_VIDEO_16X9_IMAGE_16X9, V2_VIDEO_16X9_IMAGE_4X3, V2_VIDEO_16X9_IMAGE_1X1, V2_QUICK_CONSULT, V2_PHONE, V2_FORM, V2_BRAND, V2_LANDING_PAGE, V2_HOLIDAY_LOGO, V2_ACTION_BUTTON, V2_CHOSEN_BUTTON, V2_VIDEO_9X16_IMAGE_9X16, V2_IMAGE_16X9, V2_LABEL, V2_PROMOTION_SUBLINK, V2_IMAGE_LIST_3X2, V2_IMAGE_LIST_9X16, V2_LIST_SUBLINK, V2_MDPA_TITLE, V2_MDPA_DESCRIPTION } 当 field 取值 component_sub_type 时,数组最小长度 1,最大长度 100 可选值:{ VIDEO_16X9, VIDEO_9X16, VIDEO_4X3, VIDEO_SHOWCASE, SHORT_VIDEO_4X3, IMAGE_16X9, IMAGE_9X16, IMAGE_1X1, IMAGE_3X2, IMAGE_3X4, IMAGE_4X3, IMAGE_5X4, IMAGE_4X5, IMAGE_20X7, IMAGE_7X2, IMAGE_SHOWCASE, IMAGE_100X9, IMAGE_LIST_9X16_4, IMAGE_LIST_1X1_3, IMAGE_LIST_1X1_4, IMAGE_LIST_1X1_6, IMAGE_LIST_3X2_3, IMAGE_LIST_1X1_1, IMAGE_LIST_16X9_1, IMAGE_LIST_1X1_9, ELEMENT_STORY, DESCRIPTION, TITLE, ACTION_BUTTON, LABEL, SHOW_DATA, FLOATING_ZONE_IMAGE_TEXT, FLOATING_ZONE_IMAGE, BARRAGE, APP_GIFT_PACK_CODE, SHOP_IMAGE, MARKETING_PENDANT, CHOSEN_BUTTON, COUNT_DOWN, LIVING_DESC, TEXT_LINK, END_PAGE, WXGAME_PLAYABLE_PAGE, SOCIAL_SKILL, MINI_CARD_LINK, FLOATING_ZONE_IMAGE_TEXT_LIST, CONSULT_LINK, BRAND, BRAND_PAGE, BRAND_SEARCH, BRAND_WECHAT_CHANNEL, BRAND_WECHAT, BRAND_WECOM, BRAND_WECHAT_SHOP, BRAND_CUSTOM_LINK, JUMP_INFO_OFFICIAL, JUMP_INFO_H5, JUMP_INFO_WECHAT_MINI_PROGRAM, JUMP_INFO_WECHAT_CONSULT, JUMP_INFO_WECOM_CONSULT, JUMP_INFO_WECHAT_CHANNELS_WATCH_LIVE, JUMP_INFO_WECHAT_CHANNELS_FEED, JUMP_INFO_WECHAT_OFFICIAL_ACCOUNT_DETAIL, JUMP_INFO_WECHAT_MINI_GAME, JUMP_INFO_ANDROID_APP, JUMP_INFO_IOS_APP, JUMP_INFO_ANDROID_DIRECT_DOWNLOAD, JUMP_INFO_APP_MARKET, JUMP_INFO_APP_DEEP_LINK, JUMP_INFO_WECHAT_CHANNELS_SHOP_PRODUCT, JUMP_INFO_QQ_MINI_GAME } 当 field 取值 dynamic_creative_id 且 operator 取值 EQUALS 时, 数组长度为 1 当 field 取值 data_model_version 时,数组长度为 1 可选值:{ AD_DATA_MODEL_VERSION_UNKNOWN, AD_DATA_MODEL_VERSION_V1, AD_DATA_MODEL_VERSION_V2, AD_DATA_MODEL_VERSION_V3 } 当 field 取值 component_custom_name 时,数组长度为 1 字段长度最小 1 字节,长度最大 1024 字节 当 field 取值 generation_type 时,数组长度为 1 可选值:{ COMPONENT_GENERATION_TYPE_USER_CREATE, COMPONENT_GENERATION_TYPE_SYSTEM_DERIVE } |
page
|
integer | 搜索页码 最小值 1,最大值 99999 默认值:1 |
page_size
|
integer | 一页显示的数据条数 最小值 1,最大值 200 默认值:10 |
organization_id
|
integer | 业务单元 id 最小值 0,最大值 9999999999 |
ad_context
|
struct | 广告上下文信息 |
marketing_goal*
|
enum | 营销目的类型,[枚举详情] 可选值:{ MARKETING_GOAL_UNKNOWN, MARKETING_GOAL_USER_GROWTH, MARKETING_GOAL_PRODUCT_SALES, MARKETING_GOAL_LEAD_RETENTION, MARKETING_GOAL_BRAND_PROMOTION, MARKETING_GOAL_INCREASE_FANS_INTERACTION } |
marketing_sub_goal
|
enum | 二级营销目的类型,[枚举详情] 可选值:{ MARKETING_SUB_GOAL_UNKNOWN, MARKETING_SUB_GOAL_NEW_GAME_RESERVE, MARKETING_SUB_GOAL_NEW_GAME_TEST, MARKETING_SUB_GOAL_NEW_GAME_LAUNCH, MARKETING_SUB_GOAL_PLATEAU_PHASE_LAUNCH, MARKETING_SUB_GOAL_MINI_GAME_NEW_CUSTOMER_GROWTH, MARKETING_SUB_GOAL_MINI_GAME_RETURN_CUSTOMER_ENGAGEMENT, MARKETING_SUB_GOAL_APP_ACQUISITION, MARKETING_SUB_GOAL_APP_ACTIVATION, MARKETING_SUB_GOAL_NOT_INSTALL_USER, MARKETING_SUB_GOAL_PRE_INSTALL_USER, MARKETING_SUB_GOAL_UNLOADED_USER, MARKETING_SUB_GOAL_SHORT_INACTIVE_USER, MARKETING_SUB_GOAL_LONG_INACTIVE_USER, MARKETING_SUB_GOAL_GAME_VERSION_UPGRADE } |
marketing_carrier_type*
|
enum | 营销载体类型,[枚举详情] 可选值:{ MARKETING_CARRIER_TYPE_UNKNOWN, MARKETING_CARRIER_TYPE_APP_ANDROID, MARKETING_CARRIER_TYPE_APP_IOS, MARKETING_CARRIER_TYPE_WECHAT_OFFICIAL_ACCOUNT, MARKETING_CARRIER_TYPE_JUMP_PAGE, MARKETING_CARRIER_TYPE_WECHAT_MINI_GAME, MARKETING_CARRIER_TYPE_WECHAT_CHANNELS_LIVE, MARKETING_CARRIER_TYPE_WECHAT_CHANNELS, MARKETING_CARRIER_TYPE_WECHAT_CHANNELS_LIVE_RESERVATION, MARKETING_CARRIER_TYPE_MINI_PROGRAM_WECHAT, MARKETING_CARRIER_TYPE_APP_QUICK_APP, MARKETING_CARRIER_TYPE_PC_GAME, MARKETING_CARRIER_TYPE_QQ_MINI_GAME, MARKETING_CARRIER_TYPE_APP_HARMONY } |
marketing_target_type*
|
enum | 推广产品类型,[枚举详情] 可选值:{ MARKETING_TARGET_TYPE_APP_ANDROID, MARKETING_TARGET_TYPE_APP_IOS, MARKETING_TARGET_TYPE_WECHAT_OFFICIAL_ACCOUNT, MARKETING_TARGET_TYPE_PRODUCT, MARKETING_TARGET_TYPE_TRAFFIC, MARKETING_TARGET_TYPE_LOCAL_STORE, MARKETING_TARGET_TYPE_WECHAT_MINI_GAME, MARKETING_TARGET_TYPE_CONSUMER_PRODUCT, MARKETING_TARGET_TYPE_WECHAT_CHANNELS, MARKETING_TARGET_TYPE_WECHAT_CHANNELS_LIVE, MARKETING_TARGET_TYPE_WECHAT_CHANNELS_LIVE_RESERVATION, MARKETING_TARGET_TYPE_MINI_PROGRAM_WECHAT, MARKETING_TARGET_TYPE_APP_QUICK_APP, MARKETING_TARGET_TYPE_CONSUME_MEDICAL, MARKETING_TARGET_TYPE_COMPREHENSIVE_HOUSEKEEPING, MARKETING_TARGET_TYPE_FICTION, MARKETING_TARGET_TYPE_SHORT_DRAMA, MARKETING_TARGET_TYPE_AUDIOVISUAL_ENTERTAINMENT, MARKETING_TARGET_TYPE_BEAUTY_AND_PERSONAL_CARE, MARKETING_TARGET_TYPE_WEDDING_AND_PORTRAIT_PHOTOGRAPHY, MARKETING_TARGET_TYPE_FRANCHISE_BRAND, MARKETING_TARGET_TYPE_ENTERPRISE_SERVICES, MARKETING_TARGET_TYPE_EXHIBITION_BOOTH_DESIGN, MARKETING_TARGET_TYPE_INSURANCE, MARKETING_TARGET_TYPE_BANK, MARKETING_TARGET_TYPE_CREDIT, MARKETING_TARGET_TYPE_INVESTMENT_CONSULTING, MARKETING_TARGET_TYPE_REAL_ESTATE, MARKETING_TARGET_TYPE_TELECOMMUNICATIONS_OPERATOR, MARKETING_TARGET_TYPE_TOURIST_ATTRACTIONS_TICKETS, MARKETING_TARGET_TYPE_RENOVATION_SERVICES, MARKETING_TARGET_TYPE_FURNITURE_AND_BUILDING_MATERIALS, MARKETING_TARGET_TYPE_EXHIBITION_SALES, MARKETING_TARGET_TYPE_MEDICINE_INDUSTRY_COMMERCIAL, MARKETING_TARGET_TYPE_FINANCE, MARKETING_TARGET_TYPE_LOCAL_STORE_PACKAGE, MARKETING_TARGET_TYPE_CATERING_AND_LEISURE, MARKETING_TARGET_TYPE_CHAIN_RESTAURANT, MARKETING_TARGET_TYPE_COMMODITY_SET, MARKETING_TARGET_TYPE_TOURIST_TRAVEL_ROUTE, MARKETING_TARGET_TYPE_TOURIST_CRUISE_LINE, MARKETING_TARGET_TYPE_TOURIST_HOTEL_SERVICE, MARKETING_TARGET_TYPE_TOURIST_AIRLINE_TICKETS, MARKETING_TARGET_TYPE_LOCAL_STORE_COMBINE_WITH_PRODUCT, MARKETING_TARGET_TYPE_ACTIVITY, MARKETING_TARGET_TYPE_STORE, MARKETING_TARGET_TYPE_MINI_GAME_QQ, MARKETING_TARGET_TYPE_PC_GAME, MARKETING_TARGET_TYPE_WECHAT_WORK, MARKETING_TARGET_TYPE_LIVE_STREAM_ROOM, MARKETING_TARGET_TYPE_PERSONAL_STORE, MARKETING_TARGET_TYPE_PLATFORM_CHANNEL, MARKETING_TARGET_TYPE_TWO_WHEEL_VEHICLE, MARKETING_TARGET_TYPE_GOVERNMENT_AFFAIRS, MARKETING_TARGET_TYPE_CAR_ECOLOGY, MARKETING_TARGET_TYPE_WECHAT_STORE_PRODUCT, MARKETING_TARGET_TYPE_APP_HARMONY, MARKETING_TARGET_TYPE_WECHAT_STORE_PRODUCT_SET } |
marketing_carrier_detail
|
struct | 营销载体详情,当营销载体类型是 MARKETING_CARRIER_TYPE_APP_ANDROID、MARKETING_CARRIER_TYPE_APP_IOS 和 MARKETING_CARRIER_TYPE_WECHAT_MINI_GAME 等需要使用该结构体 |
marketing_carrier_id*
|
string | 营销载体 id,如安卓应用 id、IOS 应用 id、小游戏 id 等 字段长度最小 0 字节,长度最大 2048 字节 |
marketing_sub_carrier_id
|
string | 二级营销载体 id |
marketing_carrier_name
|
string | 营销载体名称 |
marketing_asset_id
|
integer | 产品 id,marketing_asset_id 与 marketing_asset_outer_spec 不能同时为空,也不能同时使用 |
site_set*
|
enum[] | 投放站点集合,当前单站点或者 SITE_SET_TENCENT_NEWS+SITE_SET_TENCENT_VIDEO 的组合,[枚举详情] 数组最小长度 1,最大长度 32 可选值:{ SITE_SET_MOBILE_UNION, SITE_SET_WECHAT, SITE_SET_TENCENT_NEWS, SITE_SET_TENCENT_VIDEO, SITE_SET_MOBILE_YYB, SITE_SET_PCQQ, SITE_SET_KANDIAN, SITE_SET_QQ_MUSIC_GAME, SITE_SET_MOMENTS, SITE_SET_CHANNELS, SITE_SET_WECHAT_SEARCH, SITE_SET_WECHAT_PLUGIN, SITE_SET_QBSEARCH, SITE_SET_SEARCH_SCENE, SITE_SET_SEARCH_MOBILE_UNION } |
creative_template_id*
|
integer | 创意形式 id,具体请咨询您的运营接口人 |
promoted_asset_type
|
enum | 推广内容类型,[枚举详情] 可选值:{ PROMOTED_ASSET_TYPE_APP_ANDROID, PROMOTED_ASSET_TYPE_APP_IOS, PROMOTED_ASSET_TYPE_WECHAT_OFFICIAL_ACCOUNT, PROMOTED_ASSET_TYPE_EDUCATION, PROMOTED_ASSET_TYPE_TRAFFIC, PROMOTED_ASSET_TYPE_LOCAL_STORE, PROMOTED_ASSET_TYPE_MINIGAME, PROMOTED_ASSET_TYPE_CONSUMER_PRODUCT, PROMOTED_ASSET_TYPE_WECHAT_CHANNELS, PROMOTED_ASSET_TYPE_WECHAT_CHANNELS_LIVE, PROMOTED_ASSET_TYPE_WECHAT_CHANNELS_LIVE_RESERVATION, PROMOTED_ASSET_TYPE_MINI_PROGRAM_WECHAT, PROMOTED_ASSET_TYPE_APP_QUICK_APP, PROMOTED_ASSET_TYPE_CONSUME_MEDICAL, PROMOTED_ASSET_TYPE_COMPREHENSIVE_HOUSEKEEPING, PROMOTED_ASSET_TYPE_FICTION, PROMOTED_ASSET_TYPE_SHORT_DRAMA, PROMOTED_ASSET_TYPE_AUDIOVISUAL_ENTERTAINMENT, PROMOTED_ASSET_TYPE_BEAUTY_AND_PERSONAL_CARE, PROMOTED_ASSET_TYPE_WEDDING_AND_PORTRAIT_PHOTOGRAPHY, PROMOTED_ASSET_TYPE_FRANCHISE_BRAND, PROMOTED_ASSET_TYPE_ENTERPRISE_SERVICES, PROMOTED_ASSET_TYPE_EXHIBITION_BOOTH_DESIGN, PROMOTED_ASSET_TYPE_INSURANCE, PROMOTED_ASSET_TYPE_BANK, PROMOTED_ASSET_TYPE_CREDIT, PROMOTED_ASSET_TYPE_INVESTMENT_CONSULTING, PROMOTED_ASSET_TYPE_REAL_ESTATE, PROMOTED_ASSET_TYPE_TELECOMMUNICATIONS_OPERATOR, PROMOTED_ASSET_TYPE_TOURIST_ATTRACTIONS_TICKETS, PROMOTED_ASSET_TYPE_RENOVATION_SERVICES, PROMOTED_ASSET_TYPE_FURNITURE_AND_BUILDING_MATERIALS, PROMOTED_ASSET_TYPE_EXHIBITION_SALES, PROMOTED_ASSET_TYPE_MEDICINE_INDUSTRY_COMMERCIAL, PROMOTED_ASSET_TYPE_FINANCE, PROMOTED_ASSET_TYPE_LOCAL_STORE_PACKAGE, PROMOTED_ASSET_TYPE_CATERING_AND_LEISURE, PROMOTED_ASSET_TYPE_CHAIN_RESTAURANT, PROMOTED_ASSET_TYPE_COMMODITY_SET, PROMOTED_ASSET_TYPE_TOURIST_TRAVEL_ROUTE, PROMOTED_ASSET_TYPE_TOURIST_CRUISE_LINE, PROMOTED_ASSET_TYPE_TOURIST_HOTEL_SERVICE, PROMOTED_ASSET_TYPE_TOURIST_AIRLINE_TICKETS, PROMOTED_ASSET_TYPE_LOCAL_STORE_COMBINE_WITH_PRODUCT, PROMOTED_ASSET_TYPE_ACTIVITY, PROMOTED_ASSET_TYPE_STORE, PROMOTED_ASSET_TYPE_MINI_GAME_QQ, PROMOTED_ASSET_TYPE_PC_GAME, PROMOTED_ASSET_TYPE_WECHAT_WORK, PROMOTED_ASSET_TYPE_LIVE_STREAM_ROOM, PROMOTED_ASSET_TYPE_PERSONAL_STORE, PROMOTED_ASSET_TYPE_PLATFORM_CHANNEL, PROMOTED_ASSET_TYPE_TWO_WHEEL_VEHICLE, PROMOTED_ASSET_TYPE_GOVERNMENT_AFFAIRS, PROMOTED_ASSET_TYPE_CAR_ECOLOGY, PROMOTED_ASSET_TYPE_WECHAT_STORE_PRODUCT, PROMOTED_ASSET_TYPE_APP_HARMONY, PROMOTED_ASSET_TYPE_WECHAT_STORE_PRODUCT_SET } |
component_type
|
enum | 创意组件类型,[枚举详情] 可选值:{ UNKNOWN, TITLE, DESCRIPTION, IMAGE, IMAGE_LIST, JUMP_INFO, VIDEO, BRAND, CONSULT, PHONE, FORM, ACTION_BUTTON, CHOSEN_BUTTON, LABEL, SHOW_DATA, MARKETING_PENDANT, APP_GIFT_PACK_CODE, SHOP_IMAGE, COUNT_DOWN, BARRAGE, FLOATING_ZONE, TEXT_LINK, END_PAGE, LIVING_DESC, WECHAT_CHANNELS, SHORT_VIDEO, ELEMENT_STORY, WXGAME_PLAYABLE_PAGE, APP_PROMOTION_VIDEO, VIDEO_SHOWCASE, IMAGE_SHOWCASE, MINI_CARD_LINK, CONSULT_LINK, V2_TITLE, V2_DESCRIPTION, V2_LONG_SUBLINK, V2_SHORT_SUBLINK, V2_LONG_SUBLINK_LIST, V2_SHORT_SUBLINK_LIST, V2_APP_DOWNLOAD, V2_IMAGE_1X1, V2_IMAGE_LIST_1X1, V2_IMAGE_TEXT_1X1, V2_IMAGE_BIG_20X7, V2_VIDEO_16X9_IMAGE_16X9, V2_VIDEO_16X9_IMAGE_4X3, V2_VIDEO_16X9_IMAGE_1X1, V2_QUICK_CONSULT, V2_PHONE, V2_FORM, V2_BRAND, V2_LANDING_PAGE, V2_HOLIDAY_LOGO, V2_ACTION_BUTTON, V2_CHOSEN_BUTTON, V2_VIDEO_9X16_IMAGE_9X16, V2_IMAGE_16X9, V2_LABEL, V2_PROMOTION_SUBLINK, V2_IMAGE_LIST_3X2, V2_IMAGE_LIST_9X16, V2_LIST_SUBLINK, V2_MDPA_TITLE, V2_MDPA_DESCRIPTION } |
请求示例
curl -v -G 'https://api.e.qq.com/v3.0/component_detail/get?access_token=<ACCESS_TOKEN>×tamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'filtering=[
{
"values": []
}
]' \
-d 'page=1' \
-d 'page_size=10' \
-d 'ad_context={
"marketing_carrier_detail": [],
"site_set": []
}'
应答字段
名称 | 类型 | 描述 |
---|---|---|
list
|
struct[] | 返回信息列表 |
account_id
|
integer | 广告主帐号 id,有操作权限的帐号 id,不支持代理商 id |
organization_id
|
integer | 业务单元 id |
component_id
|
integer | 创意组件 id |
component_detail
|
struct | 创意组件内容 |
jump_info
|
struct | 创意组件内容 |
jump_info_list
|
struct[] | 落地页内容详情列表,数组长度为[0,100] |
page_type
|
enum | 落地页类型,[枚举详情] |
page_detail
|
struct | 落地页内容详情 |
official_detail
|
struct | 官方/蹊径落地页详情 |
page_id
|
int64 | 落地页 id |
page_name
|
string | 落地页名称-用于管理 |
playable_type
|
enum | 落地页互动类型,[枚举详情] |
preview_url
|
string | 预览地址 |
page_status
|
enum | 落地页状态,[枚举详情] |
wechat_channels_live_reserve_id
|
string | 视频号直播预约 id |
disable_code
|
integer | 不可用错误码 |
disable_message
|
string | 不可用错误信息 |
quote_creative_material
|
boolean | 落地页顶部组件是否引用创意素材图片或视频 |
wechat_mini_program_page_detail
|
struct | 小程序落地页详情 |
mini_program_id
|
string | 小程序 id |
mini_program_nick_name
|
string | 小程序名称 |
mini_program_icon_url
|
string | 小程序图标 url |
mini_program_path
|
string | 小程序路径 |
mini_program_paths
|
string[] | 小程序落地页 path 列表 |
wechat_mini_game_page_detail
|
struct | 小游戏落地页信息,视频号动态落地页内部按钮跳转时,需要额外传入 mini_game_id |
mini_game_id
|
string | 小游戏 id |
mini_game_nick_name
|
string | 小游戏名称 |
mini_game_icon_url
|
string | 小游戏图标 url |
mini_game_tracking_parameter
|
string | 小游戏监控参数,需以英文字符?开头,如:?channel=xxxx,字段长度最小 1 个等宽字符,长度最大 250 个等宽字符(即字段最大长度为 250 个中文字或全角标点,500 个英文字或半角标点。一个等宽字符等价于一个中文,等价于两个英文。) |
h5_detail
|
struct | H5 自定义落地页信息 |
page_url
|
string | 落地页 url |
android_app_detail
|
struct | 安卓默认下载落地页 |
android_app_id
|
integer | Android 应用 id,大于等于 0 小于 2^63 |
android_channel_package_id
|
string | 安卓应用渠道包 id |
android_app_name
|
string | 应用包名称,小于 255 个英文字符 |
android_channel_package_name
|
string | 安卓应用渠道包名称 |
ios_app_detail
|
struct | IOS 默认下载落地页 |
ios_app_id
|
integer | iOS 应用 id,大于等于 0 小于 2^63 |
ios_app_name
|
string | 应用包名称,小于 255 个英文字符 |
qq_mini_program_page_detail
|
struct | 小程序落地页详情 |
mini_program_id
|
string | 小程序 id |
mini_program_nick_name
|
string | 小程序名称 |
mini_program_icon_url
|
string | 小程序图标 url |
mini_program_path
|
string | 小程序路径 |
mini_program_paths
|
string[] | 小程序落地页 path 列表 |
qq_mini_game_page_detail
|
struct | qq 小游戏落地页信息 |
mini_game_id
|
string | 小游戏 id |
mini_game_nick_name
|
string | 小游戏名称 |
mini_game_icon_url
|
string | 小游戏图标 url |
wechat_official_account_detail_detail
|
struct | 微信公众号详情 |
app_id
|
string | 公众号 appId |
app_name
|
string | 公众号名称,小于 255 个英文字符 |
channels_shop_product_detail
|
struct | 小店商品落地页详情 |
product_id
|
integer | 微信小店商品 id |
shop_id
|
string | 微信小店 id |
product_name
|
string | 商品名称 |
shop_name
|
string | 小店名称 |
channels_reserve_live_detail
|
struct | 视频号直播预约详情 |
reserve_id
|
string | 视频号直播预约 id |
wechat_channels_export_nick_name
|
string | 视频号名称名称 |
channels_watch_live_detail
|
struct | 视频号观看直播详情 |
wechat_channels_export_nick_name
|
string | 视频号名称名称 |
wecom_consult_page_detail
|
struct | 企业微信落地页 |
wecom_consult_group_id
|
string | 客服组 id,小于 256 个英文字符 |
wecom_consult_group_name
|
string | 客户组名称 |
wecom_consult_count
|
integer | 客服数量 |
wecom_consult_group_set_name
|
string | 客户集名称 |
wecom_consult_group_set_id
|
string | 客服集 id,小于 256 个英文字符 |
wecom_consult_group_count
|
integer | 客服组数量 |
group_type
|
enum | 企微客服集类型,[枚举详情] |
wechat_channels_feed_page_detail
|
struct | 视频号视频详情页 |
wechat_channels_export_nick_name
|
string | 视频号名称名称 |
h5_profile_page_detail
|
struct | h5 profile 落地页信息 |
description
|
string | ,朋友圈头像及昵称跳转页简介,字段长度最小 1 个等宽字符,长度最大 120 等宽字符(即字段最大长度为 120 个中文字或全角标点,240 个英文字或半角标点。一个等宽字符等价于一个中文,等价于两个英文。); profile_type 为 PROFILE_TYPE_DEFINITION 时必填 |
head_image_id
|
string | ,头像图片 id,通过 [images 模块] 上传图片后获得; profile_type 为 PROFILE_TYPE_DEFINITION 时必填,head_image_id 对应的图片高、宽均为 512px、大小限制 400KB |
head_image_url
|
string | 头像 url |
owner_id
|
integer | 广告主帐号 id,有操作权限的帐号 id,不支持代理商 id |
profile_id
|
integer | 朋友圈头像及昵称跳转页 id |
profile_name
|
string | ,昵称,自定义时传入,不允许有特殊字符,字段长度最小 1 个等宽字符,长度最大 30 等宽字符(即字段最大长度为 15 个中文字或全角标点,30 个英文字或半角标点。一个等宽字符等价于一个中文,等价于两个英文。) |
profile_type
|
integer | 朋友圈头像及昵称跳转页 id |
is_backup
|
boolean | 是否为兜底落地页 |
backup_index
|
integer | 兜底落地页顺序,当 is_backup 为 true 时值有效 |
disable_code
|
integer | 不可用错误码 |
disable_message
|
string | 不可用错误信息 |
image_list
|
struct[] | 图片详情 |
image_id
|
string | 素材图片 id,通过 [images 模块] 上传图片后获得,仅在规格支持时传入,详见规格详情 |
image_url
|
string | 素材图片的 url,仅在规格支持时传入 |
video_list
|
struct[] | 视频详情 |
video_id
|
string | |
video_url
|
string | 视频的 url,仅在规格支持时传入 |
cover_id
|
string | 素材图片 id,通过 [images 模块] 上传图片后获得,仅在规格支持时传入,详见规格详情 |
cover_url
|
string | 素材图片的 url,仅在规格支持时传入 |
brand
|
struct | 品牌形象详情 |
brand_name
|
string | 品牌名称 |
brand_image_id
|
string | 品牌形象图片 id,通过 [images 模块] 上传图片后获得,仅在规格支持时传入,详见规格详情 |
jump_info
|
struct | 创意组件内容 |
jump_info_list
|
struct[] | 落地页内容详情列表,数组长度为[0,100] |
page_type
|
enum | 落地页类型,[枚举详情] |
page_detail
|
struct | 落地页内容详情 |
official_detail
|
struct | 官方/蹊径落地页详情 |
page_id
|
int64 | 落地页 id |
page_name
|
string | 落地页名称-用于管理 |
playable_type
|
enum | 落地页互动类型,[枚举详情] |
preview_url
|
string | 预览地址 |
page_status
|
enum | 落地页状态,[枚举详情] |
wechat_channels_live_reserve_id
|
string | 视频号直播预约 id |
disable_code
|
integer | 不可用错误码 |
disable_message
|
string | 不可用错误信息 |
quote_creative_material
|
boolean | 落地页顶部组件是否引用创意素材图片或视频 |
wechat_mini_program_page_detail
|
struct | 小程序落地页详情 |
mini_program_id
|
string | 小程序 id |
mini_program_nick_name
|
string | 小程序名称 |
mini_program_icon_url
|
string | 小程序图标 url |
mini_program_path
|
string | 小程序路径 |
mini_program_paths
|
string[] | 小程序落地页 path 列表 |
wechat_mini_game_page_detail
|
struct | 小游戏落地页信息,视频号动态落地页内部按钮跳转时,需要额外传入 mini_game_id |
mini_game_id
|
string | 小游戏 id |
mini_game_nick_name
|
string | 小游戏名称 |
mini_game_icon_url
|
string | 小游戏图标 url |
mini_game_tracking_parameter
|
string | 小游戏监控参数,需以英文字符?开头,如:?channel=xxxx,字段长度最小 1 个等宽字符,长度最大 250 个等宽字符(即字段最大长度为 250 个中文字或全角标点,500 个英文字或半角标点。一个等宽字符等价于一个中文,等价于两个英文。) |
h5_detail
|
struct | H5 自定义落地页信息 |
page_url
|
string | 落地页 url |
android_app_detail
|
struct | 安卓默认下载落地页 |
android_app_id
|
integer | Android 应用 id,大于等于 0 小于 2^63 |
android_channel_package_id
|
string | 安卓应用渠道包 id |
android_app_name
|
string | 应用包名称,小于 255 个英文字符 |
android_channel_package_name
|
string | 安卓应用渠道包名称 |
ios_app_detail
|
struct | IOS 默认下载落地页 |
ios_app_id
|
integer | iOS 应用 id,大于等于 0 小于 2^63 |
ios_app_name
|
string | 应用包名称,小于 255 个英文字符 |
qq_mini_program_page_detail
|
struct | 小程序落地页详情 |
mini_program_id
|
string | 小程序 id |
mini_program_nick_name
|
string | 小程序名称 |
mini_program_icon_url
|
string | 小程序图标 url |
mini_program_path
|
string | 小程序路径 |
mini_program_paths
|
string[] | 小程序落地页 path 列表 |
qq_mini_game_page_detail
|
struct | qq 小游戏落地页信息 |
mini_game_id
|
string | 小游戏 id |
mini_game_nick_name
|
string | 小游戏名称 |
mini_game_icon_url
|
string | 小游戏图标 url |
wechat_official_account_detail_detail
|
struct | 微信公众号详情 |
app_id
|
string | 公众号 appId |
app_name
|
string | 公众号名称,小于 255 个英文字符 |
channels_shop_product_detail
|
struct | 小店商品落地页详情 |
product_id
|
integer | 微信小店商品 id |
shop_id
|
string | 微信小店 id |
product_name
|
string | 商品名称 |
shop_name
|
string | 小店名称 |
channels_reserve_live_detail
|
struct | 视频号直播预约详情 |
reserve_id
|
string | 视频号直播预约 id |
wechat_channels_export_nick_name
|
string | 视频号名称名称 |
channels_watch_live_detail
|
struct | 视频号观看直播详情 |
wechat_channels_export_nick_name
|
string | 视频号名称名称 |
wecom_consult_page_detail
|
struct | 企业微信落地页 |
wecom_consult_group_id
|
string | 客服组 id,小于 256 个英文字符 |
wecom_consult_group_name
|
string | 客户组名称 |
wecom_consult_count
|
integer | 客服数量 |
wecom_consult_group_set_name
|
string | 客户集名称 |
wecom_consult_group_set_id
|
string | 客服集 id,小于 256 个英文字符 |
wecom_consult_group_count
|
integer | 客服组数量 |
group_type
|
enum | 企微客服集类型,[枚举详情] |
wechat_channels_feed_page_detail
|
struct | 视频号视频详情页 |
wechat_channels_export_nick_name
|
string | 视频号名称名称 |
h5_profile_page_detail
|
struct | h5 profile 落地页信息 |
description
|
string | ,朋友圈头像及昵称跳转页简介,字段长度最小 1 个等宽字符,长度最大 120 等宽字符(即字段最大长度为 120 个中文字或全角标点,240 个英文字或半角标点。一个等宽字符等价于一个中文,等价于两个英文。); profile_type 为 PROFILE_TYPE_DEFINITION 时必填 |
head_image_id
|
string | ,头像图片 id,通过 [images 模块] 上传图片后获得; profile_type 为 PROFILE_TYPE_DEFINITION 时必填,head_image_id 对应的图片高、宽均为 512px、大小限制 400KB |
head_image_url
|
string | 头像 url |
owner_id
|
integer | 广告主帐号 id,有操作权限的帐号 id,不支持代理商 id |
profile_id
|
integer | 朋友圈头像及昵称跳转页 id |
profile_name
|
string | ,昵称,自定义时传入,不允许有特殊字符,字段长度最小 1 个等宽字符,长度最大 30 等宽字符(即字段最大长度为 15 个中文字或全角标点,30 个英文字或半角标点。一个等宽字符等价于一个中文,等价于两个英文。) |
profile_type
|
integer | 朋友圈头像及昵称跳转页 id |
is_backup
|
boolean | 是否为兜底落地页 |
backup_index
|
integer | 兜底落地页顺序,当 is_backup 为 true 时值有效 |
disable_code
|
integer | 不可用错误码 |
disable_message
|
string | 不可用错误信息 |
page_info
|
struct | 分页配置信息 |
page
|
integer | 搜索页码 默认值:1 |
page_size
|
integer | 一页显示的数据条数 默认值:10 |
total_number
|
integer | 总条数 |
total_page
|
integer | 总页数 |
应答示例
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"list": [
{
"account_id": "<ACCOUNT_ID>",
"component_detail": {
"jump_info": {
"jump_info_list": [
{
"page_detail": {
"official_detail": [],
"wechat_mini_program_page_detail": {
"mini_program_paths": []
},
"wechat_mini_game_page_detail": [],
"h5_detail": [],
"android_app_detail": [],
"ios_app_detail": [],
"qq_mini_program_page_detail": {
"mini_program_paths": []
},
"qq_mini_game_page_detail": [],
"wechat_official_account_detail_detail": [],
"channels_shop_product_detail": [],
"channels_reserve_live_detail": [],
"channels_watch_live_detail": [],
"wecom_consult_page_detail": [],
"wechat_channels_feed_page_detail": [],
"h5_profile_page_detail": []
}
}
]
},
"image_list": [],
"video_list": [],
"brand": {
"jump_info": {
"jump_info_list": [
{
"page_detail": {
"official_detail": [],
"wechat_mini_program_page_detail": {
"mini_program_paths": []
},
"wechat_mini_game_page_detail": [],
"h5_detail": [],
"android_app_detail": [],
"ios_app_detail": [],
"qq_mini_program_page_detail": {
"mini_program_paths": []
},
"qq_mini_game_page_detail": [],
"wechat_official_account_detail_detail": [],
"channels_shop_product_detail": [],
"channels_reserve_live_detail": [],
"channels_watch_live_detail": [],
"wecom_consult_page_detail": [],
"wechat_channels_feed_page_detail": [],
"h5_profile_page_detail": []
}
}
]
}
}
}
}
],
"page_info": {
"page": 1,
"page_size": 10,
"total_number": 1,
"total_page": 1
}
}
}
可视化调试工具
问题仍未解决?
请前往腾讯广告反馈中心在线提交问题,我们的人工客服将为你服务