

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 整合 Amazon 销售合作伙伴 API
<a name="integrating-sp-api"></a>

要通过亚马逊销售合作伙伴 API (SP-API) 访问数据，您必须完成以下操作：

1. [注册成为 SP-API 开发者](#integrating-developer)

1. [申请 SP-API 角色](#integrating-roles)

1. [注册您的应用程序](#integrating-register)

1. [为您的应用程序选择授权模式](#integrating-authorization)

1. [Connect 到 SP-API](#integrating-connect)

## 注册成为 SP-API 开发者
<a name="integrating-developer"></a>

在注册 SP-API 应用程序之前，您必须创建一个亚马逊开发者账户并注册为 SP-API 开发者。有关开发者注册过程的全面概述，请参阅 [SP-API 文档中的 SP-API 注册概述](https://developer-docs.amazon.com/sp-api/docs/sp-api-registration-overview)。

## 申请 SP-API 角色
<a name="integrating-roles"></a>

[SP-API 角色](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api)决定开发人员或应用程序是否有权访问特定的操作或资源。作为开发人员，您必须申请并获得特定角色的资格，否则您将无法访问该角色下分组的操作和资源。

角色保护对个人身份信息 (PII) 和其他敏感数据的访问。他们限制数据访问权限，以确保开发人员只能访问其应用程序所需的数据。这有助于保护客户数据并保持客户信任。

访问品牌分析报告中提供的数据需要您具有[品牌分析角色](https://developer-docs.amazon.com/sp-api/docs/brand-analytics-role)。有关申请角色访问权限的更多信息，请参阅 SP-API [文档中的如何申请角色并获得该角色的资格](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#how-do-i-request-and-qualify-for-a-role)。

## 注册您的应用程序
<a name="integrating-register"></a>

注册过程因应用程序类型而略有不同。为了注册的目的，应用程序被归类为以下类型之一：
+ **公共应用程序和私人卖家申请**-这些应用程序是公开可用并由卖方或供应商授权的应用程序，或者它们是仅向您的组织提供且经过自我授权的卖家申请。
+ **私人供应商应用程序**-这些是供应商应用程序，仅供您的组织使用，并且需要自行授权。

有关更多信息，请参阅 SP-API 文档[中的注册应用程序](https://developer-docs.amazon.com/sp-api/docs/registering-your-application)。

## 为您的应用程序选择授权模式
<a name="integrating-authorization"></a>

卖家合作伙伴 API 的授权模型基于 Lo [gin with Amazon](https://developer.amazon.com/docs/login-with-amazon/documentation-overview.html)，这是亚马逊在 OAuth 2.0 中实现的。您的应用程序通过与 Amazon 显示的页面和您的网站进行交互来获得授权。Web 浏览器是用户代理，在每次卖家合作伙伴操作时，它都会在您的网站和 Amazon 之间传递参数。要实现 OAuth 授权，您必须将您的网站配置为接受和处理 Amazon 传递给它的参数。您还必须将您的网站配置为重定向网络浏览器并将参数传递给 Amazon。有关授权的更多信息，请参阅 SP-API 文档中的[授权销售合作伙伴 API 应用程序](https://developer-docs.amazon.com/sp-api/docs/authorizing-selling-partner-api-applications)。

### 了解应用程序授权
<a name="integrating-authorization-understand"></a>

就授权而言，有三种类型的应用程序：
+ **面向卖家的公开**申请-这些申请是公开提供的，并由卖家授权。您可以选择以下授权工作流程之一：
  + [销售合作伙伴应用商店授权工作流程](https://developer-docs.amazon.com/sp-api/docs/selling-partner-appstore-authorization-workflow)-从销售合作伙伴应用商店详情页面启动的 OAuth 授权工作流程。
  + [网站授权工作流程](https://developer-docs.amazon.com/sp-api/docs/website-authorization-workflow)-从您自己的网站启动的 OAuth授权工作流程。
+ **供应商的公开应用程序**-这些应用程序是公开可用的，并由供应商授权。您可以使用[网站授权工作流程](https://developer-docs.amazon.com/sp-api/docs/website-authorization-workflow)。这是一个从您自己的网站启动的 OAuth 授权工作流程。
+ **卖家或供应商的私人应用程序**-这些应用程序仅适用于您的组织。这些可以是卖方或供应商的申请。您可以使用[自我授权](https://developer-docs.amazon.com/sp-api/docs/self-authorization)方法。当你为自己的组织创建私有应用程序时，你可以自行授权它访问你的账户信息。您可以自行授权处于草稿状态的应用程序；没有理由发布私有应用程序。有关撤销卖家和供应商申请的自我授权的信息，请参阅 SP-API 文档中的[撤销自我授权](https://developer-docs.amazon.com/sp-api/docs/revoke-self-authorizations-from-your-application)。

### 授权供应商组访问应用程序
<a name="integrating-authorization-vendor-groups"></a>

当您授权您的销售合作伙伴 API 应用程序访问您的数据时，即表示您授予与供应商平台账户登录凭证关联的供应商群组的访问权限。通过扩展，您正在授予对供应商组中存在的所有供应商代码的访问权限。因此，使用正确的供应商中心凭证和供应商组进行销售合作伙伴 API 集成非常重要。

*供应商组*是您登录的账户。根据您的业务协议、运营模式和其他因素，您的供应商组可以包含一个或多个供应商代码。每个*供应商代码*都允许您在特定类别中发布商品，或者包含必要的业务协议，例如特定品牌的一个供应商代码。

您可以[对每个供应商组进行多项授权](https://developer-docs.amazon.com/sp-api/docs/authorize-vendor-groups-for-application-access#use-multiple-vendor-groups-to-authorize-an-application)，也可以创建包含所有[供应商代码的单个供应商组](https://developer-docs.amazon.com/sp-api/docs/authorize-vendor-groups-for-application-access#use-a-single-vendor-group-to-authorize-an-application)。使用与您的配置文件关联的多个供应商组的选项使您能够在不同的供应商组中使用具有相同供应商代码的应用程序。使用此选项，您不必为每个供应商组提交多个供应商开发者应用程序。

有关更多信息，请参阅 SP-API [文档中的授权供应商组访问应用程序](https://developer-docs.amazon.com/sp-api/docs/authorize-vendor-groups-for-application-access)。

## Connect 到 SP-API
<a name="integrating-connect"></a>

注册并授权您的应用程序后，就可以开始提出请求了。有关更多信息，请参阅 SP-API 文档中的[连接销售合作伙伴 AP](https://developer-docs.amazon.com/sp-api/docs/connecting-to-the-selling-partner-api) I。