获取创意示例商品列表
开发环境
开发环境
GET
/v1.3/creative_sample_products/get
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| account_id* | integer | 广告主 id，有操作权限的广告主 id |
| product_catalog_id* | integer | 商品库 id |
| product_outer_ids | array | 商品 id 列表 |
| product_series_id | integer | 商品系列 id |
| template_id | integer | 模板 id，查询可以被模板使用的示例商品 |
| template_type | enum | 模板类型，传入模板 id 时，该值必填，[枚举详情] 枚举列表：{ IMAGE, VIDEO } |
| image_id | int64 | 图片 id |
| video_id | int64 | 视频 id |
| product_fields | array | 商品字段列表，返回对应字段有值的商品列表，多字段之间取与的逻辑，即返回每个字段均存在的商品。 |
| limit | integer | 返回的商品数量 默认值：10 |
应答字段
| 名称 | 类型 | 描述 |
|---|---|---|
| list | struct[] | 返回信息列表 |
| product_catalog_id | integer | 商品库 id |
| product_series_id | integer | 商品系列 id |
| product_outer_id | string | 商品 id |
| product_name | string | 商品名称 |
| slogan | string | 商品 slogan |
| product_short_name | string | 商品短名称 |
| ad_brand_url | string | 商品 logo |
| image_url | string | 商品主图 |
| additional_image_url_1 | string | 商品副图 1 |
| advertisement_images | array | 商品投放图片 |
| advertisement_landscape_images | array | 商品投放图片 |
| advertisement_portrait_images | array | 商品投放图片 |
| video_url | string | 商品主视频 |
| ad_direct_videos | array | 商品投放视频 |
| ad_direct_landscape_video | string | 商品横版投放视频 |
| ad_direct_portrait_video | string | 商品竖版投放视频 |
请求参数
Header 参数
Body 参数application/x-www-form-urlencoded
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET '/v1.3/creative_sample_products/get' \
--header 'access_token: <ACCESS_TOKEN>' \
--header 'timestamp: <TIMESTAMP>' \
--header 'nonce: <NONCE>' \
--header 'fields;' \
--data-urlencode 'account_id=<ACCOUNT_ID>' \
--data-urlencode 'product_outer_ids=[]' \
--data-urlencode 'product_fields=[]' \
--data-urlencode 'product_catalog_id='响应示例响应示例
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"list": [
{
"advertisement_images": [],
"advertisement_landscape_images": [],
"advertisement_portrait_images": [],
"ad_direct_videos": []
}
]
}
}修改于 2023-11-07 03:17:39