Qeasy Cloud
Get Started

领星ERP 创建 SP 广告 API

Platform
领星ERP
Type
WebAPI
Effect
EXECUTE
API Version
1.0
Adapter
\Adapter\LingXing\LXExecuteAdapter
Auth Mode
OTHER
Description
广告 / 广告管理 · POST · 请求参数 22 个(必填 17) · 响应参数 42 个 · 限流令牌桶容量 1
Updated At
2026-11-21

创建 SP 广告

POST/basicOpen/adReport/manage/postSpAds
Factory
{
  "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
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1profileId当前租户已授权的亚马逊广告店铺标识string—Required当前租户已授权的亚马逊广告店铺标识,使用正整数形式的字符串,避免长整数精度丢失。
2ads待创建的商品推广广告列表array<object>—Required待创建的商品推广广告列表,每次提交 1~1000 条。 最少1项 最多1000项
2.1adGroupId广告所属广告组的唯一标识string—Required广告所属广告组的唯一标识,使用数字字符串。当前服务要求正整数值,且须属于当前授权广告店铺。
2.2adProductadProductstring—RequiredSPONSORED_PRODUCTS 表示商品推广广告。
2.3adTypeadTypestring—RequiredPRODUCT_AD 表示根据指定商品构建的广告创意。
2.4creative商品推广广告的创意包装对象object—Required商品推广广告的创意包装对象。
2.4.1productCreative根据指定商品构建的创意object—Required根据指定商品构建的创意,包含商品创意设置。
2.4.1.1productCreativeSettings推广商品及可选的标题、聚焦视频配置object—Required推广商品及可选的标题、聚焦视频配置。
2.4.1.1.1advertisedProduct当前广告推广的商品object—Required当前广告推广的商品,包含商品标识、标识类型及可选的全球商店配置。
2.4.1.1.1.1globalStoreSetting推广商品的全球商店配置object—Optional推广商品的全球商店配置,包含商品目录来源站点。
2.4.1.1.1.1.1catalogSourceMarketplace商品目录来源的亚马逊站点代码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.2productId推广商品的标识string—Required推广商品的标识,与 productIdType 配套使用:ASIN 或卖家 SKU。当前服务要求非空字符串。
2.4.1.1.1.3productIdTypeASIN=亚马逊标准商品标识string—RequiredASIN=亚马逊标准商品标识 SKU=卖家库存商品编码。
2.4.1.1.2headline广告或视频创意使用的标题或自定义文本string—Optional广告或视频创意使用的标题或自定义文本。
2.4.1.1.3spotlightVideos商品推广可选的视频创意配置object—Optional商品推广可选的视频创意配置;传入时须同时提供文本优化开关和视频列表。
2.4.1.1.3.1optimizeTexttrue=允许亚马逊优化广告主提供的文本boolean—Requiredtrue=允许亚马逊优化广告主提供的文本 false=不允许。
2.4.1.1.3.2videos用于商品推广的视频素材列表array<object>—Required用于商品推广的视频素材列表,包含 1~5 个视频;每个视频须提供素材 ID 和版本。 最少1项
2.4.1.1.3.2.1assetId素材库中视频素材的唯一标识string—Required素材库中视频素材的唯一标识。
2.4.1.1.3.2.2assetVersion素材库中视频素材对应的版本标识string—Required素材库中视频素材对应的版本标识。
2.4.1.1.3.2.3description视频素材内容的说明文本string—Optional视频素材内容的说明文本。
2.4.1.1.3.2.4headline广告或视频创意使用的标题或自定义文本string—Required广告或视频创意使用的标题或自定义文本。
2.5stateENABLED=已启用string—RequiredENABLED=已启用 PAUSED=已暂停。已启用的广告仍需满足父级状态、商品资格等投放条件。

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code平台业务状态码integer0Required平台业务状态码,0 表示成功
2message响应消息stringsuccessRequired响应消息
3error_details参数校验等错误详情array<any>[]Required参数校验等错误详情
4request_id请求链路标识stringexample-request-idRequired请求链路标识
5response_time响应时间string2026-10-19 12:00:00Required响应时间
6data响应数据object—Required响应数据。
6.1apiResult每项结果通过原始下标对应请求中的广告array<object>—Required每项结果通过原始下标对应请求中的广告;应检查每项结果码,批量或工具调用可能包含失败项。以下展示创建成功项,失败项可能仅含 code、index 和 description。
6.1.1adGroupId广告所属广告组的唯一标识string—Required广告所属广告组的唯一标识,使用数字字符串。当前服务要求正整数值,且须属于当前授权广告店铺。
6.1.2adId亚马逊生成的广告唯一标识string—Required亚马逊生成的广告唯一标识。使用字符串保存,避免长整数精度丢失。
6.1.3adProductadProductstringSPONSORED_PRODUCTSRequiredSPONSORED_PRODUCTS 表示商品推广广告。
6.1.4adTypeadTypestringPRODUCT_ADRequiredPRODUCT_AD 表示根据指定商品构建的广告创意。
6.1.5campaignId广告所属广告活动的唯一标识string—Required广告所属广告活动的唯一标识,为只读返回字段。
6.1.6creationDateTime广告创建时间string—Required广告创建时间,采用带时区的日期时间格式。示例中的 -07:00 表示当地时间为协调世界时减 7 小时。
6.1.7creative商品推广广告的创意包装对象object—Required商品推广广告的创意包装对象。
6.1.7.1productCreative根据指定商品构建的创意object—Required根据指定商品构建的创意,包含商品创意设置。
6.1.7.1.1productCreativeSettings推广商品及可选的标题、聚焦视频配置object—Required推广商品及可选的标题、聚焦视频配置。
6.1.7.1.1.1advertisedProduct当前广告推广的商品object—Required当前广告推广的商品,包含商品标识、标识类型及可选的全球商店配置。
6.1.7.1.1.1.1globalStoreSetting推广商品的全球商店配置object—Required推广商品的全球商店配置,包含商品目录来源站点。
6.1.7.1.1.1.1.1catalogSourceMarketplace商品目录来源的亚马逊站点代码stringAERequired商品目录来源的亚马逊站点代码 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—Required推广商品的标识,与 productIdType 配套使用:ASIN 或卖家 SKU。当前服务要求非空字符串。
6.1.7.1.1.1.3productIdTypeASIN=亚马逊标准商品标识stringASINRequiredASIN=亚马逊标准商品标识 SKU=卖家库存商品编码。
6.1.7.1.1.1.4resolvedProductId与推广商品关联的解析后商品标识string—Required与推广商品关联的解析后商品标识,为只读返回字段。
6.1.7.1.1.1.5resolvedProductIdType解析后商品标识的类型stringASINRequired解析后商品标识的类型 ASIN=亚马逊标准商品标识 SKU=卖家库存商品编码。
6.1.7.1.1.2headline广告或视频创意使用的标题或自定义文本string—Required广告或视频创意使用的标题或自定义文本。
6.1.7.1.1.3spotlightVideos商品推广可选的视频创意配置object—Required商品推广可选的视频创意配置;传入时须同时提供文本优化开关和视频列表。
6.1.7.1.1.3.1optimizeTexttrue=允许亚马逊优化广告主提供的文本boolean—Requiredtrue=允许亚马逊优化广告主提供的文本 false=不允许。
6.1.7.1.1.3.2videos用于商品推广的视频素材列表array<object>—Required用于商品推广的视频素材列表,包含 1~5 个视频;每个视频须提供素材 ID 和版本。
6.1.7.1.1.3.2.1assetId素材库中视频素材的唯一标识string—Required素材库中视频素材的唯一标识。
6.1.7.1.1.3.2.2assetVersion素材库中视频素材对应的版本标识string—Required素材库中视频素材对应的版本标识。
6.1.7.1.1.3.2.3description视频素材内容的说明文本string—Required视频素材内容的说明文本。
6.1.7.1.1.3.2.4headline广告或视频创意使用的标题或自定义文本string—Required广告或视频创意使用的标题或自定义文本。
6.1.8globalAdId管理当前站点广告的全球广告标识string—Required管理当前站点广告的全球广告标识;可选返回字段,本次示例未返回。
6.1.9lastUpdatedDateTime广告最后更新时间string—Required广告最后更新时间,采用带时区的日期时间格式,保留原始时区偏移。
6.1.10marketplaceScopemarketplaceScopestringSINGLE_MARKETPLACERequiredSINGLE_MARKETPLACE 表示单站点广告。
6.1.11marketplacesstring 数组array<any>—Requiredstring 数组,广告适用的亚马逊零售站点代码,应与所属广告组相同或为其子集;当前定义为单站点,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=已永久归档且不可重新启用stringARCHIVEDRequiredARCHIVED=已永久归档且不可重新启用 ENABLED=已启用 PAUSED=已暂停。
6.1.13status广告的实际投放状态及其原因object—Required广告的实际投放状态及其原因。该对象不同于广告主设置的 state,本次响应只包含原因列表。
6.1.13.1deliveryReasonsstring 数组array<any>—Requiredstring 数组,实际投放状态对应的原因列表,可为空数组,最多 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=正在投放stringDELIVERINGRequiredDELIVERING=正在投放 NOT_DELIVERING=未投放 UNAVAILABLE=状态不可用。本次真实响应未返回,不能仅凭原因列表补造此字段。
6.1.14codeSUCCESS 表示当前广告创建成功stringSUCCESSRequiredSUCCESS 表示当前广告创建成功。
6.1.15index对应请求广告数组中的原始下标integer—Required对应请求广告数组中的原始下标,从 0 开始。
7total统一响应中的总数integer0Required统一响应中的总数,本创建接口未设置分页总数,默认为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.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.