pp-amazon-ads

Amazon Ads — Printing Press CLI

前置条件：安装 CLI

此技能使用 amazon-ads-pp-cli 二进制文件。**调用此技能中的任何命令之前，必须先确认 CLI 已安装。**如果尚未安装，请先安装：

1. 使用 Printing Press 安装程序安装。在 macOS/Linux 上，二进制文件默认安装到 $HOME/.local/bin；在 Windows 上，默认安装到 %LOCALAPPDATA%\Programs\PrintingPress\bin：

   npx -y @mvanhorn/printing-press-library install amazon-ads --cli-only
   

2. 验证：amazon-ads-pp-cli --version
3. 确保所报告的安装目录位于将调用此技能的 Agent／运行时的 $PATH 中。

如果 npx 安装失败（例如没有 Node、处于离线状态等），请改用直接通过 Go 安装的方法（需要 Go 1.26.6 或更高版本）：

go install github.com/mvanhorn/printing-press-library/library/commerce/amazon-ads/cmd/amazon-ads-pp-cli@latest

如果安装后 --version 报告“command not found”，说明运行时无法在 $PATH 中找到二进制文件目录。验证成功之前，请勿执行此技能的命令。

从这里开始：盈利能力

对于关注自然流量与广告盈利能力的卖家，在浏览完整 API 范围之前，请先运行以下命令：

1. amazon-ads-pp-cli break-even-acos — 计算产品在亏损前可承受的最高 ACOS。
2. amazon-ads-pp-cli true-profit — 计算扣除 COGS、预估 Amazon 费用和广告支出后的产品利润。
3. amazon-ads-pp-cli acos-vs-tacos --report product-performance.csv --seller-store ~/.config/amazon-seller-pp-cli/store.db — 当卖家店铺中有匹配数据时，将广告支出与卖家店铺销售额关联，按 ASIN 计算 ACOS 和 TACOS。
4. amazon-ads-pp-cli portfolio-dashboard --report campaign-performance.csv — 汇总支出、销售额、订单、ACOS、CPC、CTR 和 CVR。
5. amazon-ads-pp-cli product-ad-profitability --report product-performance.csv --cogs-file products.toml — 根据广告表现和 COGS 估算每个 ASIN 的利润。
6. amazon-ads-pp-cli campaign-comparison --report campaign-performance.csv — 按支出、销售额、ACOS、CPC、CTR 和 CVR 比较广告活动。

如果命令要求提供 --report，请使用 amazon-ads-pp-cli reports recipe <command>；该命令会打印准确的报告类型、必需列、导出路径和示例表头。支持架构识别的工作流支持控制台 CSV／TSV 导出，以及 Ads API JSON／GZIP 报告文件。

当卖家店铺数据与广告报告有重合时，acos-vs-tacos 会将广告支出与卖家店铺销售额关联，并按 ASIN 计算 TACOS。目前，它尚不支持自然流量会话、转化率、父／子 ASIN 汇总、退款、未通过利润命令提供 --cogs-file 时的 COGS，或按组合计算 TACOS。对于卖家端的仪表板工作流，请交叉核对 amazon-seller-pp-cli sales-intel dashboard。

命令参考

amazon-ads-dsp-dsp — 管理 amazon ads dsp dsp

• amazon-ads-pp-cli amazon-ads-dsp-dsp get — 根据给定的广告主 ID 返回广告主信息。
• amazon-ads-pp-cli amazon-ads-dsp-dsp list — 返回符合筛选条件的广告主列表及其信息。

amazon-ads-profiles-profiles — 管理 amazon ads profiles profiles

• amazon-ads-pp-cli amazon-ads-profiles-profiles get-by-id — 除非当前账户至少创建过一个广告活动，否则此操作不会返回响应。
• amazon-ads-pp-cli amazon-ads-profiles-profiles list — 请注意，除非当前账户至少创建过一个广告活动，否则此操作不会返回响应。
• amazon-ads-pp-cli amazon-ads-profiles-profiles update — 请注意，此操作仅适用于使用 Sponsored Products 的卖家。

amazon-ads-sponsored-reports — 管理 amazon ads sponsored reports

• amazon-ads-pp-cli amazon-ads-sponsored-reports <reportId> — 使用此前通过该方法的 POST 请求报告后，其响应中的 reportId 值。

assets — 管理资源

• amazon-ads-pp-cli assets get — 获取资产及其元数据
• amazon-ads-pp-cli assets get-upload-location — 创建临时资源（上传位置），用于将资产上传到 Creative Assets 工具。
• amazon-ads-pp-cli assets register — 将资产上传到 /asset/upload API 端点提供的位置后，应调用此 API。
• amazon-ads-pp-cli assets search — 搜索资产

attribution — 管理归因

• amazon-ads-pp-cli attribution get-advertisers-by-profile — 对于卖家，一个归因档案关联一个广告主。
• amazon-ads-pp-cli attribution get-publisher-macro-tag — 某些第三方发布商不支持包含宏参数的标签。
• amazon-ads-pp-cli attribution get-publisher-tag-template — 第三方发布商，例如 Google Ads、Facebook、Microsoft Ads
• amazon-ads-pp-cli attribution get-publishers — 使用此响应来确定是否使用 macroTags 或 nonMacroTemplateTags 资源来获取标签
• amazon-ads-pp-cli attribution get-tags-by-campaign — 获取指定广告主列表的归因报告。

audiences — 管理受众

• amazon-ads-pp-cli audiences fetch-taxonomy — 返回给定类别路径的受众类别列表 需要以下权限之一
• amazon-ads-pp-cli audiences list — 返回广告主的受众细分列表。

benchmarks — 管理基准

• amazon-ads-pp-cli benchmarks get-brands — 获取广告账户在其 SB 广告活动中推广过的品牌列表 **需要以下权限之一
• amazon-ads-pp-cli benchmarks get-report-data — 提供实体有权访问的所有品牌和类别的指标概览。
• amazon-ads-pp-cli benchmarks get-time-series — 提供按可选参数筛选的指定品牌和类别的时间序列数据 **需要以下权限之一

billing — 管理账单

• amazon-ads-pp-cli billing bulk-get-notifications — 获取与每个广告账户关联的所有当前有效账单通知数组。
• amazon-ads-pp-cli billing bulk-get-status — 获取与每个广告账户关联的当前账单状态。

brands — 管理品牌

• amazon-ads-pp-cli brands — 获取与请求头中传入的档案 ID 关联的品牌数据对象数组。

currencies — 管理货币

• amazon-ads-pp-cli currencies — 使用请求头中的广告主标识符，获取其目标市场的本地化货币数组

dp — 管理 dp

• amazon-ads-pp-cli dp create — 创建新的数据提供商受众。请注意，API 调用速率限制为每秒 1 笔交易（TPS）。
• amazon-ads-pp-cli dp get — 获取指定标识符的受众元数据。
• amazon-ads-pp-cli dp update — 将记录关联到受众或取消关联。
• amazon-ads-pp-cli dp update-audiencemetadata — 更新指定标识符的现有受众元数据。
• amazon-ads-pp-cli dp update-users — 删除最初从客户端获取的用户数据。API 调用速率限制为每秒 1 笔交易（TPS）。

dsp — 管理 dsp

• amazon-ads-pp-cli dsp associate-line-items-to-creatives — 创建/删除广告系列项与创意之间的关联。注意：请勿传入 startDate、endDate 和 weight。

• amazon-ads-pp-cli dsp create-file-uploads-policy — 创建用于将文件上传到 AWS S3 的文件上传策略。文件上传策略将在 15 分钟后过期。

