本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 整合 Amazon 銷售合作夥伴 API
若要透過 Amazon Selling Partner API (SP-API) 存取資料，您必須完成下列動作：
1. [註冊為 SP-API 開發人員](#integrating-developer)
1. [請求 SP-API 角色](#integrating-roles)
1. [註冊您的應用程式](#integrating-register)
1. [為您的應用程式選取授權模型](#integrating-authorization)
1. [連線至 SP-API](#integrating-connect)
## 註冊為 SP-API 開發人員
您必須先建立 Amazon 開發人員帳戶並註冊為 SP-API 開發人員，才能註冊 SP-API 應用程式。如需開發人員註冊程序的完整概觀，請參閱 [SP-API 文件中的 SP-API 註冊概觀](https://developer-docs.amazon.com/sp-api/docs/sp-api-registration-overview)。
## 請求 SP-API 角色
[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)。
## 註冊您的應用程式
註冊程序會因應用程式類型而略有不同。基於註冊目的，應用程式會分類為下列其中一種類型：
+ **公有應用程式和私有賣方應用程式** – 這些是公開可用的應用程式，並由賣方或廠商授權，或者是僅供您的組織使用且自我授權的賣方應用程式。
+ **私有廠商應用程式** – 這些是廠商應用程式，僅供您的組織使用，且需自我授權。
如需詳細資訊，請參閱 SP-API 文件中的[註冊您的應用程式](https://developer-docs.amazon.com/sp-api/docs/registering-your-application)。
## 為您的應用程式選取授權模型
銷售合作夥伴 API 的授權模式是以 [Login with Amazon ](https://developer.amazon.com/docs/login-with-amazon/documentation-overview.html)為基礎，這是 OAuth 2.0 的 Amazon 實作。您的應用程式是透過與 Amazon 和網站顯示的頁面互動進行授權。Web 瀏覽器是在每個銷售合作夥伴動作中，在您的網站和 Amazon 之間傳遞參數的使用者代理程式。若要實作 OAuth 授權，您必須將網站設定為接受和處理 Amazon 傳遞給它的參數。您也必須將網站設定為重新導向 Web 瀏覽器，並將參數傳遞至 Amazon。如需授權的詳細資訊，請參閱 SP-API 文件中的[授權銷售合作夥伴 API 應用程式](https://developer-docs.amazon.com/sp-api/docs/authorizing-selling-partner-api-applications)。
### 了解應用程式授權
基於授權目的，應用程式有三種類型：
+ **賣方的公有應用程式** – 這些應用程式可公開取得，並由賣方授權。您可以選擇下列其中一個授權工作流程：
+ [銷售合作夥伴 Appstore 授權工作流程](https://developer-docs.amazon.com/sp-api/docs/selling-partner-appstore-authorization-workflow) – 從銷售合作夥伴 Appstore 詳細資訊頁面啟動的 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)。
### 授權廠商群組進行應用程式存取
當您授權銷售合作夥伴 API 應用程式存取您的資料時，您會授予與 Vendor Central 帳戶登入憑證相關聯的廠商群組存取權。透過延伸，您將授予對廠商群組中存在之所有廠商代碼的存取權。因此，請務必使用正確的 Vendor Central 登入資料和廠商群組來進行銷售合作夥伴 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)。
## 連線至 SP-API
註冊並授權應用程式之後，您就可以開始提出請求。如需詳細資訊，請參閱 SP-API 文件中的[連線至銷售合作夥伴 API](https://developer-docs.amazon.com/sp-api/docs/connecting-to-the-selling-partner-api)。