取得應用程式提交
在 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}/submissions/{submissionId} |
要求標頭
標題 | 類型 | 描述 |
---|---|---|
授權 | 字串 | 必要。 持有人<權杖>形式的 Azure AD 存取權杖。 |
要求參數
名稱 | 類型 | 描述 |
---|---|---|
applicationId | 字串 | 必要。 您想要取得提交之應用程式的 Store ID。 如需 Store ID 的詳細資訊,請參閱檢視應用程式識別詳細資料。 |
submissionId | 字串 | 必要。 要取得之提交的識別碼。 此識別碼可在要求建立應用程式提交的回應資料中取得。 針對在合作夥伴中心建立的提交,此識別碼也可以在合作夥伴中心提交頁面的 URL 中取得。 |
要求本文
請勿提供此方法的要求本文。
要求範例
下列範例示範如何取得應用程式提交。
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621243680 HTTP/1.1
Authorization: Bearer <your access token>
回應
下面的範例示範成功呼叫此方法的 JSON 回應本文。 回應本文包含指定提交的相關資訊。 如需回應本文中關於值的詳細資訊,請參閱應用程式提交資源。
{
"id": "1152921504621243540",
"applicationCategory": "BooksAndReference_EReader",
"pricing": {
"trialPeriod": "FifteenDays",
"marketSpecificPricings": {},
"sales": [],
"priceId": "Tier2",
"isAdvancedPricingModel": true
},
"visibility": "Public",
"targetPublishMode": "Manual",
"targetPublishDate": "1601-01-01T00:00:00Z",
"listings": {
"en-us": {
"baseListing": {
"copyrightAndTrademarkInfo": "",
"keywords": [
"epub"
],
"licenseTerms": "",
"privacyPolicy": "",
"supportContact": "",
"websiteUrl": "",
"description": "Description",
"features": [
"Free ebook reader"
],
"releaseNotes": "",
"images": [
{
"fileName": "contoso.png",
"fileStatus": "Uploaded",
"id": "1152921504672272757",
"imageType": "Screenshot"
}
],
"recommendedHardware": [],
"title": "Contoso ebook reader"
},
"platformOverrides": {
"Windows81": {
"description": "Ebook reader for Windows 8.1"
}
}
}
},
"hardwarePreferences": [
"Touch"
],
"automaticBackupEnabled": false,
"canInstallOnRemovableMedia": true,
"isGameDvrEnabled": false,
"gamingOptions": [],
"hasExternalInAppProducts": false,
"meetAccessibilityGuidelines": true,
"notesForCertification": "",
"status": "PendingCommit",
"statusDetails": {
"errors": [],
"warnings": [],
"certificationReports": []
},
"fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/387a9ea8-a412-43a9-8fb3-a38d03eb483d?sv=2014-02-14&sr=b&sig=sdd12JmoaT6BhvC%2BZUrwRweA%2Fkvj%2BEBCY09C2SZZowg%3D&se=2016-06-17T18:32:26Z&sp=rwl",
"applicationPackages": [
{
"fileName": "contoso_app.appx",
"fileStatus": "Uploaded",
"id": "1152921504620138797",
"version": "1.0.0.0",
"architecture": "ARM",
"languages": [
"en-US"
],
"capabilities": [
"ID_RESOLUTION_HD720P",
"ID_RESOLUTION_WVGA",
"ID_RESOLUTION_WXGA"
],
"minimumDirectXVersion": "None",
"minimumSystemRam": "None",
"targetDeviceFamilies": [
"Windows.Mobile min version 10.0.10240.0"
]
}
],
"packageDeliveryOptions": {
"packageRollout": {
"isPackageRollout": false,
"packageRolloutPercentage": 0.0,
"packageRolloutStatus": "PackageRolloutNotStarted",
"fallbackSubmissionId": "0"
},
"isMandatoryUpdate": false,
"mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
},
"enterpriseLicensing": "Online",
"allowMicrosoftDecideAppAvailabilityToFutureDeviceFamilies": true,
"allowTargetFutureDeviceFamilies": {
"Desktop": false,
"Mobile": true,
"Holographic": true,
"Xbox": false,
"Team": true
},
"friendlyName": "Submission 2",
"trailers": []
}
錯誤碼
如果要求無法成功完成,回應將會包含下列其中一個 HTTP 錯誤碼。
錯誤碼 | 描述 |
---|---|
404 | 找不到提交。 |
409 | 提交不屬於指定的應用程式,或應用程式使用 Microsoft Store 提交 API 目前不支援的合作夥伴中心功能。 |