• amazon-ads-pp-cli dsp create-image-creative — 创建图片创意。注意：未来更新将支持一次创建多个图片创意。

• amazon-ads-pp-cli dsp create-line-items — 创建广告系列项。注意：未来更新将支持一次创建多个广告系列项。

• amazon-ads-pp-cli dsp create-orders — 创建订单。注意：未来更新将支持一次创建多个订单。

• amazon-ads-pp-cli dsp create-rec-creatives — 创建新的 Responsive eCommerce Creatives（REC）。

• amazon-ads-pp-cli dsp create-third-party-creative — 创建第三方创意。

• amazon-ads-pp-cli dsp create-video-creatives — 创建视频创意。注意：未来更新将支持一次创建多个视频创意。

• amazon-ads-pp-cli dsp export-products-by-order-id — 按标识符将转化跟踪产品导出为文件。文件 URL 将在 15 分钟后过期。

• amazon-ads-pp-cli dsp get-apps — 根据应用 ID 或文本查询获取应用。可以提供应用 ID 或文本查询其中之一，但不能同时提供两者。

• amazon-ads-pp-cli dsp get-conversion-trackings — 获取指定订单的转化跟踪信息。

• amazon-ads-pp-cli dsp get-creative-moderation — 按 creativeId 获取创意审核摘要。

• amazon-ads-pp-cli dsp get-creatives — 获取一个或多个创意。

• amazon-ads-pp-cli dsp get-domain-targeting — 获取一个或多个广告系列项的域名定向信息。

• amazon-ads-pp-cli dsp get-domains — 根据实体获取用于包含/排除的域名列表。列表按创建时间排序。

• amazon-ads-pp-cli dsp get-dv-custom-contextual-segments — 获取已关联 Double Verify 的账户的自定义上下文细分预竞价定向数据。

• amazon-ads-pp-cli dsp get-geo-locations — 根据 locationTargetingId 或文本查询（例如城市名称、邮政编码）获取 locationTargeting 对象。

• amazon-ads-pp-cli dsp get-goal-configurations — 获取可应用于订单的配置列表，以针对预期的广告活动目标进行优化。

• amazon-ads-pp-cli dsp get-iab-content-categories — 获取 IAB 内容类别层级列表，按 ID 升序排列。

• amazon-ads-pp-cli dsp get-image-creatives — 获取符合请求中所提供条件的图片创意。

• amazon-ads-pp-cli dsp get-line-item — 根据标识符获取包含完整信息的广告系列项。

• amazon-ads-pp-cli dsp get-line-items — 获取一个或多个包含基本信息的广告系列项。

• amazon-ads-pp-cli dsp get-odc-custom-predicts — 获取已关联 Oracle Data Cloud 的账户的自定义预测预竞价定向数据。

• amazon-ads-pp-cli dsp get-odc-standard-predicts — 获取 Oracle Data Cloud 提供的用于预竞价定向的标准预测。

• amazon-ads-pp-cli dsp get-order — 根据标识符获取包含完整信息的订单。

• amazon-ads-pp-cli dsp get-orders — 获取一个或多个包含基本信息的订单。

• amazon-ads-pp-cli dsp get-pixels — 根据筛选条件获取像素列表。必须提供 AdvertiserIdFilter。

• amazon-ads-pp-cli dsp get-pixels-by-order-id — 根据标识符获取转化跟踪像素。

• amazon-ads-pp-cli dsp get-product-categories — 获取产品类别对象层级列表，按 ID 升序排列。

• amazon-ads-pp-cli dsp get-products-by-order-id — 根据标识符获取转化跟踪产品。

• amazon-ads-pp-cli dsp get-rec-creatives — 获取符合请求中所提供条件的 Responsive eCommerce Creative（REC）。

• amazon-ads-pp-cli dsp get-supply-sources — 根据广告系列项类型、广告主和供应源类型获取供应源。

• amazon-ads-pp-cli dsp get-third-party-creatives — 获取符合请求中所提供条件的第三方创意。

• amazon-ads-pp-cli dsp get-video-creatives — 获取符合请求中所提供条件的视频创意。

• amazon-ads-pp-cli dsp list-line-item-creative-associations — 获取按指定条件筛选的创意关联数组。

• amazon-ads-pp-cli dsp preview-image-creative — 预览图片创意。

• amazon-ads-pp-cli dsp preview-rec-creative — 预览 Responsive eCommerce Creative（REC）。

• amazon-ads-pp-cli dsp preview-third-party-creative — 预览第三方创意。

• amazon-ads-pp-cli dsp preview-video-creative — 预览视频创意。

