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

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

# 使用機會更新
<a name="working-with-opportunity-updates"></a>

## 更新機會
<a name="making-updates-to-opportunities"></a>

 合作夥伴可以使用 `UpdateOpportunity`動作來更新機會，其中包含管理哪些欄位已更新以及更新時間的特定規則：

1. 如果 `Lifecycle.ReviewStatus`是 `Submitted`或 ，則無法進行更新`In-Review`。

1. 在提交之前，合作夥伴可以進行更新，但除非叫用 `StartEngagementFromOpportunityTask`動作，否則AWS不會處理它們。

1. 當機會處於 `Submitted`或 `In-review` 狀態時，會封鎖所有更新。

1. 如果機會處於 `Action Required` 狀態，請AWS開啟選取欄位以進行更新。這些欄位包括：
   + `Customer.Account.Address.City`
   + `Customer.Account.Address.Country`
   + `Customer.Account.Address.PostalCode`
   + `Customer.Account.Address.StateOrRegion`
   + `Customer.Account.Address.StreetAddress`
   + `Customer.Account.WebsiteUrl`
   + `LifeCycle.TargetCloseDate`
   + `Project.ExpectedCustomerSpend.Amount`
   + `Project.ExpectedCustomerSpend.CurrencyCode`
   + `Project.ExpectedCustomerSpend.EstimationURL`
   + `Project.ExpectedCustomerSpend.Frequency`
   + `Project.ExpectedCustomerSpend.TargetCompany`
   + `Project.CustomerBusinessProblem`
   + `PartnerOpportunityIdentifier`

1. 在檢閱程序後 （即當 `Lifecycle.ReviewStatus` 設定為 時`Approved`)，無法更新下列欄位：
   + `Customer.Account.Address.Country`
   + `Customer.Account.Address.PostalCode`
   + `Customer.Account.Industry`
   + `Customer.Account.WebsiteUrl`
   + `Project.CustomerBusinessProblem`
   + `PartnerOpportunityIdentifier`
   + `Project.Title`

1. 對於所有其他欄位，可以使用 `UpdateOpportunity`動作進行更新。不過，根據特定計劃或機會類型的業務規則，可能會有其他限制。如需詳細資訊，請參閱欄位層級驗證。

1. 對於透過 UI 和 API 進行的所有更新，會產生*機會更新*事件。

## 從 接收有關機會AWS的更新
<a name="receiving-updates-from-aws"></a>

AWS通常會更新AWS機會，而且每次進行更新時都會產生*機會更新*事件。

**若要從 擷取最新更新AWS，合作夥伴需要叫用兩個不同的動作**

1. `GetOpportunity` 擷取合作夥伴機會的詳細資訊。

1. `GetAWSOpportunitySummary` 擷取AWS機會資料的即時摘要。

 的大多數定期更新AWS將透過 `GetAWSOpportunitySummary`回應提供。不過，AWS有時可能會直接更新合作夥伴機會中的屬性。

**使用來自 的更新AWS**

1. 叫用 `GetAWSOpportunitySummary`動作以擷取AWS機會的最新詳細資訊。

1. 如果需要在合作夥伴的機會中反映變更，請使用 `UpdateOpportunity`動作將相關資料複製到合作夥伴的機會。



 合作夥伴可以選擇將此程序自動化為直接更新機制，或實作手動檢閱程序來驗證和更新資料。