請在 Microsoft Store 提交 API 中使用此方法,將新的或更新後的測試包提交至合作夥伴中心。 提交動作會通知合作夥伴中心已上傳提交資料(包括任何相關套件)。 作為回應,合作夥伴中心會將提交數據的變更提交以供納入和發佈。 提交操作成功之後,提交的變更將顯示於合作夥伴中心。
如需瞭解有關承諾操作如何融入使用 Microsoft 市集提交 API 建立套件飛行提交流程的更多資訊,請參閱 管理套件飛行提交。
先決條件
若要使用此方法,您必須先執行下列動作:
- 如果您尚未這麼做,請完成 Microsoft Store 提交 API 的所有 必要條件。
- 取得 Azure AD 存取權杖以便用於此方法的要求標頭中。 取得存取令牌之後,您必須在 60 分鐘内使用它,否則將會失效。 令牌到期之後,您可以取得新的令牌。
- 建立套件航班提交,然後 更新提交,對提交資料進行任何必要的變更。
請求
此方法具有下列語法。 如需了解標頭和請求正文的使用範例和描述,請參閱下列各節。
| 方法 | 請求網址識別碼 (URI) |
|---|---|
| 郵件 | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/commit |
請求標頭
| 頁首 | 類型 | 說明 |
|---|---|---|
| 授權 | 字符串 | 必須的。 Azure AD 存取令牌的形式為 Bearer<token>。 |
要求參數
| 名稱 | 類型 | 說明 |
|---|---|---|
| 應用程式ID | 字符串 | 必須的。 包含您想要認可的套件測試版提交之應用程式商店識別碼。 App 的市集標識碼可在合作夥伴中心取得。 |
| 航班編號 (flightId) | 字符串 | 必須的。 包含提交認可的套件航班的標識碼。 此識別碼會在您請求建立套件發行排程及取得應用程式發行排程的回應數據中提供。 針對在合作夥伴中心建立的航班,其識別碼也顯示在合作夥伴中心中航班頁面的 URL 中。 |
| 提交編號 (submissionId) | 字符串 | 必須的。 要提交的ID。 此標識碼可在對建立套件飛行提交的請求的回應數據中取得。 針對在合作夥伴中心建立的提交,此識別碼也會顯示在合作夥伴中心提交頁面的 URL 中。 |
請求主體
不要為此方法提供請求主體。
範例請求
下列範例展示如何提交套件發佈測試。
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649/commit HTTP/1.1
Authorization: Bearer <your access token>
回應
下列範例示範成功呼叫此方法的 JSON 回應主體。 如需有關回應內容中數值的詳細資訊,請參閱下列各節。
{
"status": "CommitStarted"
}
回應主體
| 價值觀 | 類型 | 說明 |
|---|---|---|
| 地位 | 字符串 | 提交文件的狀態。 這可以是下列其中一個值:
|
錯誤碼
如果要求無法順利完成,回應將會包含下列其中一個 HTTP 錯誤碼。
| 錯誤碼 | 說明 |
|---|---|
| 400 | 要求參數無效。 |
| 404 | 找不到指定的提交。 |
| 409 | 找到指定的提交,但無法在目前的狀態下提交,或者該應用程式使用的功能是目前 Microsoft 市集提交 API 不支援的合作夥伴中心功能。 |