• amazon-ads-pp-cli dsp set-line-item-status — 设置指定广告系列项 ID 的投放激活状态。2.x 版本的广告系列项接受 `application/vnd.

• amazon-ads-pp-cli dsp set-order-status — 设置指定订单 ID 的投放激活状态。

• amazon-ads-pp-cli dsp update — 向订单添加或从订单中移除转化跟踪产品。

• amazon-ads-pp-cli dsp update-conversion-tracking — 向订单添加或从订单中移除转化跟踪信息。

• amazon-ads-pp-cli dsp update-domain-targeting — 使用请求正文中提供的 DomainTargeting 替换指定广告系列项的 DomainTargeting。

• amazon-ads-pp-cli dsp update-image-creative — 更新图片创意。注意：未来更新将支持一次更新多个图片创意。

• amazon-ads-pp-cli dsp update-line-item-creative-associations — 更新关联详情。此 API 用于更新 startDate、endDate 和 weight 参数。

• amazon-ads-pp-cli dsp update-line-items — 这是完整更新，而非部分修补。

• amazon-ads-pp-cli dsp update-orders — 这是完整更新，而非部分修补。

• amazon-ads-pp-cli dsp update-pixels-by-order-id — 向订单添加或从订单中移除转化跟踪像素。像素列表最多包含 100 个像素。

• amazon-ads-pp-cli dsp update-rec-creatives — 更新现有的 Responsive eCommerce Creatives（REC）。注意：未来更新将支持一次更新多个创意。

• amazon-ads-pp-cli dsp update-third-party-creative — 更新第三方创意。

• amazon-ads-pp-cli dsp update-video-creatives — 更新视频创意。注意：未来更新将支持一次更新多个视频创意。 dsp-reports-dsp — 管理 dsp 报告

• amazon-ads-pp-cli dsp-reports-dsp create-report-v3 — 使用此操作请求创建一份报告，其中包含有关 Amazon DSP 广告活动的指标。

• amazon-ads-pp-cli dsp-reports-dsp get-campaign-report-v3 — 在 reportId 字段中传入先前请求的报告标识符，以获取报告的当前状态。

eligibility — 管理资格

• amazon-ads-pp-cli eligibility product — 获取一组产品的广告资格对象列表。
• amazon-ads-pp-cli eligibility program — 检查广告主参与广告计划的资格。

history — 管理历史记录

• amazon-ads-pp-cli history — 返回符合指定筛选条件和时间范围的事件来源的更改历史记录。

hsa — 管理 hsa

insights — 管理洞察

• amazon-ads-pp-cli insights generate-brand-metrics-report — 以 CSV 或 JSON 格式生成 Brand Metrics 报告。
• amazon-ads-pp-cli insights get-brand-metrics-report — 获取可用指标的品牌报告的位置和状态。

invoices — 管理发票

• amazon-ads-pp-cli invoices get — 需要以下权限之一：['nemo_transactions_view','nemo_transactions_edit']
• amazon-ads-pp-cli invoices get-advertiser — 需要以下权限之一：['nemo_transactions_view','nemo_transactions_edit']

keywords — 管理关键词

• amazon-ads-pp-cli keywords — 返回指定市场或区域设置中的本地化关键词。

manager-accounts — 管理管理者账户

• amazon-ads-pp-cli manager-accounts create — 创建新的 Amazon Advertising [管理者账户](https://advertising.amazon.com/help?
• amazon-ads-pp-cli manager-accounts get-for-user — 返回所有[管理者账户](https://advertising.amazon.com/help?

measurement — 管理衡量

• amazon-ads-pp-cli measurement cancel-studies — 取消现有研究。研究一旦取消，便无法恢复。
• amazon-ads-pp-cli measurement check-planning-eligibility — 检查是否符合所有供应商产品的规划资格。需要以下权限之一：[]
• amazon-ads-pp-cli measurement create-surveys — 创建新的研究调查。需要以下权限之一：[]
• amazon-ads-pp-cli measurement get-dspbrand-lift-study-result — 获取 DSP BRAND_LIFT 研究的结果。如果 Accept 标头请求 JSON 资源，则返回 200 成功响应。
• amazon-ads-pp-cli measurement get-studies — 根据 studyIds 列表或 advertiserIds 列表获取基础研究对象。需要以下权限之一：[]
• amazon-ads-pp-cli measurement get-surveys — 根据指定的调查标识符或研究标识符获取一个或多个研究调查。
• amazon-ads-pp-cli measurement omnichannel-metrics-brand-search — 搜索要用于 OMNICHANNEL_METRICS 供应商产品的品牌。需要以下权限之一：[]
• amazon-ads-pp-cli measurement update-surveys — 更新衡量调查。这将执行完整更新。需要以下权限之一：[]
• amazon-ads-pp-cli measurement vendor-product — 列出受支持的衡量供应商产品。需要以下权限之一：[]
• amazon-ads-pp-cli measurement vendor-product-policy — 获取指定供应商产品的政策。需要以下权限之一：[]
• amazon-ads-pp-cli measurement vendor-product-survey-question-templates — 获取指定供应商产品的调查问题模板。需要以下权限之一：[]

measurement-dsp — 管理 measurement dsp

• amazon-ads-pp-cli measurement-dsp check-dspaudience-research-eligibility — 检查 DSP AUDIENCE_RESEARCH 研究类型是否符合供应商产品的资格要求。
• amazon-ads-pp-cli measurement-dsp check-dspbrand-lift-eligibility — 检查 DSP BRAND_LIFT 研究类型是否符合供应商产品的资格要求。
• amazon-ads-pp-cli measurement-dsp check-dspcreative-testing-eligibility — 检查 DSP CREATIVE_TESTING 研究类型是否符合供应商产品的资格要求。
• amazon-ads-pp-cli measurement-dsp check-dspomnichannel-metrics-eligibility — 检查 DSP OMNICHANNEL_METRICS 研究类型是否符合供应商产品的资格要求。
• amazon-ads-pp-cli measurement-dsp create-dspaudience-research-study — 创建新的 DSP AUDIENCE_RESEARCH 研究。需要以下任一权限：[]
• amazon-ads-pp-cli measurement-dsp create-dspbrand-lift-studies — 创建新的 DSP BRAND_LIFT 研究。需要以下任一权限：[]
• amazon-ads-pp-cli measurement-dsp create-dspcreative-testing-study — 创建新的 DSP CREATIVE_TESTING 研究。需要以下任一权限：[]
• amazon-ads-pp-cli measurement-dsp create-dspomnichannel-metrics-studies — 创建新的 DSP OMNICHANNEL_METRICS 研究。需要以下任一权限：[]
• amazon-ads-pp-cli measurement-dsp get-dspaudience-research-studies — 根据指定的研究标识符或广告主标识符，获取一个或多个 DSP AUDIENCE_RESEARCH 研究。
• amazon-ads-pp-cli measurement-dsp get-dspaudience-research-study-result — 获取 DSP AUDIENCE_RESEARCH 研究的结果。
• amazon-ads-pp-cli measurement-dsp get-dspbrand-lift-studies — 根据指定的研究标识符或广告主标识符，获取一个或多个 DSP BRAND_LIFT 研究。
• amazon-ads-pp-cli measurement-dsp get-dspcreative-testing-studies — 根据指定的研究标识符或广告主标识符，获取一个或多个 DSP CREATIVE_TESTING 研究。
• amazon-ads-pp-cli measurement-dsp get-dspcreative-testing-study-result — 获取 DSP CREATIVE_TESTING 研究的结果。
• amazon-ads-pp-cli measurement-dsp get-dspomnichannel-metrics-studies — 根据指定的研究标识符或广告主标识符，获取一个或多个 DSP OMNICHANNEL_METRICS 研究。
• amazon-ads-pp-cli measurement-dsp get-dspomnichannel-metrics-study-result — 获取 DSP OMNICHANNEL_METRICS 研究的结果。
• amazon-ads-pp-cli measurement-dsp update-dspaudience-research-study — 更新 DSP AUDIENCE_RESEARCH 研究。此操作将执行完整更新。需要以下任一权限：[]
• amazon-ads-pp-cli measurement-dsp update-dspbrand-lift-studies — 更新 DSP BRAND_LIFT 研究。此操作将执行完整更新。需要以下任一权限：[]
• amazon-ads-pp-cli measurement-dsp update-dspcreative-testing-study — 更新 DSP CREATIVE_TESTING 研究。此操作将执行完整更新。需要以下任一权限：[]
• amazon-ads-pp-cli measurement-dsp update-dspomnichannel-metrics-studies — 更新 DSP OMNICHANNEL_METRICS 研究。此操作将执行完整更新。需要以下任一权限：[]

media — 管理媒体

• amazon-ads-pp-cli media complete-upload — 媒体上传至 /media/upload API 端点提供的位置后，应调用此 API。
• amazon-ads-pp-cli media create-upload-resource — 创建临时资源（上传位置），用于为广告计划上传媒体。
• amazon-ads-pp-cli media describe — 用于轮询媒体状态的 API。

overlapping-audiences — 管理重叠受众

• amazon-ads-pp-cli overlapping-audiences <audienceId> — 需要以下任一权限：['advertiser_campaign_edit','advertiser_campaign_view']

page-asins — 管理页面 ASIN

• amazon-ads-pp-cli page-asins — 请注意，对于卖家，地址必须是 Store 页面。供应商也可以指定自定义落地页地址。

pre-moderation — 管理预审核

• amazon-ads-pp-cli pre-moderation — 此 API 将接收广告/页面的不同组成部分，并自动验证这些组成部分，然后

产品 — 管理产品

• amazon-ads-pp-cli product — 需要以下权限之一：['advertiser_campaign_edit','advertiser_campaign_view']

产品 — 管理产品

• amazon-ads-pp-cli products — 将产品从源市场本地化（映射）到一个或多个目标市场。

配置文件 — 列出授权应用可用的 Amazon Ads 配置文件。

• amazon-ads-pp-cli profiles — 列出当前 Login with Amazon 凭据对应的广告配置文件。

报告 — 管理报告

• amazon-ads-pp-cli reports <reportId> — 了解异步报告的调用流程

sb — 管理 sb

• amazon-ads-pp-cli sb archive-campaign — 此操作等同于将状态字段设为 'archived' 的更新操作。

• amazon-ads-pp-cli sb archive-keyword — 此操作等同于将状态字段设为 'archived' 的更新操作。

• amazon-ads-pp-cli sb archive-negative-keyword — 此操作等同于将状态字段设为 'archived' 的更新操作。

• amazon-ads-pp-cli sb archive-negative-target — 归档指定标识符的否定投放目标。

• amazon-ads-pp-cli sb archive-target — 归档指定标识符的投放目标。

• amazon-ads-pp-cli sb create-campaigns — **注意：**要创建包含多个广告组的广告活动，请使用[版本 4 POST campaigns](https://advertising.amazon。

• amazon-ads-pp-cli sb create-draft-campaigns — 创建品牌推广草稿广告活动。**要创建视频广告活动，请将 adFormat 指定为 'video'。

• amazon-ads-pp-cli sb create-keywords — 请注意，创建关键词时无法设置 state。

• amazon-ads-pp-cli sb create-negative-keywords — 请注意，创建否定关键词时无法设置 bid 和 state。

• amazon-ads-pp-cli sb create-negative-targets — 创建一个或多个否定投放目标。

• amazon-ads-pp-cli sb create-targets — 创建一个或多个投放目标。

• amazon-ads-pp-cli sb delete-draft-campaign — 此操作等同于将状态字段设为 'archived' 的更新操作。

• amazon-ads-pp-cli sb get — 请注意，此资源仅适用于美国市场中的广告活动。

• amazon-ads-pp-cli sb get-ad-group — 获取指定标识符的广告组。

• amazon-ads-pp-cli sb get-bids-recommendations — 获取针对指定关键词或商品列表的竞价建议对象列表。

• amazon-ads-pp-cli sb get-brand-recommendations — 品牌建议基于请求中传入的类别标识符或关键词列表。

• amazon-ads-pp-cli sb get-campaign — 获取指定标识符的广告活动。

• amazon-ads-pp-cli sb get-draft-campaign — 获取指定标识符的草稿广告活动。

• amazon-ads-pp-cli sb get-keyword — 获取指定标识符的关键词。

• amazon-ads-pp-cli sb get-negative-keyword — 获取指定标识符的否定关键词。

• amazon-ads-pp-cli sb get-negative-target — 获取指定标识符的否定投放目标。

• amazon-ads-pp-cli sb get-product-recommendations — 建议基于请求中传入的 ASIN。

• amazon-ads-pp-cli sb get-target — 获取指定标识符的投放目标。

• amazon-ads-pp-cli sb get-targeting-categories — 建议基于请求中传入的 ASIN。

• amazon-ads-pp-cli sb list-ad-groups — 获取与授权标头中传入的客户端标识符关联的广告组数组

• amazon-ads-pp-cli sb list-campaigns — 注意：为确保获取所有广告活动数据，请使用[版本 4 list campaigns 端点](https://advertising。

• amazon-ads-pp-cli sb list-draft-campaigns — 获取与授权标头中传入的客户端标识符关联的所有草稿广告活动数组

• amazon-ads-pp-cli sb list-keywords — 获取符合可选条件筛选的关键词数组。

• amazon-ads-pp-cli sb list-negative-keywords — 获取符合可选条件筛选的否定关键词数组。

• amazon-ads-pp-cli sb list-negative-targets — 获取与授权标头中传入的客户端标识符关联的商品否定投放目标列表

• amazon-ads-pp-cli sb list-targets — 获取与授权标头中传入的客户端标识符关联的商品投放目标列表

• amazon-ads-pp-cli sb submit-draft-campaign — 成功提交后

• amazon-ads-pp-cli sb update-campaigns — 可变字段

• amazon-ads-pp-cli sb update-draft-campaigns — 更新一个或多个草稿广告活动。

• amazon-ads-pp-cli sb update-keywords — 提交更新的关键词可能会将状态设为 pending，以进行审核。审核最长可能需要 72 小时。

• amazon-ads-pp-cli sb update-negative-keywords — 提交更新的否定关键词可能会将状态设为 pending，以进行审核。

• amazon-ads-pp-cli sb update-negative-targets — 更新一个或多个否定投放目标。

• amazon-ads-pp-cli sb update-targets — 更新一个或多个投放目标。 sd — Manage sd

• amazon-ads-pp-cli sd archive-ad-group — 此操作等同于将 status 字段设为 'archived' 的更新操作。

• amazon-ads-pp-cli sd archive-campaign — 此操作等同于将 status 字段设为 'archived' 的更新操作。

• amazon-ads-pp-cli sd archive-negative-targeting-clause — 等同于使用 updateNegativeTargetingClauses 操作，将定向条款的 state 属性设为

• amazon-ads-pp-cli sd archive-product-ad — 此操作等同于将 status 字段设为 'archived' 的更新操作。

• amazon-ads-pp-cli sd archive-targeting-clause — 等同于使用 updateTargetingClauses 操作，将定向条款的 state 属性设为

• amazon-ads-pp-cli sd associate-optimization-rules-with-ad-group — 将一个或多个优化规则关联到由标识符指定的广告组。

• amazon-ads-pp-cli sd create-ad-groups — 创建一个或多个广告组。

• amazon-ads-pp-cli sd create-brand-safety-deny-list-domains — 创建一个或多个域名，将其添加到 Brand Safety Deny List。Brand Safety Deny List 位于广告主级别。

• amazon-ads-pp-cli sd create-campaigns — 创建一个或多个广告活动。

• amazon-ads-pp-cli sd create-creatives — 对一个或多个创意发起 POST 请求。

• amazon-ads-pp-cli sd create-negative-targeting-clauses — 成功创建并关联到广告组的否定定向条款会被分配唯一的目标标识符。

• amazon-ads-pp-cli sd create-optimization-rules — 此操作仅供预览。此功能可用后，将移除此说明。

• amazon-ads-pp-cli sd create-product-ads — 创建一个或多个商品广告。

• amazon-ads-pp-cli sd create-sdforecast — 返回 SD 预测请求中指定广告组的预测结果。

• amazon-ads-pp-cli sd create-targeting-clauses — 成功创建的定向条款会被分配唯一的 targetId 值。

• amazon-ads-pp-cli sd delete-brand-safety-deny-list — 归档 Brand Safety Deny List 中的所有域名。

• amazon-ads-pp-cli sd disassociate-optimization-rule — 此操作仅供预览。此功能可用后，将移除此说明。

• amazon-ads-pp-cli sd download-snapshot — **了解异步快照的调用流程

• amazon-ads-pp-cli sd get — 此操作仅供预览。此功能可用后，将移除此说明。

• amazon-ads-pp-cli sd get-ad-group — 返回指定广告活动的 AdGroup 对象。

• amazon-ads-pp-cli sd get-ad-group-response-ex — 获取指定广告组的扩展信息。

• amazon-ads-pp-cli sd get-adgroups — 此操作仅供预览。此功能可用后，将移除此说明。

• amazon-ads-pp-cli sd get-campaign — 返回指定广告活动的 Campaign 对象。

• amazon-ads-pp-cli sd get-campaign-response-ex — 返回指定广告活动的 CampaignResponseEx 对象。

• amazon-ads-pp-cli sd get-negative-targets — 此调用返回否定定向条款字段的最小集合，但比 getNegativeTargetsEx 更高效。

• amazon-ads-pp-cli sd get-negative-targets-ex — 获取包含扩展字段的否定定向条款。

• amazon-ads-pp-cli sd get-product-ad — 请注意，ProductAd 对象旨在用于效果

• amazon-ads-pp-cli sd get-product-ad-response-ex — 获取商品广告的扩展信息。

• amazon-ads-pp-cli sd get-request-results — 用户将域名添加到 Brand Safety Deny List 时，请求会异步处理

• amazon-ads-pp-cli sd get-request-status — 用户修改 Brand Safety Deny List 时，请求会异步处理

• amazon-ads-pp-cli sd get-snapshot — **了解异步快照的调用流程

• amazon-ads-pp-cli sd get-target-bid-recommendations — 根据输入的广告 ASIN 和同一批次中的定向条款列表，提供出价建议列表

• amazon-ads-pp-cli sd get-target-recommendations — 此 API 根据输入的 ASIN 列表，提供可用于定向的商品和类别建议。

• amazon-ads-pp-cli sd get-targets — 此调用返回定向条款字段的最小集合。

• amazon-ads-pp-cli sd get-targets-ex — 获取包含扩展字段的定向条款对象。

• amazon-ads-pp-cli sd list-ad-groups — 获取指定 Sponsored Display 广告组集合的 AdGroup 对象数组。

• amazon-ads-pp-cli sd list-ad-groups-ex — 获取指定广告组集合的 AdGroupResponseEx 对象数组。

• amazon-ads-pp-cli sd list-campaigns — 获取指定 Sponsored Display 广告活动集合的 Campaign 对象数组。

• amazon-ads-pp-cli sd list-campaigns-ex — 获取指定广告活动集合的 CampaignResponseEx 对象数组。

• amazon-ads-pp-cli sd list-creative-moderations — 获取创意审核列表

• amazon-ads-pp-cli sd list-creatives — 获取创意列表

• amazon-ads-pp-cli sd list-domains — 获取广告主 Brand Safety Deny List 中的网站/应用数组。

• amazon-ads-pp-cli sd list-negative-targeting-clauses — 获取指定 Sponsored Display 否定目标集合的否定定向条款对象列表。

• amazon-ads-pp-cli sd list-negative-targeting-clauses-ex — 获取指定否定目标集合的 NegativeTargetingClauseEx 对象数组。

• amazon-ads-pp-cli sd list-optimization-rules — 此操作仅供预览。此功能可用后，将移除此说明。

• amazon-ads-pp-cli sd list-product-ads — 获取指定 Sponsored Display 商品广告集合的 ProductAd 对象数组。

• amazon-ads-pp-cli sd list-product-ads-ex — 获取指定广告组集合的 ProductAdResponseEx 对象数组。

• amazon-ads-pp-cli sd list-request-status — 列出所有 Brand Safety List 请求的状态。列表包含过去 90 天内提交的请求。

• amazon-ads-pp-cli sd list-targeting-clauses — 获取指定 Sponsored Display 目标集合的定向条款对象列表。

• amazon-ads-pp-cli sd list-targeting-clauses-ex — 获取指定目标集合的 TargetingClauseEx 对象数组。

• amazon-ads-pp-cli sd post-creative-preview — 获取创意预览 HTML。

• amazon-ads-pp-cli sd update-ad-groups — 更新一个或多个广告组。

• amazon-ads-pp-cli sd update-campaigns — 更新一个或多个广告活动。

• amazon-ads-pp-cli sd update-creatives — 更新一个或多个创意。

• amazon-ads-pp-cli sd update-negative-targeting-clauses — 更新一个或多个否定定向条款。否定定向条款通过其 targetId 识别。

• amazon-ads-pp-cli sd update-optimization-rules — 此操作仅供预览。此功能可用后，将移除此说明。

• amazon-ads-pp-cli sd update-product-ads — 更新一个或多个商品广告。

• amazon-ads-pp-cli sd update-targeting-clauses — 更新一个或多个定向条款。定向条款通过其 targetId 识别。 sp — Manage sp

• amazon-ads-pp-cli sp archive-ad-group — 将广告组状态设为 archived。归档后的实体无法再次设为启用状态。

• amazon-ads-pp-cli sp archive-campaign — 将广告活动状态设为 archived。归档后的实体无法再次设为启用状态。

• amazon-ads-pp-cli sp archive-campaign-negative-keyword — 将指定广告活动否定关键词的状态设为 archived。

• amazon-ads-pp-cli sp archive-keyword — 将指定关键词的状态设为 archived。

• amazon-ads-pp-cli sp archive-negative-keyword — 将指定否定关键词的状态设为 archived。

• amazon-ads-pp-cli sp archive-negative-targeting-clause — 将否定定向条款的 status 设为 archived。

• amazon-ads-pp-cli sp archive-product-ad — 将指定商品广告的状态设为 archived。

• amazon-ads-pp-cli sp archive-targeting-clause — 将定向条款的 status 设为 archived。

• amazon-ads-pp-cli sp bulk-get-asin-suggested-keywords — 按效果从高到低的顺序，以数组形式返回建议关键词。

• amazon-ads-pp-cli sp create-ad-groups — 创建一个或多个广告组。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp create-campaign-negative-keywords — 创建一个或多个广告活动否定关键词。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp create-campaigns — 创建一个或多个广告活动。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp create-keyword-bid-recommendations — **弃用通知：此端点将于 2022 年 12 月 31 日弃用。

• amazon-ads-pp-cli sp create-keywords — 创建一个或多个关键词。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp create-negative-keywords — 创建一个或多个否定关键词。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp create-negative-targeting-clauses — 创建一个或多个否定定向表达式。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp create-product-ads — 创建一个或多个商品广告。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp create-target-recommendations — **弃用通知：此端点将于 2023 年 2 月 28 日弃用。

• amazon-ads-pp-cli sp create-targeting-clauses — 创建一个或多个定向表达式。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp download-snapshot — **了解异步快照的调用流程

• amazon-ads-pp-cli sp get-ad-group — 获取指定标识符的广告组。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp get-ad-group-bid-recommendations — **弃用通知：此端点将于 2022 年 12 月 31 日弃用。

• amazon-ads-pp-cli sp get-ad-group-ex — 获取包含扩展数据字段的广告组。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp get-ad-group-suggested-keywords — 获取指定广告组的建议关键词。

• amazon-ads-pp-cli sp get-ad-group-suggested-keywords-ex — 获取指定广告组的建议关键词及其扩展数据。

• amazon-ads-pp-cli sp get-ad-groups — 获取一个或多个广告组。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp get-ad-groups-ex — 获取包含扩展数据字段的广告组。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp get-asin-suggested-keywords — 按效果从高到低的顺序，以数组形式返回建议关键词。

• amazon-ads-pp-cli sp get-bid-recommendations — 获取关键词、商品或自动定向表达式的竞价建议列表。

• amazon-ads-pp-cli sp get-campaign — 获取指定标识符的广告活动。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp get-campaign-ex — 获取包含扩展数据字段的广告活动。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp get-campaign-negative-keyword — 获取指定标识符的广告活动否定关键词。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp get-campaign-negative-keyword-ex — 获取包含扩展数据字段的广告活动否定关键词。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp get-keyword — 获取指定标识符的关键词。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp get-keyword-bid-recommendations — **弃用通知：此端点将于 2022 年 12 月 31 日弃用。

• amazon-ads-pp-cli sp get-keyword-ex — 获取包含扩展数据字段的关键词。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp get-negative-keyword — 获取指定标识符的否定关键词。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp get-negative-keyword-ex — 获取包含扩展数据字段的否定关键词。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp get-negative-targeting-clause — 获取指定标识符的否定定向条款。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp get-negative-targeting-clause-ex — 获取指定标识符的否定定向条款。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp get-product-ad — 获取指定标识符的商品广告。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp get-product-ad-ex — 获取指定标识符的商品广告扩展数据。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp get-snapshot-status — **了解异步快照的调用流程

• amazon-ads-pp-cli sp get-targeting-clause — 获取指定标识符的定向条款。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp get-targeting-clause-ex — 获取指定标识符的定向条款。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp list-campaign-negative-keywords — 获取广告活动否定关键词列表。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp list-campaign-negative-keywords-ex — 获取包含扩展数据字段的广告活动否定关键词列表。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp list-campaigns — 获取广告活动数组。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp list-campaigns-ex — 获取包含扩展数据字段的广告活动数组。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp list-keywords — 获取一个或多个关键词。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp list-keywords-ex — 获取包含扩展数据字段的关键词列表。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp list-negative-keywords — 获取否定关键词对象列表。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp list-negative-keywords-ex — 获取包含扩展数据字段的否定关键词列表。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp list-negative-targeting-clauses — 获取按指定条件筛选的否定定向条款列表。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp list-negative-targeting-clauses-ex — 获取按指定条件筛选的否定定向条款列表。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp list-product-ads — 获取按指定条件筛选的商品广告列表。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp list-product-ads-ex — 获取按指定条件筛选的商品广告列表的扩展数据。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp list-targeting-clauses — 获取按指定条件筛选的定向条款列表。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp list-targeting-clauses-ex — 获取按指定条件筛选的定向条款列表。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp update-ad-groups — 更新一个或多个广告组。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp update-campaign-negative-keywords — 更新一个或多个广告活动否定关键词。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp update-campaigns — 更新一个或多个广告活动。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp update-keywords — 更新一个或多个关键词。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp update-negative-keywords — 更新一个或多个否定关键词。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp update-negative-targeting-clause — 更新一个或多个否定定向条款。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp update-product-ads — 更新指定标识符的一个或多个商品广告。[计划于 2023 年 6 月 30 日弃用]

• amazon-ads-pp-cli sp update-targeting-clause — 更新一个或多个定向条款。[计划于 2023 年 6 月 30 日弃用] sponsored-brands-sb — 管理赞助品牌 sb

• amazon-ads-pp-cli sponsored-brands-sb campaigns-budget-usage — 需要以下任一权限：['advertiser_campaign_edit','advertiser_campaign_view']

• amazon-ads-pp-cli sponsored-brands-sb create-associated-budget-rules-for-sbcampaigns — 一个广告活动最多可关联 250 条规则。

• amazon-ads-pp-cli sponsored-brands-sb create-brand-video-creative — 此 API 会为指定的 [Sponsored Brands 品牌视频广告](https 创建现有创意的新版本

• amazon-ads-pp-cli sponsored-brands-sb create-budget-rules-for-sbcampaigns — 需要以下任一权限：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-brands-sb create-product-collection-creative — 此 API 通过提供商品集合创意，为指定的 Sponsored Brands 广告创建创意的新版本

• amazon-ads-pp-cli sponsored-brands-sb create-sponsored-brand-store-spotlight-ads — 创建 Sponsored Brands 店铺聚焦广告。需要以下任一权限：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-brands-sb create-sponsored-brands-ad-groups — 创建 Sponsored Brands 广告组。需要以下任一权限：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-brands-sb create-sponsored-brands-brand-video-ads — 创建 Sponsored Brands 品牌视频广告。需要以下任一权限：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-brands-sb create-sponsored-brands-campaigns — 创建 Sponsored Brands 广告活动。需要以下任一权限：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-brands-sb create-sponsored-brands-product-collection-ads — 创建 Sponsored Brands 商品集合广告。需要以下任一权限：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-brands-sb create-sponsored-brands-video-ads — 创建 Sponsored Brands 视频广告。需要以下任一权限：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-brands-sb create-store-spotlight-creative — 此 API 通过提供店铺聚焦创意内容，为指定的 Sponsored Brands 广告创建创意的新版本

• amazon-ads-pp-cli sponsored-brands-sb create-video-creative — 此 API 通过提供视频创意，为指定的 Sponsored Brands 广告创建现有创意的新版本

• amazon-ads-pp-cli sponsored-brands-sb delete-sponsored-brands-ad-groups — 删除 Sponsored Brands 广告组。需要以下任一权限：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-brands-sb delete-sponsored-brands-ads — 删除 Sponsored Brands 广告。需要以下任一权限：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-brands-sb disassociate-associated-budget-rule-for-sbcampaigns — 解除指定广告活动与指定标识符预算规则之间的关联。

• amazon-ads-pp-cli sponsored-brands-sb get-budget-recommendations — 为请求的 Sponsored Brands 广告活动列表提供每日预算建议

• amazon-ads-pp-cli sponsored-brands-sb get-budget-rule-by-rule-id-for-sbcampaigns — 需要以下任一权限：['advertiser_campaign_edit','advertiser_campaign_view']

• amazon-ads-pp-cli sponsored-brands-sb get-campaign-shopper-segment-forecast — 获取购物者细分竞价广告活动的效果预测。

• amazon-ads-pp-cli sponsored-brands-sb get-campaigns-associated-with-sbbudget-rule — 获取与预算规则关联的所有广告活动

• amazon-ads-pp-cli sponsored-brands-sb get-headline-recommendations — 获取创意标题建议的 API。

• amazon-ads-pp-cli sponsored-brands-sb get-keyword-recommendations — 获取一组关键词建议对象，这些对象对应于落地页或 Stores 页面中包含的一组 ASIN。

• amazon-ads-pp-cli sponsored-brands-sb get-rule-based-budget-history-for-sbcampaigns — 返回所需参数 startDate 和 endDate 指定时间段内的预算历史记录。

• amazon-ads-pp-cli sponsored-brands-sb get-sbbudget-rules-for-advertiser — 获取广告主创建的所有预算规则

• amazon-ads-pp-cli sponsored-brands-sb list-associated-budget-rules-for-sbcampaigns — 需要以下任一权限：['advertiser_campaign_edit','advertiser_campaign_view']

• amazon-ads-pp-cli sponsored-brands-sb list-creatives — 此 API 获取符合指定资源标识符和筛选条件的所有 Sponsored Brands 创意数组

• amazon-ads-pp-cli sponsored-brands-sb list-sponsored-brands-ad-groups — 列出 Sponsored Brands 广告组。

• amazon-ads-pp-cli sponsored-brands-sb list-sponsored-brands-ads — 列出 Sponsored Brands 广告。

• amazon-ads-pp-cli sponsored-brands-sb list-sponsored-brands-campaigns — 列出 Sponsored Brands 广告活动。

• amazon-ads-pp-cli sponsored-brands-sb sbget-budget-rules-recommendation — 规则可在指定日期范围或特殊活动期间自动提高预算。

• amazon-ads-pp-cli sponsored-brands-sb sbtargeting-get-negative-brands — 返回建议用于否定定位的品牌。仅适用于 Sellers 和 Vendors。

• amazon-ads-pp-cli sponsored-brands-sb sbtargeting-get-refinements-for-category — 根据输入的类别返回细化条件。

• amazon-ads-pp-cli sponsored-brands-sb sbtargeting-get-targetable-asincounts — 根据用户提供的细化条件获取可定位 ASIN 的数量。

• amazon-ads-pp-cli sponsored-brands-sb sbtargeting-get-targetable-categories — 默认以列表形式返回所有可定位类别。

• amazon-ads-pp-cli sponsored-brands-sb update-budget-rules-for-sbcampaigns — 需要以下任一权限：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-brands-sb update-sponsored-brands-ad-groups — 更新 Sponsored Brands 广告组。需要以下任一权限：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-brands-sb update-sponsored-brands-ads — 更新 Sponsored Brands 广告。需要以下任一权限：['advertiser_campaign_edit'] sponsored-display-sd — 管理 sponsored display sd

• amazon-ads-pp-cli sponsored-display-sd campaigns-budget-usage — 需要以下权限之一：['advertiser_campaign_edit','advertiser_campaign_view']

• amazon-ads-pp-cli sponsored-display-sd create-associated-budget-rules-for-sdcampaigns — 每个广告活动最多可关联 250 条规则。

• amazon-ads-pp-cli sponsored-display-sd create-brand-safety-deny-list-domains — 创建一个或多个域名，并将其添加到 Brand Safety Deny List。Brand Safety Deny List 作用于广告主级别。

• amazon-ads-pp-cli sponsored-display-sd create-budget-rules-for-sdcampaigns — 创建一条或多条预算规则。

• amazon-ads-pp-cli sponsored-display-sd delete-brand-safety-deny-list — 归档 Brand Safety Deny List 中的所有域名。

• amazon-ads-pp-cli sponsored-display-sd disassociate-associated-budget-rule-for-sdcampaigns — 取消将指定标识符的预算规则与指定标识符的广告活动关联。

• amazon-ads-pp-cli sponsored-display-sd download-snapshot-by-id — 需要以下权限之一：['advertiser_campaign_edit','advertiser_campaign_view']

• amazon-ads-pp-cli sponsored-display-sd get-budget-rule-by-rule-id-for-sdcampaigns — 获取指定标识符的预算规则。

• amazon-ads-pp-cli sponsored-display-sd get-campaigns-associated-with-sdbudget-rule — 获取与预算规则关联的所有广告活动

• amazon-ads-pp-cli sponsored-display-sd get-headline-recommendations-for — 可使用此 Sponsored Display API，根据 ASIN 数组获取创意标题建议。

• amazon-ads-pp-cli sponsored-display-sd get-request-results — 用户将域名添加到 Brand Safety Deny List 时，请求会以异步方式处理

• amazon-ads-pp-cli sponsored-display-sd get-request-status — 用户修改 Brand Safety Deny List 时，请求会以异步方式处理

• amazon-ads-pp-cli sponsored-display-sd get-rule-based-budget-history-for-sdcampaigns — 返回所需的 startDate 和 endDate 参数指定时间段内的预算历史记录。

• amazon-ads-pp-cli sponsored-display-sd get-sdbudget-rules-for-advertiser — 获取广告主创建的所有预算规则

• amazon-ads-pp-cli sponsored-display-sd get-snapshot-by-id — 需要以下权限之一：['advertiser_campaign_edit','advertiser_campaign_view']

• amazon-ads-pp-cli sponsored-display-sd get-target-bid-recommendations — 根据输入的广告 ASIN 列表以及相同广告中的定向条款，提供竞价建议列表

• amazon-ads-pp-cli sponsored-display-sd get-target-recommendations — 根据输入的 ASIN 列表，提供可供定向的产品列表。

• amazon-ads-pp-cli sponsored-display-sd list-associated-budget-rules-for-sdcampaigns — 获取与指定标识符的广告活动关联的预算规则列表。

• amazon-ads-pp-cli sponsored-display-sd list-domains — 获取广告主 Brand Safety Deny List 中的网站／应用数组。

• amazon-ads-pp-cli sponsored-display-sd list-request-status — 列出所有 Brand Safety List 请求的状态。列表将包含过去 90 天内提交的请求。

• amazon-ads-pp-cli sponsored-display-sd update-budget-rules-for-sdcampaigns — 更新一条或多条预算规则。

sponsored-products-sp — 管理 sponsored products sp

• amazon-ads-pp-cli sponsored-products-sp campaigns-budget-usage — 需要以下权限之一：['advertiser_campaign_edit','advertiser_campaign_view']

• amazon-ads-pp-cli sponsored-products-sp create-associated-budget-rules-for-spcampaigns — 每个广告活动最多可关联 250 条规则。

• amazon-ads-pp-cli sponsored-products-sp create-budget-rules-for-spcampaigns — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp create-optimization-rule — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp create-sponsored-products-ad-groups — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp create-sponsored-products-campaign-negative-keywords — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp create-sponsored-products-campaign-negative-targeting-clauses — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp create-sponsored-products-campaigns — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp create-sponsored-products-keywords — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp create-sponsored-products-negative-keywords — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp create-sponsored-products-negative-targeting-clauses — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp create-sponsored-products-product-ads — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp create-sponsored-products-targeting-clauses — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp delete-campaign-optimization-rule — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp delete-sponsored-products-ad-groups — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp delete-sponsored-products-campaign-negative-keywords — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp delete-sponsored-products-campaign-negative-targeting-clauses — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp delete-sponsored-products-campaigns — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp delete-sponsored-products-keywords — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp delete-sponsored-products-negative-keywords — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp delete-sponsored-products-negative-targeting-clauses — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp delete-sponsored-products-product-ads — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp delete-sponsored-products-targeting-clauses — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp disassociate-associated-budget-rule-for-spcampaigns — 根据标识符，将指定预算规则与指定广告活动取消关联。

• amazon-ads-pp-cli sponsored-products-sp get-budget-recommendation — 创建新广告活动时，生成每日预算建议及基准指标。

• amazon-ads-pp-cli sponsored-products-sp get-budget-recommendations — 输入广告活动列表后，此 API 会提供以下指标 - 1.

• amazon-ads-pp-cli sponsored-products-sp get-budget-rule-by-rule-id-for-spcampaigns — 需要以下权限之一：['advertiser_campaign_edit','advertiser_campaign_view']

• amazon-ads-pp-cli sponsored-products-sp get-campaign-optimization-rule — 需要以下权限之一：['advertiser_campaign_edit','advertiser_campaign_view']

• amazon-ads-pp-cli sponsored-products-sp get-campaign-recommendations — 根据广告主资料 ID，获取 SP 广告活动在竞价、预算和定向方面的综合最佳建议。

• amazon-ads-pp-cli sponsored-products-sp get-campaigns-associated-with-spbudget-rule — 获取与预算规则关联的所有广告活动

• amazon-ads-pp-cli sponsored-products-sp get-category-recommendations-for-asins — 返回针对输入 ASIN 列表的类别建议。

• amazon-ads-pp-cli sponsored-products-sp get-negative-brands — 返回建议用于否定定向的品牌。仅限卖家和供应商使用。

• amazon-ads-pp-cli sponsored-products-sp get-optimization-rule-eligibility — 需要以下权限之一：['advertiser_campaign_edit','advertiser_campaign_view']

• amazon-ads-pp-cli sponsored-products-sp get-product-recommendations — 输入推广的 ASIN 后，此 API 会返回建议在商品定向广告活动中定向的 ASIN。

• amazon-ads-pp-cli sponsored-products-sp get-ranked-keyword-recommendation — POST /sp/targets/keywords/recommendations 端点会根据 A) 返回建议的关键词定向

• amazon-ads-pp-cli sponsored-products-sp get-refinements-for-category — 根据输入类别返回细化选项。

• amazon-ads-pp-cli sponsored-products-sp get-rule-based-budget-history-for-spcampaigns — 返回所需参数 startDate 和 endDate 指定时间段内的预算历史记录。

• amazon-ads-pp-cli sponsored-products-sp get-rule-notification — 需要以下权限之一：['advertiser_campaign_edit','advertiser_campaign_view']

• amazon-ads-pp-cli sponsored-products-sp get-spbudget-rules-for-advertiser — 获取广告主创建的所有预算规则

• amazon-ads-pp-cli sponsored-products-sp get-targetable-asincounts — 根据用户提供的细化选项，获取可定向 ASIN 的数量。

• amazon-ads-pp-cli sponsored-products-sp get-targetable-categories — 返回所有可定向类别。此 API 会返回一个包含类别节点树的大型 JSON 字符串。

• amazon-ads-pp-cli sponsored-products-sp get-theme-based-bid-recommendation-for-ad-group-v1 — 当前版本的主题竞价建议服务支持自动定向和关键词定向

• amazon-ads-pp-cli sponsored-products-sp list-associated-budget-rules-for-spcampaigns — 需要以下权限之一：['advertiser_campaign_edit','advertiser_campaign_view']

• amazon-ads-pp-cli sponsored-products-sp list-sponsored-products-ad-groups — 需要以下权限之一：['advertiser_campaign_edit','advertiser_campaign_view']

• amazon-ads-pp-cli sponsored-products-sp list-sponsored-products-campaign-negative-keywords — 需要以下权限之一：['advertiser_campaign_edit','advertiser_campaign_view']

• amazon-ads-pp-cli sponsored-products-sp list-sponsored-products-campaign-negative-targeting-clauses — 需要以下权限之一：['advertiser_campaign_edit','advertiser_campaign_view']

• amazon-ads-pp-cli sponsored-products-sp list-sponsored-products-campaigns — 需要以下权限之一：['advertiser_campaign_edit','advertiser_campaign_view']

• amazon-ads-pp-cli sponsored-products-sp list-sponsored-products-keywords — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp list-sponsored-products-negative-keywords — 需要以下权限之一：['advertiser_campaign_edit','advertiser_campaign_view']

• amazon-ads-pp-cli sponsored-products-sp list-sponsored-products-negative-targeting-clauses — 需要以下权限之一：['advertiser_campaign_edit','advertiser_campaign_view']

• amazon-ads-pp-cli sponsored-products-sp list-sponsored-products-product-ads — 需要以下权限之一：['advertiser_campaign_edit','advertiser_campaign_view']

• amazon-ads-pp-cli sponsored-products-sp list-sponsored-products-targeting-clauses — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp search-brands — 返回与用于否定定向的关键词输入相关的最多 100 个品牌。

• amazon-ads-pp-cli sponsored-products-sp spget-budget-rules-recommendation — 规则可在指定日期范围内或特殊活动期间自动提高预算。

• amazon-ads-pp-cli sponsored-products-sp update-budget-rules-for-spcampaigns — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp update-optimization-rule — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp update-sponsored-products-ad-groups — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp update-sponsored-products-campaign-negative-keywords — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp update-sponsored-products-campaign-negative-targeting-clauses — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp update-sponsored-products-campaigns — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp update-sponsored-products-keywords — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp update-sponsored-products-negative-keywords — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp update-sponsored-products-negative-targeting-clauses — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp update-sponsored-products-product-ads — 需要以下权限之一：['advertiser_campaign_edit']

• amazon-ads-pp-cli sponsored-products-sp update-sponsored-products-targeting-clauses — 需要以下权限之一：['advertiser_campaign_edit'] stores —（不适用于视频广告系列）

• amazon-ads-pp-cli stores create-asset — 图片资源会存储在 Store Assets Library 中。

• amazon-ads-pp-cli stores list-assets — 对于卖家或供应商，获取与指定品牌实体标识符关联的资源数组。

amazon-ads-pp-cli which "<capability in your own words>"

http://localhost:8085/callback

mkdir -p ~/.config/amazon-ads-pp-cli
chmod 700 ~/.config/amazon-ads-pp-cli
"$EDITOR" ~/.config/amazon-ads-pp-cli/.env

AMAZON_ADS_CLIENT_ID=your-client-id
AMAZON_ADS_CLIENT_SECRET=your-client-secret
AMAZON_ADS_REFRESH_TOKEN=
AMAZON_ADS_PROFILE_ID=

amazon-ads-pp-cli profiles list --json
amazon-ads-pp-cli profiles select <profile-id>
amazon-ads-pp-cli profiles current --json

amazon-ads-pp-cli break-even-acos --price 32.99 --cogs 8.50 --fees 30 --json
amazon-ads-pp-cli true-profit --price 32.99 --cogs 8.50 --fees 30 --ad-spend 4.20 --json
amazon-ads-pp-cli acos-vs-tacos --report product-performance.csv --seller-store ~/.config/amazon-seller-pp-cli/store.db --asin B0XXXX --json
amazon-ads-pp-cli portfolio-dashboard --report campaign-performance.csv --json
amazon-ads-pp-cli campaign-comparison --report campaign-performance.csv --json
amazon-ads-pp-cli product-ad-profitability --report product-performance.csv --cogs-file ~/.config/amazon-ads-pp-cli/cogs.toml --json
amazon-ads-pp-cli reports wait <report-id> --wait-timeout 20m --json
amazon-ads-pp-cli normalize-report --input downloaded-report.csv.gz --kind performance --output normalized.jsonl --format jsonl --store --json
amazon-ads-pp-cli placement-analysis --report placement-performance.csv --json
amazon-ads-pp-cli competitor-asin-mining --report product-targeting-performance.csv --asin B0XXXX --json
amazon-ads-pp-cli seasonal-planner --report historical-performance.csv --budget-multiplier 1.25 --json
amazon-ads-pp-cli dayparting-analysis --report hourly-performance.csv --json
amazon-ads-pp-cli budget-pacing --report hourly-campaign-performance.csv --threshold 0.90 --early-hour 18 --json
amazon-ads-pp-cli share-of-voice --report share-of-voice.csv --asin B0XXXX --keywords "self journal,daily planner" --json
amazon-ads-pp-cli search-term-mining --report search-terms.csv --target-acos 25 --json
amazon-ads-pp-cli wasted-spend --report search-terms.csv --threshold 10 --json
amazon-ads-pp-cli keyword-cannibalization --report search-terms.csv --json
amazon-ads-pp-cli negative-keyword-generator --report search-terms.csv --threshold 10 --json
amazon-ads-pp-cli new-keyword-opportunities --report search-terms.csv --target-acos 25 --json
amazon-ads-pp-cli bid-optimizer --report keyword-performance.csv --target-acos 25 --json
amazon-ads-pp-cli keyword-decay --baseline keyword-performance-previous.csv --current keyword-performance-current.csv --degradation-threshold 30 --min-spend 25 --json
amazon-ads-pp-cli keyword-lifecycle --report keyword-performance.csv --target-acos 25 --json
amazon-ads-pp-cli keyword-snapshots import --report keyword-performance.csv --snapshot-at 2026-02-01 --json
amazon-ads-pp-cli keyword-snapshots list --json
amazon-ads-pp-cli bid-history --keyword "self journal" --json
amazon-ads-pp-cli auto-negate --report search-terms.csv --threshold 15 --min-clicks 20 --json
amazon-ads-pp-cli auto-promote --report search-terms.csv --min-conversions 3 --max-acos 30 --json
amazon-ads-pp-cli budget-rebalance --report campaign-performance.csv --total-budget 500 --json
amazon-ads-pp-cli bid-rules apply --report keyword-performance.csv --file rules.json --json
amazon-ads-pp-cli automation-audit --limit 20 --json

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

amazon-ads-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
amazon-ads-pp-cli feedback --stdin < notes.txt
amazon-ads-pp-cli feedback list --json --limit 10

amazon-ads-pp-cli profile save briefing --json
amazon-ads-pp-cli --profile briefing amazon-ads-dsp-dsp list
amazon-ads-pp-cli profile list --json
amazon-ads-pp-cli profile show briefing
amazon-ads-pp-cli profile delete briefing --yes