共用方式為

取得插件提交的狀態

在 Microsoft Store 提交 API 中使用此方法來取得附加元件（也稱為應用程式內產品或 IAP）提交的狀態。 如需了解有關使用 Microsoft Store 提交 API 來建立附加元件提交的更多資訊，請參閱 管理附加元件提交。

先決條件

若要使用此方法，您必須先執行下列動作：

  • 如果您尚未這麼做，請完成 Microsoft Store 提交 API 的所有 必要條件。
  • 取得 Azure AD 存取權杖以便用於此方法的要求標頭中。 取得存取令牌之後，您必須在 60 分鐘内使用它，否則將會失效。 令牌到期之後，您可以取得新的令牌。
  • 為其中一個應用程式提交一個附加元件。 您可以在合作夥伴中心執行此動作，或使用 建立附加元件提交 方法來執行此動作。

請求

此方法具有下列語法。 如需了解標頭和請求正文的使用範例和描述，請參閱下列各節。

方法 請求網址識別碼 (URI)
獲取 https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId}/status

請求標頭

頁首 類型 說明
授權 字符串 必須的。 Azure AD 存取令牌的形式為 Bearer<token>。

要求參數

名稱 類型 說明
應用程式內產品ID 字符串 必須的。 包含您要取得狀態之提交的附加元件市集標識碼。 合作夥伴中心中可找到商店 ID。
提交編號 (submissionId) 字符串 必須的。 您要查詢狀態的提交識別碼。 此識別碼在對 發出建立附件提交的請求時，可以在回應資料中取得。 針對在合作夥伴中心建立的提交，此識別碼也會顯示在合作夥伴中心提交頁面的 URL 中。

請求主體

不要為此方法提供請求主體。

範例請求

下列範例示範如何取得附加元件上傳的狀態。

GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621243680/status HTTP/1.1
Authorization: Bearer <your access token>

回應

下列範例示範成功呼叫此方法的 JSON 回應主體。 回應本體包含指定提交的相關資訊。 如需有關回應內容中數值的詳細資訊，請參閱下列各節。

{
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
}

回應主體

價值觀 類型 說明
地位 字符串 提交文件的狀態。 這可以是下列其中一個值：
  • 沒有
  • 已取消
  • PendingCommit（待定提交）
  • 提交已開始
  • 提交失敗
  • 待發布
  • 出版
  • 發布
  • 發佈失敗
  • 預處理
  • 預處理失敗
  • 認證
  • 認證失敗
  • 釋放
  • 發佈失敗
狀態詳情 物體 包含提交狀態的其他詳情，包括有關任何錯誤的資訊。 如需詳細資訊，請參閱 狀態詳細資料資源。

錯誤碼

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

錯誤碼 說明
404 找不到提交的資料。
409 附加元件會使用合作夥伴中心的 功能，而這些功能目前不受 Microsoft 市集提交 API的支援。
  • Last updated on