轻易云
注册体验

领星ERP创建 SP 广告接口

所属平台
领星ERP
类型
WebAPI
作用
EXECUTE
接口版本
1.0
适配器
\Adapter\LingXing\LXExecuteAdapter
授权方式
OTHER
描述
广告 / 广告管理 · POST · 请求参数 22 个(必填 17) · 响应参数 42 个 · 限流令牌桶容量 1
更新日期
2026-11-21

创建 SP 广告

POST/basicOpen/adReport/manage/postSpAds
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/adReport/manage/postSpAds"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSpAds?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"profileId\": \"1234567890123456\",\n    \"ads\": [\n        {\n            \"adGroupId\": \"1234567890123456\",\n            \"adProduct\": \"SPONSORED_PRODUCTS\",\n            \"adType\": \"PRODUCT_AD\",\n            \"creative\": {\n                \"productCreative\": {\n                    \"productCreativeSettings\": {\n                        \"advertisedProduct\": {\n                            \"productId\": \"B000000001\",\n                            \"productIdType\": \"ASIN\"\n                        }\n                    }\n                }\n            },\n            \"state\": \"PAUSED\"\n        }\n    ]\n}'",
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "example-request-id",
    "response_time": "2026-10-19 12:00:00",
    "data": {
      "apiResult": [
        {
          "adGroupId": "1234567890123456",
          "adId": "1234567890123456",
          "adProduct": "SPONSORED_PRODUCTS",
          "adType": "PRODUCT_AD",
          "campaignId": "1234567890123456",
          "creationDateTime": "2026-10-20T00:00:00Z",
          "creative": {
            "productCreative": {
              "productCreativeSettings": {
                "advertisedProduct": {
                  "globalStoreSetting": {
                    "catalogSourceMarketplace": "AE"
                  },
                  "productId": "B000000001",
                  "productIdType": "ASIN",
                  "resolvedProductId": "example",
                  "resolvedProductIdType": "ASIN"
                },
                "headline": "Example headline",
                "spotlightVideos": {
                  "optimizeText": false,
                  "videos": [
                    {
                      "assetId": "asset-id-placeholder",
                      "assetVersion": "1",
                      "description": "example",
                      "headline": "Example headline"
                    }
                  ]
                }
              }
            }
          },
          "globalAdId": "example",
          "lastUpdatedDateTime": "2026-10-20T00:00:00Z",
          "marketplaceScope": "SINGLE_MARKETPLACE",
          "marketplaces": [
            "US"
          ],
          "state": "PAUSED",
          "status": {
            "deliveryReasons": [
              "example"
            ],
            "deliveryStatus": "DELIVERING"
          },
          "code": "SUCCESS",
          "index": 0
        }
      ]
    },
    "total": 0
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1profileId当前租户已授权的亚马逊广告店铺标识string—必填当前租户已授权的亚马逊广告店铺标识,使用正整数形式的字符串,避免长整数精度丢失。
2ads待创建的商品推广广告列表array<object>—必填待创建的商品推广广告列表,每次提交 1~1000 条。 最少1项 最多1000项
2.1adGroupId广告所属广告组的唯一标识string—必填广告所属广告组的唯一标识,使用数字字符串。当前服务要求正整数值,且须属于当前授权广告店铺。
2.2adProductadProductstring—必填SPONSORED_PRODUCTS 表示商品推广广告。
2.3adTypeadTypestring—必填PRODUCT_AD 表示根据指定商品构建的广告创意。
2.4creative商品推广广告的创意包装对象object—必填商品推广广告的创意包装对象。
2.4.1productCreative根据指定商品构建的创意object—必填根据指定商品构建的创意,包含商品创意设置。
2.4.1.1productCreativeSettings推广商品及可选的标题、聚焦视频配置object—必填推广商品及可选的标题、聚焦视频配置。
2.4.1.1.1advertisedProduct当前广告推广的商品object—必填当前广告推广的商品,包含商品标识、标识类型及可选的全球商店配置。
2.4.1.1.1.1globalStoreSetting推广商品的全球商店配置object—可选推广商品的全球商店配置,包含商品目录来源站点。
2.4.1.1.1.1.1catalogSourceMarketplace商品目录来源的亚马逊站点代码string—可选商品目录来源的亚马逊站点代码 US 表示美国站。该值用于指定目录来源,不等同于修改广告投放站点。可不传或传空字符串,非空值须为列出的可选值 可选值: AE AU BE BR CA DE EG ES FR GB IE IN IT JP MX NL PL SA SE SG TR US ZA
2.4.1.1.1.2productId推广商品的标识string—必填推广商品的标识,与 productIdType 配套使用:ASIN 或卖家 SKU。当前服务要求非空字符串。
2.4.1.1.1.3productIdTypeASIN=亚马逊标准商品标识string—必填ASIN=亚马逊标准商品标识 SKU=卖家库存商品编码。
2.4.1.1.2headline广告或视频创意使用的标题或自定义文本string—可选广告或视频创意使用的标题或自定义文本。
2.4.1.1.3spotlightVideos商品推广可选的视频创意配置object—可选商品推广可选的视频创意配置;传入时须同时提供文本优化开关和视频列表。
2.4.1.1.3.1optimizeTexttrue=允许亚马逊优化广告主提供的文本boolean—必填true=允许亚马逊优化广告主提供的文本 false=不允许。
2.4.1.1.3.2videos用于商品推广的视频素材列表array<object>—必填用于商品推广的视频素材列表,包含 1~5 个视频;每个视频须提供素材 ID 和版本。 最少1项
2.4.1.1.3.2.1assetId素材库中视频素材的唯一标识string—必填素材库中视频素材的唯一标识。
2.4.1.1.3.2.2assetVersion素材库中视频素材对应的版本标识string—必填素材库中视频素材对应的版本标识。
2.4.1.1.3.2.3description视频素材内容的说明文本string—可选视频素材内容的说明文本。
2.4.1.1.3.2.4headline广告或视频创意使用的标题或自定义文本string—必填广告或视频创意使用的标题或自定义文本。
2.5stateENABLED=已启用string—必填ENABLED=已启用 PAUSED=已暂停。已启用的广告仍需满足父级状态、商品资格等投放条件。

