轻易云
注册体验

领星ERPSB广告创意接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
广告 / 基础数据 · POST · 请求参数 5 个(必填 2) · 响应参数 32 个 · 限流令牌桶容量 10
更新日期
2026-11-21

SB广告创意

POST/pb/openapi/newad/hsaProductAds
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/pb/openapi/newad/hsaProductAds"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 10,
    "text": ""
  },
  "responseExample": {
    "code": 0,
    "message": "操作成功",
    "data": [
      {
        "campaign_id": 800000000000137200,
        "ad_group_id": 800000000000137700,
        "ad_creative_id": 448868552891455,
        "creative_id": 26,
        "name": "demo sb ads 2023-02-27 7db7",
        "state": "ENABLED",
        "creation_date": 1704643200000,
        "last_updated_date": 1704643200000,
        "profile_id": 9000000000000013,
        "serving_status": "AD_STATUS_LIVE",
        "asin": [
          "B09MT9BKGH",
          "B0BB389BKQ",
          "B09MYZ614S"
        ],
        "creative_type": "PRODUCT_COLLECTION",
        "creative": {
          "type": "PRODUCT_COLLECTION",
          "asins": [
            "B085M6Q95G",
            "B085M76XY1",
            "B09HZM3HG3"
          ],
          "headline": "demo34demo34",
          "brandName": "demo34demo34",
          "brandLogoAssetID": "CQD921XpVdf9WBJSXliI",
          "customImageAssetId": null
        },
        "landing_page": {
          "url": null,
          "asins": [
            "B085M6Q95G",
            "B085M76XY1",
            "B09HZM3HG3"
          ],
          "pageType": "STORE"
        }
      }
    ],
    "total": 1,
    "next_token": "ODAwMDAwMDAwMDAwMDAyNDE3",
    "error_details": [],
    "request_id": "6bb694e1-3d25-4821-8db8-d55dc903f6ba",
    "response_time": "2024-05-22 15:52:53"
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1sid店铺idint9013必填店铺id
2profile_idVC广告店铺profile_idint123456必填VC广告店铺profile_id,对应查询广告账号列表接口对应字段【profile_id】,sid跟profile_id其中一个必填
3offset分页偏移量int1可选分页偏移量,默认0
4length分页长度int1可选分页长度,默认15
5next_token分页游标string"MTAx"可选分页游标,上次分页结果中的next_token (第一次分页无需填写,当next_token 和 offset同时存在时以next_token为主

接口响应参数

序号字段名称类型默认值必填描述
1code状态码int0必填状态码,0 成功
2message提示消息string操作成功必填提示消息
3error_details错误信息array—必填错误信息
4request_id请求链路idstring6bb694e1-3d25-4821-8db8-d55dc903f6ba必填请求链路id
5response_time响应时间string2023-02-17 09:59:19必填响应时间
6total总数int1必填总数
7next_token分页游标string"ODAwMDAwMDAwMDAwMDAyNDE3"必填分页游标,填入下次请求中的next_token
8data响应数据array—必填响应数据
8.1campaign_id广告活动idnumber800000000000137200必填广告活动id
8.2ad_group_id广告组idnumber800000000000137700必填广告组id
8.3ad_creative_id广告创意id(亚马逊)number448868552891455必填广告创意id(亚马逊)
8.4creative_id广告创意id(已作废)number26必填广告创意id(已作废)
8.5name广告创意名称stringdemo sb ads 2023-02-27 7db7必填广告创意名称
8.6state广告创意状态stringenabled必填广告创意状态: ENABLED 启用 PAUSED 暂停 ARCHIVED 归档
8.7creation_date创建时间number1704643200000必填创建时间
8.8last_updated_date最后一次更新时间number1704643200000必填最后一次更新时间
8.9profile_id亚马逊店铺数字idnumber9000000000000013必填亚马逊店铺数字id
8.10serving_status服务状态stringAD_STATUS_LIVE必填服务状态: AD_POLICING_SUSPENDED INELIGIBLE REJECTED CAMPAIGN_OUT_OF_BUDGET CAMPAIGN_ARCHIVED ADVERTISER_PAYMENT_FAILURE CAMPAIGN_PAUSED AD_STATUS_LIVE PORTFOLIO_OUT_OF_BUDGET AD_GROUP_PAUSED PORTFOLIO_ENDED AD_PAUSED
8.11asin广告创意基础数据中ASIN字段array["B09MT9BKGH","B0BB389BKQ","B09MYZ614S"]必填广告创意基础数据中ASIN字段
8.12creative广告创意json详见返回成功示例必填广告创意
8.13creative_type广告创意类型stringPRODUCT_COLLECTION必填广告创意类型
8.14landing_page着落页json{"url": null, "asins": ["B085M6Q95G", "B085M76XY1", "B09HZM3HG3"], "pageType": "STORE"}必填着落页
8.15video_creatives当前广告关联的全部本地广告创意记录array—必填当前广告关联的全部本地广告创意记录,不按创意状态过滤;无关联创意时返回空数组
8.15.1creative_version广告创意版本stringcreative-9必填广告创意版本,不能作为视频素材版本使用
8.15.2creative_status广告创意状态stringDRAFT必填广告创意状态
8.15.3creative_type广告创意类型stringVIDEO必填广告创意类型
8.15.4videos当前创意引用的视频素材列表array—必填当前创意引用的视频素材列表;无视频素材时返回空数组
8.15.4.1asset_id视频素材idstringasset-a:version_v1必填视频素材id,保留广告创意中的原始值,可能包含:version_xxx后缀
8.15.4.2versions视频素材在本地保存的全部版本array—必填视频素材在本地保存的全部版本,按本地记录id升序返回;未找到素材时返回空数组
8.15.4.2.1asset_version视频素材版本string2必填视频素材版本,按数据库字符串原值返回
8.15.4.2.2name本地视频素材名称string商品演示视频必填本地视频素材名称
8.15.4.2.3url本地视频素材地址stringhttps://example.com/video-2.mp4必填本地视频素材地址,对应storage_location_urls.defaultUrl;地址缺失或格式异常时返回null

领星ERP的接口:SB广告创意(/pb/openapi/newad/hsaProductAds),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。