获取创意示例商品列表
开发环境
开发环境
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 | 商品竖版投放视频 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET '/v1.3/creative_sample_products/get' \
--header 'access_token;' \
--header 'timestamp;' \
--header '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": []
}
]
}
}请求参数
Header 参数
access_token
string
必需
默认值:
<ACCESS_TOKEN>
timestamp
string
必需
MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳
MarketingAPI 所使用的时区为GMT+8，例如当时间戳为1494840119时，表示 2018-05-15 17:21:59
默认值:
<TIMESTAMP>
nonce
string
必需
默认值:
<NONCE>
fields
string
必需
Body 参数application/x-www-form-urlencoded
account_id
integer
必需
示例值:
<ACCOUNT_ID>
product_outer_ids
string
商品 id 列表
示例值:
[]
product_fields
string
可选
示例值:
[]
product_catalog_id
integer
商品库 id
返回响应
修改于 2023-11-07 03:17:39