/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×tamp=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
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | profileId | 当前租户已授权的亚马逊广告店铺标识 | string | — | 必填 | 当前租户已授权的亚马逊广告店铺标识,使用正整数形式的字符串,避免长整数精度丢失。 |
| 2 | ads | 待创建的商品推广广告列表 | array<object> | — | 必填 | 待创建的商品推广广告列表,每次提交 1~1000 条。 最少1项 最多1000项 |
| 2.1 | adGroupId | 广告所属广告组的唯一标识 | string | — | 必填 | 广告所属广告组的唯一标识,使用数字字符串。当前服务要求正整数值,且须属于当前授权广告店铺。 |
| 2.2 | adProduct | adProduct | string | — | 必填 | SPONSORED_PRODUCTS 表示商品推广广告。 |
| 2.3 | adType | adType | string | — | 必填 | PRODUCT_AD 表示根据指定商品构建的广告创意。 |
| 2.4 | creative | 商品推广广告的创意包装对象 | object | — | 必填 | 商品推广广告的创意包装对象。 |
| 2.4.1 | productCreative | 根据指定商品构建的创意 | object | — | 必填 | 根据指定商品构建的创意,包含商品创意设置。 |
| 2.4.1.1 | productCreativeSettings | 推广商品及可选的标题、聚焦视频配置 | object | — | 必填 | 推广商品及可选的标题、聚焦视频配置。 |
| 2.4.1.1.1 | advertisedProduct | 当前广告推广的商品 | object | — | 必填 | 当前广告推广的商品,包含商品标识、标识类型及可选的全球商店配置。 |
| 2.4.1.1.1.1 | globalStoreSetting | 推广商品的全球商店配置 | object | — | 可选 | 推广商品的全球商店配置,包含商品目录来源站点。 |
| 2.4.1.1.1.1.1 | catalogSourceMarketplace | 商品目录来源的亚马逊站点代码 | 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.2 | productId | 推广商品的标识 | string | — | 必填 | 推广商品的标识,与 productIdType 配套使用:ASIN 或卖家 SKU。当前服务要求非空字符串。 |
| 2.4.1.1.1.3 | productIdType | ASIN=亚马逊标准商品标识 | string | — | 必填 | ASIN=亚马逊标准商品标识 SKU=卖家库存商品编码。 |
| 2.4.1.1.2 | headline | 广告或视频创意使用的标题或自定义文本 | string | — | 可选 | 广告或视频创意使用的标题或自定义文本。 |
| 2.4.1.1.3 | spotlightVideos | 商品推广可选的视频创意配置 | object | — | 可选 | 商品推广可选的视频创意配置;传入时须同时提供文本优化开关和视频列表。 |
| 2.4.1.1.3.1 | optimizeText | true=允许亚马逊优化广告主提供的文本 | boolean | — | 必填 | true=允许亚马逊优化广告主提供的文本 false=不允许。 |
| 2.4.1.1.3.2 | videos | 用于商品推广的视频素材列表 | array<object> | — | 必填 | 用于商品推广的视频素材列表,包含 1~5 个视频;每个视频须提供素材 ID 和版本。 最少1项 |
| 2.4.1.1.3.2.1 | assetId | 素材库中视频素材的唯一标识 | string | — | 必填 | 素材库中视频素材的唯一标识。 |
| 2.4.1.1.3.2.2 | assetVersion | 素材库中视频素材对应的版本标识 | string | — | 必填 | 素材库中视频素材对应的版本标识。 |
| 2.4.1.1.3.2.3 | description | 视频素材内容的说明文本 | string | — | 可选 | 视频素材内容的说明文本。 |
| 2.4.1.1.3.2.4 | headline | 广告或视频创意使用的标题或自定义文本 | string | — | 必填 | 广告或视频创意使用的标题或自定义文本。 |
| 2.5 | state | ENABLED=已启用 | string | — | 必填 | ENABLED=已启用 PAUSED=已暂停。已启用的广告仍需满足父级状态、商品资格等投放条件。 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 平台业务状态码 | integer | 0 | 必填 | 平台业务状态码,0 表示成功 |
| 2 | message | 响应消息 | string | success | 必填 | 响应消息 |
| 3 | error_details | 参数校验等错误详情 | array<any> | [] | 必填 | 参数校验等错误详情 |
| 4 | request_id | 请求链路标识 | string | example-request-id | 必填 | 请求链路标识 |
| 5 | response_time | 响应时间 | string | 2026-10-19 12:00:00 | 必填 | 响应时间 |
| 6 | data | 响应数据 | object | — | 必填 | 响应数据。 |
| 6.1 | apiResult | 每项结果通过原始下标对应请求中的广告 | array<object> | — | 必填 | 每项结果通过原始下标对应请求中的广告;应检查每项结果码,批量或工具调用可能包含失败项。以下展示创建成功项,失败项可能仅含 code、index 和 description。 |
| 6.1.1 | adGroupId | 广告所属广告组的唯一标识 | string | — | 必填 | 广告所属广告组的唯一标识,使用数字字符串。当前服务要求正整数值,且须属于当前授权广告店铺。 |
| 6.1.2 | adId | 亚马逊生成的广告唯一标识 | string | — | 必填 | 亚马逊生成的广告唯一标识。使用字符串保存,避免长整数精度丢失。 |
| 6.1.3 | adProduct | adProduct | string | SPONSORED_PRODUCTS | 必填 | SPONSORED_PRODUCTS 表示商品推广广告。 |
| 6.1.4 | adType | adType | string | PRODUCT_AD | 必填 | PRODUCT_AD 表示根据指定商品构建的广告创意。 |
| 6.1.5 | campaignId | 广告所属广告活动的唯一标识 | string | — | 必填 | 广告所属广告活动的唯一标识,为只读返回字段。 |
| 6.1.6 | creationDateTime | 广告创建时间 | string | — | 必填 | 广告创建时间,采用带时区的日期时间格式。示例中的 -07:00 表示当地时间为协调世界时减 7 小时。 |
| 6.1.7 | creative | 商品推广广告的创意包装对象 | object | — | 必填 | 商品推广广告的创意包装对象。 |
| 6.1.7.1 | productCreative | 根据指定商品构建的创意 | object | — | 必填 | 根据指定商品构建的创意,包含商品创意设置。 |
| 6.1.7.1.1 | productCreativeSettings | 推广商品及可选的标题、聚焦视频配置 | object | — | 必填 | 推广商品及可选的标题、聚焦视频配置。 |
| 6.1.7.1.1.1 | advertisedProduct | 当前广告推广的商品 | object | — | 必填 | 当前广告推广的商品,包含商品标识、标识类型及可选的全球商店配置。 |
| 6.1.7.1.1.1.1 | globalStoreSetting | 推广商品的全球商店配置 | object | — | 必填 | 推广商品的全球商店配置,包含商品目录来源站点。 |
| 6.1.7.1.1.1.1.1 | catalogSourceMarketplace | 商品目录来源的亚马逊站点代码 | string | AE | 必填 | 商品目录来源的亚马逊站点代码 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.2 | productId | 推广商品的标识 | string | — | 必填 | 推广商品的标识,与 productIdType 配套使用:ASIN 或卖家 SKU。当前服务要求非空字符串。 |
| 6.1.7.1.1.1.3 | productIdType | ASIN=亚马逊标准商品标识 | string | ASIN | 必填 | ASIN=亚马逊标准商品标识 SKU=卖家库存商品编码。 |
| 6.1.7.1.1.1.4 | resolvedProductId | 与推广商品关联的解析后商品标识 | string | — | 必填 | 与推广商品关联的解析后商品标识,为只读返回字段。 |
| 6.1.7.1.1.1.5 | resolvedProductIdType | 解析后商品标识的类型 | string | ASIN | 必填 | 解析后商品标识的类型 ASIN=亚马逊标准商品标识 SKU=卖家库存商品编码。 |
| 6.1.7.1.1.2 | headline | 广告或视频创意使用的标题或自定义文本 | string | — | 必填 | 广告或视频创意使用的标题或自定义文本。 |
| 6.1.7.1.1.3 | spotlightVideos | 商品推广可选的视频创意配置 | object | — | 必填 | 商品推广可选的视频创意配置;传入时须同时提供文本优化开关和视频列表。 |
| 6.1.7.1.1.3.1 | optimizeText | true=允许亚马逊优化广告主提供的文本 | boolean | — | 必填 | true=允许亚马逊优化广告主提供的文本 false=不允许。 |
| 6.1.7.1.1.3.2 | videos | 用于商品推广的视频素材列表 | array<object> | — | 必填 | 用于商品推广的视频素材列表,包含 1~5 个视频;每个视频须提供素材 ID 和版本。 |
| 6.1.7.1.1.3.2.1 | assetId | 素材库中视频素材的唯一标识 | string | — | 必填 | 素材库中视频素材的唯一标识。 |
| 6.1.7.1.1.3.2.2 | assetVersion | 素材库中视频素材对应的版本标识 | string | — | 必填 | 素材库中视频素材对应的版本标识。 |
| 6.1.7.1.1.3.2.3 | description | 视频素材内容的说明文本 | string | — | 必填 | 视频素材内容的说明文本。 |
| 6.1.7.1.1.3.2.4 | headline | 广告或视频创意使用的标题或自定义文本 | string | — | 必填 | 广告或视频创意使用的标题或自定义文本。 |
| 6.1.8 | globalAdId | 管理当前站点广告的全球广告标识 | string | — | 必填 | 管理当前站点广告的全球广告标识;可选返回字段,本次示例未返回。 |
| 6.1.9 | lastUpdatedDateTime | 广告最后更新时间 | string | — | 必填 | 广告最后更新时间,采用带时区的日期时间格式,保留原始时区偏移。 |
| 6.1.10 | marketplaceScope | marketplaceScope | string | SINGLE_MARKETPLACE | 必填 | SINGLE_MARKETPLACE 表示单站点广告。 |
| 6.1.11 | marketplaces | string 数组 | 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.12 | state | ARCHIVED=已永久归档且不可重新启用 | string | ARCHIVED | 必填 | ARCHIVED=已永久归档且不可重新启用 ENABLED=已启用 PAUSED=已暂停。 |
| 6.1.13 | status | 广告的实际投放状态及其原因 | object | — | 必填 | 广告的实际投放状态及其原因。该对象不同于广告主设置的 state,本次响应只包含原因列表。 |
| 6.1.13.1 | deliveryReasons | string 数组 | 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.2 | deliveryStatus | DELIVERING=正在投放 | string | DELIVERING | 必填 | DELIVERING=正在投放 NOT_DELIVERING=未投放 UNAVAILABLE=状态不可用。本次真实响应未返回,不能仅凭原因列表补造此字段。 |
| 6.1.14 | code | SUCCESS 表示当前广告创建成功 | string | SUCCESS | 必填 | SUCCESS 表示当前广告创建成功。 |
| 6.1.15 | index | 对应请求广告数组中的原始下标 | integer | — | 必填 | 对应请求广告数组中的原始下标,从 0 开始。 |
| 7 | total | 统一响应中的总数 | integer | 0 | 必填 | 统一响应中的总数,本创建接口未设置分页总数,默认为0 |
领星ERP的接口:创建 SP 广告(/basicOpen/adReport/manage/postSpAds),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。