整合 Amazon Selling Partner API

若要透過 Amazon Selling Partner API（SP-API） 存取資料，您必須完成下列動作：

1. 註冊為 SP-API 開發人員

2. 請求 SP-API 角色

3. 註冊您的應用程式

4. 為您的應用程式選取授權模型

5. 連線至 SP-API

註冊為 SP-API 開發人員

您必須先建立 Amazon 開發人員帳戶並註冊為 SP 開發人員，才能註冊 SPAPI-API 應用程式。如需開發人員註冊程序的完整概觀，請參閱 SP 文件API中的 SP- 註冊概觀。API

請求 SP-API 角色

SP-API 角色會判斷開發人員或應用程式是否可以存取特定操作或資源。身為開發人員，您必須請求並符合特定角色的資格，否則您將無法存取該角色下分組的操作和資源。

角色會保護對個人身分識別資訊的存取 （PII） 和其他敏感資料。它們會限制資料存取，以確保開發人員只能存取其應用程式所需的資料。這有助於保護客戶資料並保持客戶信任。

存取品牌分析報告中可用的資料需要您具有品牌分析角色 。如需請求存取角色的詳細資訊，請參閱 SP 文件API中的如何請求角色並符合該角色的資格。

註冊您的應用程式

註冊程序會因應用程式類型而略有不同。為了註冊，應用程式會分類為下列其中一種類型：

• 公有應用程式和私有賣方應用程式 – 這些是可公開取得且由賣方或廠商授權的應用程式，或者是僅供您的組織使用且自我授權的賣方應用程式。

• 私有廠商應用程式 – 這些廠商應用程式僅供您的組織使用，且僅供自行授權。

如需詳細資訊，請參閱 SP 文件API中的註冊應用程式。

為您的應用程式選取授權模型

銷售合作夥伴的授權模型API是以使用 Amazon 登入 Amazon 2.0 OAuth 實作為基礎。您的應用程式是透過與 Amazon 和網站顯示的頁面互動進行授權。網頁瀏覽器是在每個銷售合作夥伴動作中，在網站與 Amazon 之間傳遞參數的使用者代理程式。若要實作OAuth授權，您必須設定您的網站以接受並處理 Amazon 傳遞給它的參數。您還必須設定網站以重新導向 Web 瀏覽器，並將參數傳遞至 Amazon。如需授權的詳細資訊，請參閱 SP 文件API中的授權銷售合作夥伴API應用程式。

了解應用程式授權

為了授權的目的，應用程式有三種類型：

• 賣方的公有應用程式 – 這些應用程式可公開取得，並由賣方授權。您可以選擇下列其中一個授權工作流程：

  • 銷售合作夥伴 Appstore 授權工作流程 – 從銷售合作夥伴 Appstore 詳細資訊頁面啟動OAuth的授權工作流程。

  • 網站授權工作流程 – 從您自己的網站啟動OAuth的授權工作流程。

• 廠商的公有應用程式 – 這些應用程式可公開取得，並由廠商授權。您可以使用網站授權工作流程 。這是從您自己的網站啟動OAuth的授權工作流程。

• 賣方或廠商的私有應用程式 – 這些應用程式僅供您的組織使用。這些可能是賣方或廠商應用程式。您可以使用自我授權方法。當您為自己的組織建立私有應用程式時，您可以自行授權該應用程式存取您的帳戶資訊。您可以自行授權處於草稿狀態的應用程式；沒有理由發佈私有應用程式。如需從賣方和供應商應用程式撤銷自我授權的資訊，請參閱 SP 文件API中的撤銷自我授權。

授權應用程式存取的供應商群組

當您授權銷售合作夥伴API應用程式存取您的資料時，您會授予與 Vendor Central 帳戶登入憑證相關聯的廠商群組存取權。透過延伸，您將授予對廠商群組中存在之所有廠商代碼的存取權。因此，請務必使用正確的廠商中央憑證和廠商群組進行銷售合作夥伴API整合。

供應商群組是您登入的帳戶。根據您的商業協議、操作模型和其他因素，您的廠商群組可以包含一或多個廠商代碼。每個廠商程式碼都可讓您列出特定類別的產品，或包含必要的業務協議，例如特定品牌的一個廠商程式碼。

您可以為每個廠商群組擁有多個授權，也可以建立包含所有廠商代碼的單一廠商群組。使用與您設定檔相關聯的多個廠商群組的選項可讓您在不同廠商群組中使用具有相同廠商代碼的應用程式。使用此選項，您不需要為每個廠商群組提交多個廠商開發人員應用程式。

如需詳細資訊，請參閱 SP 文件API中的授權應用程式存取的廠商群組。

連線至 SP-API

註冊並授權應用程式後，您可以開始提出請求。如需詳細資訊，請參閱 SP 文件API中的連線至銷售合作夥伴API。