接口响应参数

序号字段名称类型默认值必填描述
1code平台业务状态码integer0必填平台业务状态码,0 表示成功
2message响应消息stringsuccess必填响应消息
3error_details参数校验等错误详情array<any>[]必填参数校验等错误详情
4request_id请求链路标识stringexample-request-id必填请求链路标识
5response_time响应时间string2026-10-19 12:00:00必填响应时间
6data响应数据object—必填响应数据。
6.1apiResult每项结果通过原始下标对应请求中的广告array<object>—必填每项结果通过原始下标对应请求中的广告;应检查每项结果码,批量或工具调用可能包含失败项。以下展示创建成功项,失败项可能仅含 code、index 和 description。
6.1.1adGroupId广告所属广告组的唯一标识string—必填广告所属广告组的唯一标识,使用数字字符串。当前服务要求正整数值,且须属于当前授权广告店铺。
6.1.2adId亚马逊生成的广告唯一标识string—必填亚马逊生成的广告唯一标识。使用字符串保存,避免长整数精度丢失。
6.1.3adProductadProductstringSPONSORED_PRODUCTS必填SPONSORED_PRODUCTS 表示商品推广广告。
6.1.4adTypeadTypestringPRODUCT_AD必填PRODUCT_AD 表示根据指定商品构建的广告创意。
6.1.5campaignId广告所属广告活动的唯一标识string—必填广告所属广告活动的唯一标识,为只读返回字段。
6.1.6creationDateTime广告创建时间string—必填广告创建时间,采用带时区的日期时间格式。示例中的 -07:00 表示当地时间为协调世界时减 7 小时。
6.1.7creative商品推广广告的创意包装对象object—必填商品推广广告的创意包装对象。
6.1.7.1productCreative根据指定商品构建的创意object—必填根据指定商品构建的创意,包含商品创意设置。
6.1.7.1.1productCreativeSettings推广商品及可选的标题、聚焦视频配置object—必填推广商品及可选的标题、聚焦视频配置。
6.1.7.1.1.1advertisedProduct当前广告推广的商品object—必填当前广告推广的商品,包含商品标识、标识类型及可选的全球商店配置。
6.1.7.1.1.1.1globalStoreSetting推广商品的全球商店配置object—必填推广商品的全球商店配置,包含商品目录来源站点。
6.1.7.1.1.1.1.1catalogSourceMarketplace商品目录来源的亚马逊站点代码stringAE必填商品目录来源的亚马逊站点代码 US 表示美国站。该值用于指定目录来源,不等同于修改广告投放站点。 可选值: AE AU BE BR CA DE EG ES FR GB IE IN IT JP MX NL PL SA SE SG TR US ZA
6.1.7.1.1.1.2productId推广商品的标识string—必填推广商品的标识,与 productIdType 配套使用:ASIN 或卖家 SKU。当前服务要求非空字符串。
6.1.7.1.1.1.3productIdTypeASIN=亚马逊标准商品标识stringASIN必填ASIN=亚马逊标准商品标识 SKU=卖家库存商品编码。
6.1.7.1.1.1.4resolvedProductId与推广商品关联的解析后商品标识string—必填与推广商品关联的解析后商品标识,为只读返回字段。
6.1.7.1.1.1.5resolvedProductIdType解析后商品标识的类型stringASIN必填解析后商品标识的类型 ASIN=亚马逊标准商品标识 SKU=卖家库存商品编码。
6.1.7.1.1.2headline广告或视频创意使用的标题或自定义文本string—必填广告或视频创意使用的标题或自定义文本。
6.1.7.1.1.3spotlightVideos商品推广可选的视频创意配置object—必填商品推广可选的视频创意配置;传入时须同时提供文本优化开关和视频列表。
6.1.7.1.1.3.1optimizeTexttrue=允许亚马逊优化广告主提供的文本boolean—必填true=允许亚马逊优化广告主提供的文本 false=不允许。
6.1.7.1.1.3.2videos用于商品推广的视频素材列表array<object>—必填用于商品推广的视频素材列表,包含 1~5 个视频;每个视频须提供素材 ID 和版本。
6.1.7.1.1.3.2.1assetId素材库中视频素材的唯一标识string—必填素材库中视频素材的唯一标识。
6.1.7.1.1.3.2.2assetVersion素材库中视频素材对应的版本标识string—必填素材库中视频素材对应的版本标识。
6.1.7.1.1.3.2.3description视频素材内容的说明文本string—必填视频素材内容的说明文本。
6.1.7.1.1.3.2.4headline广告或视频创意使用的标题或自定义文本string—必填广告或视频创意使用的标题或自定义文本。
6.1.8globalAdId管理当前站点广告的全球广告标识string—必填管理当前站点广告的全球广告标识;可选返回字段,本次示例未返回。
6.1.9lastUpdatedDateTime广告最后更新时间string—必填广告最后更新时间,采用带时区的日期时间格式,保留原始时区偏移。
6.1.10marketplaceScopemarketplaceScopestringSINGLE_MARKETPLACE必填SINGLE_MARKETPLACE 表示单站点广告。
6.1.11marketplacesstring 数组array<any>—必填string 数组,广告适用的亚马逊零售站点代码,应与所属广告组相同或为其子集;当前定义为单站点,US 表示美国站。 可选值: AE AU BE BR CA DE EG ES FR GB IE IN IT JP MX NL PL SA SE SG TR US ZA
6.1.12stateARCHIVED=已永久归档且不可重新启用stringARCHIVED必填ARCHIVED=已永久归档且不可重新启用 ENABLED=已启用 PAUSED=已暂停。
6.1.13status广告的实际投放状态及其原因object—必填广告的实际投放状态及其原因。该对象不同于广告主设置的 state,本次响应只包含原因列表。
6.1.13.1deliveryReasonsstring 数组array<any>—必填string 数组,实际投放状态对应的原因列表,可为空数组,最多 50 项。OTHER 表示其他原因,无法据此确定具体原因。 可选值: ADVERTISER_ARCHIVED ADVERTISER_OUT_OF_BUDGET ADVERTISER_OUT_OF_POSTPAY_CREDIT_LIMIT ADVERTISER_OUT_OF_POSTPAY_MONTHLY_BUDGET ADVERTISER_OUT_OF_PREPAY_BALANCE ADVERTISER_PAUSED ADVERTISER_PAYMENT_FAILURE ADVERTISER_POLICING_PENDING_REVIEW ADVERTISER_POLICING_SUSPENDED AD_ARCHIVED AD_CREATION_FAILED AD_CREATION_IN_PROGRESS AD_EXTENSION_ARCHIVED AD_EXTENSION_PAUSED AD_EXTENSION_POLICING_PENDING_REVIEW AD_EXTENSION_POLICING_SUSPENDED AD_GROUP_ARCHIVED AD_GROUP_INCOMPLETE AD_GROUP_LOW_BID AD_GROUP_PAUSED AD_GROUP_PENDING_REVIEW AD_GROUP_POLICING_PENDING_REVIEW AD_GROUP_REJECTED AD_INELIGIBLE AD_MISSING_DECORATION AD_MISSING_IMAGE AD_NOT_DELIVERING AD_PAUSED AD_POLICING_PENDING_REVIEW AD_POLICING_SUSPENDED BRAND_INELIGIBLE CAMPAIGN_ARCHIVED CAMPAIGN_END_DATE_REACHED CAMPAIGN_INCOMPLETE CAMPAIGN_OUT_OF_BUDGET CAMPAIGN_PAUSED CAMPAIGN_PENDING_REVIEW CAMPAIGN_PENDING_START_DATE CAMPAIGN_REJECTED CREATIVE_MISSING_ASSET CREATIVE_PENDING_REVIEW CREATIVE_REJECTED LANDING_PAGE_INELIGIBLE LANDING_PAGE_NOT_AVAILABLE MODERATION_ADULT_NOVELTY_POLICY_VIOLATION MODERATION_ADULT_PRODUCT_POLICY_VIOLATION MODERATION_ADULT_SOFTLINES_POLICY_VIOLATION MODERATION_CLAIM_WEIGHTLOSS_POLICY_VIOLATION MODERATION_CONTENT_NUDITY_POLICY_VIOLATION MODERATION_CONTENT_PROVOCATIVE_POLICY_VIOLATION MODERATION_CONTENT_SMOKING_POLICY_VIOLATION MODERATION_CRITICAL_EVENTS_POLICY_VIOLATION MODERATION_ERROR_404 MODERATION_GRAPHICAL_SEXUAL_IMAGES_POLICY_VIOLATION MODERATION_HFSS_PRODUCT_POLICY_VIOLATION MODERATION_LANGUAGE_OFFENSIVE_POLICY_VIOLATION MODERATION_NOT_COMPLIANT_TO_AD_POLICY MODERATION_SMOKING_RELATED_POLICY_VIOLATION NOT_BUYABLE NOT_IN_BUYBOX NOT_IN_POLICY NO_INVENTORY NO_PURCHASABLE_OFFER OTHER OUT_OF_REWARD_BUDGET OUT_OF_STOCK PIR_RULE_EXCLUDED PORTFOLIO_ARCHIVED PORTFOLIO_END_DATE_REACHED PORTFOLIO_OUT_OF_BUDGET PORTFOLIO_PAUSED PORTFOLIO_PENDING_START_DATE SECURITY_SCAN_PENDING_REVIEW SECURITY_SCAN_REJECTED SPEND_LIMIT_EXCEEDED STATUS_UNAVAILABLE TARGET_ARCHIVED TARGET_BLOCKED TARGET_PAUSED TARGET_POLICING_SUSPENDED
6.1.13.2deliveryStatusDELIVERING=正在投放stringDELIVERING必填DELIVERING=正在投放 NOT_DELIVERING=未投放 UNAVAILABLE=状态不可用。本次真实响应未返回,不能仅凭原因列表补造此字段。
6.1.14codeSUCCESS 表示当前广告创建成功stringSUCCESS必填SUCCESS 表示当前广告创建成功。
6.1.15index对应请求广告数组中的原始下标integer—必填对应请求广告数组中的原始下标,从 0 开始。
7total统一响应中的总数integer0必填统一响应中的总数,本创建接口未设置分页总数,默认为0

领星ERP的接口:创建 SP 广告(/basicOpen/adReport/manage/postSpAds),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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