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