AWS 合作夥伴中心 API 參考已重組。如需支援的 API 操作的詳細資訊，請參閱 [AWS 合作夥伴中心 API 參考](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用AWS Partner Central Benefits API
<a name="using-the-benefits-api"></a>

AWS Partner Central Benefits API 簡化了合作夥伴在所有AWS合作夥伴計劃中探索、申請和管理利益的方式。透過將利益管理集中到單一直覺式界面，該服務會建立透明的功績制，獎勵合作夥伴，同時簡化操作。

API 提供標準AWS API 功能。使用 API [動作](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_Operations.html)或使用專為您的程式設計語言或平台量身打造的AWS SDK 來存取它。如需詳細資訊，請參閱 [入門AWS](https://aws.amazon.com/getting-started)和[要建置的工具AWS](https://aws.amazon.com/developer/tools/)。

## 什麼是利益？
<a name="what-is-a-benefit"></a>

在AWS合作夥伴網路 (APN) 中，利益代表合作夥伴可以從中取得的優勢或功能，AWS以支援其業務成長和客戶成功。優勢旨在根據合作夥伴的資格和貢獻獎勵合作夥伴，同時提供實際價值，協助合作夥伴擴展其AWS實務。

優點可能有多種形式，包括：
+ **財務獎勵 **- 點數、現金支出和資金計劃，例如遷移加速計劃 (MAP) 或行銷開發資金 (MDF)
+ **存取優點** - 預覽對新服務、工具或專業資源的存取
+ **辨識** - 數位徽章、認證、能力指定和合作夥伴層狀態
+ **技術資源** - 解決方案架構協助、技術支援和 ProServe 參與
+ **行銷支援** - 聯合行銷機會、精選合作夥伴狀態和成功案例出版物

## 探索可用的優勢
<a name="discovering-available-benefits"></a>

合作夥伴透過探索他們可獲得哪些好處並了解資格要求，開始他們的利益之旅。Benefits API 透過 Benefit Discovery APIs提供全面的探索功能。

### 列出可用的優勢
<a name="listing-available-benefits"></a>

合作夥伴可以使用 `ListBenefits` API 動作檢視所有可用的利益。此動作會擷取具有選用篩選功能的優點目錄，以協助合作夥伴快速尋找相關機會。

為了有效地探索好處，合作夥伴可以依下列條件進行篩選：
+ **計劃** - 依特定AWS合作夥伴計劃篩選，例如 MAP （遷移加速計劃）、MDF （行銷開發資金）、ISV 工作負載遷移、創新沙盒、概念驗證或合作夥伴計畫資金
+ **履行類型** - 依優點的交付方式篩選：`CREDITS`、`CASH`、`DISCOUNT``ACCESS`、、 `RECOGNITION`或 `RESOURCE`
+ **狀態** - 依利益狀態篩選： `ACTIVE` 或 `DEPRECATED`

`ListBenefits` API 會傳回利益摘要，其中包含基本資訊，例如利益 ID、名稱、描述、相關聯的計劃和履行類型。此摘要檢視可讓合作夥伴快速掃描可用的利益，並識別與其業務目標最相關的利益。

**篩選方法範例：**

專注於財務獎勵的合作夥伴可能會依履行類型篩選`CASH`，`CREDITS`並查看資金機會。尋求技術啟用的合作夥伴可能會依履行類型篩選`ACCESS`，`RESOURCE`或尋找技術支援優勢和工具存取。

### 檢視詳細利益資訊
<a name="viewing-detailed-benefit-information"></a>

一旦合作夥伴識別感興趣的利益，他們就可以使用 `GetBenefit` API 動作擷取完整詳細資訊。這可提供完整的資訊，包括：
+ **資格條件** - 合作夥伴必須符合的詳細要求，才能獲得利益
+ **利益請求結構描述** - 申請時合作夥伴需要提供的特定資訊和文件
+ **授予詳細資訊** - 核准時會收到哪些合作夥伴
+ **關聯的計劃** - 利益支援的AWS合作夥伴計劃

利益請求結構描述特別重要，因為它定義利益應用程式的結構和必要欄位。合作夥伴應在建立利益應用程式之前仔細檢閱此結構描述，以確保他們預先收集所有必要資訊。

**重要**  
每個利益的資格判斷由用戶端或 UI layer 處理。對於與資金相關的利益，資格通常是以合作夥伴的計分卡效能和計劃參與為基礎。

**Topics**
+ [什麼是利益？](#what-is-a-benefit)
+ [探索可用的優勢](#discovering-available-benefits)
+ [使用利益應用程式](working-with-benefit-applications.md)
+ [使用利益分配](working-with-benefit-allocations.md)

**Topics**
+ [什麼是利益？](#what-is-a-benefit)
+ [探索可用的優勢](#discovering-available-benefits)
+ [使用利益應用程式](working-with-benefit-applications.md)
+ [使用利益分配](working-with-benefit-allocations.md)