使用 Microsoft 市集提交 API 中的這個方法，提交新的或更新的附加元件（也稱為應用程式內產品或 IAP）至合作夥伴中心。 提交通知合作夥伴中心已上傳提交資料（包括任何相關圖示）。 作為回應，合作夥伴中心會將提交數據的變更提交以供納入和發佈。 提交操作成功之後，提交的變更將顯示於合作夥伴中心。
如需了解提交操作如何納入使用 Microsoft 市集提交 API 的附加元件提交過程的詳細資訊，請參閱 管理附加元件提交。
先決條件
若要使用此方法，您必須先執行下列動作：
- 如果您尚未這麼做，請完成 Microsoft Store 提交 API 的所有 必要條件。
- 取得 Azure AD 存取權杖以便用於此方法的要求標頭中。 取得存取令牌之後，您必須在 60 分鐘内使用它，否則將會失效。 令牌到期之後，您可以取得新的令牌。
- 建立附加元件提交，然後 使用提交數據的任何必要變更來更新提交。
請求
此方法具有下列語法。 如需了解標頭和請求正文的使用範例和描述，請參閱下列各節。
| 方法 | 請求網址識別碼 (URI) |
|---|---|
| 郵件 | https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId}/commit |
請求標頭
| 頁首 | 類型 | 說明 |
|---|---|---|
| 授權 | 字符串 | 必須的。 Azure AD 存取令牌的形式為 Bearer<token>。 |
要求參數
| 名稱 | 類型 | 說明 |
|---|---|---|
| 應用程式內產品ID | 字符串 | 必須的。 包含您要認可之提交的附加元件市集標識碼。 市集標識碼可在合作夥伴中心取得，且會包括在響應數據中，當請求 取得所有附加元件 和 建立附加元件時。 |
| 提交編號 (submissionId) | 字符串 | 必須的。 您要提交的提交標識碼。 此識別碼在對 發出建立附件提交的請求時，可以在回應資料中取得。 針對在合作夥伴中心建立的提交，此識別碼也會顯示在合作夥伴中心提交頁面的 URL 中。 |
請求主體
不要為此方法提供請求主體。
範例請求
下列範例示範如何送出附加程式。
POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621230023/commit HTTP/1.1
Authorization: Bearer <your access token>
回應
下列範例示範成功呼叫此方法的 JSON 回應主體。 如需有關回應內容中數值的詳細資訊，請參閱下列各節。
{
"status": "CommitStarted"
}
回應主體
| 價值觀 | 類型 | 說明 |
|---|---|---|
| 地位 | 字符串 | 提交文件的狀態。 這可以是下列其中一個值：
|
錯誤碼
如果要求無法順利完成，回應將會包含下列其中一個 HTTP 錯誤碼。
| 錯誤碼 | 說明 |
|---|---|
| 400 | 要求參數無效。 |
| 404 | 找不到指定的提交。 |
| 409 | 找到指定的提交，但無法在其目前狀態認可，或附加元件使用合作夥伴中心功能，Microsoft市集提交 API 目前不支援。 |