共用方式為


完成應用程式提交

在 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"
}

回應主體

價值觀 類型 說明
地位 字符串 提交文件的狀態。 這可以是下列其中一個值:
  • 沒有
  • 已取消
  • PendingCommit(待定提交)
  • 提交已開始
  • 提交失敗
  • 待發布
  • 出版
  • 發布
  • 發佈失敗
  • 預處理
  • 預處理失敗
  • 認證
  • 認證失敗
  • 釋放
  • 發佈失敗

錯誤碼

如果要求無法順利完成,回應將會包含下列其中一個 HTTP 錯誤碼。

錯誤碼 說明
400 要求參數無效。
404 找不到指定的提交。
409 找到指定的提交,但無法在目前的狀態下提交,或者該應用程式使用的功能是目前 Microsoft 市集提交 API 不支援的合作夥伴中心功能