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