取得套件發行小眾測試版提交
在 Microsoft Store 提交 API 中使用此方法，取得現有套件發行小眾測試版提交的資料。 如需使用 Microsoft Store 提交 API 建立套件發行小眾測試版提交程序的詳細資訊，請參閱 管理套件發行小眾測試版提交。
必要條件
要使用此方法，您需要先執行以下操作：
- 如果您尚未執行此操作，請完成 Microsoft Store 提交 API 的所有必要條件 。
- 取得 Azure AD 存取權杖以便在此方法的要求標頭中使用 。 取得存取權杖之後，您在其到期之前有 60 分鐘的時間可以使用。 權杖到期之後，您可以取得新的權杖。
- 在合作夥伴中心建立應用程式的套件發行小眾測試版提交。 您可以在合作夥伴中心執行此動作，或使用建立套件發行小眾測試版提交方法來執行此動作。
Request
此方法具有下列語法。 如需標頭和要求本文的使用範例和描述，請參閱下列各節。
| 方法 | 要求 URI |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions{submissionId} |
要求標頭
| 標題 | 類型 | 描述 |
|---|---|---|
| 授權 | 字串 | 必要。 持有人<權杖>形式的 Azure AD 存取權杖。 |
要求參數
| 名稱 | 類型 | 描述 |
|---|---|---|
| applicationId | 字串 | 必要。 包含您想要取得的套件發行小眾測試版提交之應用程式 Store ID。 如需 Store ID 的詳細資訊，請參閱檢視應用程式識別詳細資料。 |
| flightId | 字串 | 必要。 包含您想要取得的提交之套件發行小眾測試版識別碼。 此識別碼可在要求建立套件發行小眾測試版要求的回應資料中取得，並取得應用程式的套件發行小眾測試版。 針對在合作夥伴中心建立的發行小眾測試版，此識別碼也可以在合作夥伴中心發行小眾測試版頁面的 URL 中取得。 |
| submissionId | 字串 | 必要。 要取得之提交的識別碼。 此識別碼可在要求建立套件小眾測試版提交的回應資料中取得。 針對在合作夥伴中心建立的提交，此識別碼也可以在合作夥伴中心提交頁面的 URL 中取得。 |
要求本文
請勿提供此方法的要求本文。
要求範例
下列範例示範如何為具有 Store ID 9WZDNCRD91MD 的應用程式取得套件發行小眾測試版提交。
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649 HTTP/1.1
Authorization: Bearer <your access token>
回應
下面的範例示範成功呼叫此方法的 JSON 回應本文。 回應本文包含指定提交的相關資訊。 如需關於回應本文中的值的詳細資訊，請參閱套件發行小眾測試版提交資源。
{
"id": "1152921504621243649",
"flightId": "cd2e368a-0da5-4026-9f34-0e7934bc6f23",
"status": "PendingCommit",
"statusDetails": {
"errors": [],
"warnings": [],
"certificationReports": []
},
"flightPackages": [
{
"fileName": "newPackage.appx",
"fileStatus": "PendingUpload",
"id": "",
"version": "1.0.0.0",
"languages": ["en-us"],
"capabilities": [],
"minimumDirectXVersion": "None",
"minimumSystemRam": "None"
}
],
"packageDeliveryOptions": {
"packageRollout": {
"isPackageRollout": false,
"packageRolloutPercentage": 0.0,
"packageRolloutStatus": "PackageRolloutNotStarted",
"fallbackSubmissionId": "0"
},
"isMandatoryUpdate": false,
"mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
},
"fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/8b389577-5d5e-4cbe-a744-1ff2e97a9eb8?sv=2014-02-14&sr=b&sig=wgMCQPjPDkuuxNLkeG35rfHaMToebCxBNMPw7WABdXU%3D&se=2016-06-17T21:29:44Z&sp=rwl",
"targetPublishMode": "Immediate",
"targetPublishDate": "",
"notesForCertification": "No special steps are required for certification of this app."
}
錯誤碼
如果要求無法成功完成，回應將會包含下列其中一個 HTTP 錯誤碼。
| 錯誤碼 | 描述 |
|---|---|
| 404 | 找不到套件發行小眾測試版提交。 |
| 409 | 套件發行小眾測試版提交不屬於指定的套件發行小眾測試版，或應用程式使用 Microsoft Store 提交 API 目前不支援的合作夥伴中心功能。 |