更新應用程式提交
在 Microsoft Store 提交 API 中使用此方法,更新現有的應用程式提交。 使用此方法成功更新提交之後,您必須 認可提交 以進行擷取和發佈。
如需有關如何使用 Microsoft Store 提交 API 將此方法融入建立應用程式提交程序的詳細資訊,請參閱管理應用程式提交。
必要條件
要使用此方法,您需要先執行以下操作:
- 如果您尚未執行此操作,請完成 Microsoft Store 提交 API 的所有必要條件 。
- 取得 Azure AD 存取權杖以便在此方法的要求標頭中使用 。 取得存取權杖之後,您在其到期之前有 60 分鐘的時間可以使用。 權杖到期之後,您可以取得新的權杖。
- 為其中一個應用程式建立提交。 您可以在合作夥伴中心執行此動作,或使用建立應用程式提交方法來執行此動作。
Request
此方法具有下列語法。 如需標頭和要求本文的使用範例和描述,請參閱下列各節。
方法 | 要求 URI |
---|---|
PUT | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId} |
要求標頭
標題 | 類型 | 描述 |
---|---|---|
授權 | 字串 | 必要。 持有人<權杖>形式的 Azure AD 存取權杖。 |
要求參數
名稱 | 類型 | 描述 |
---|---|---|
applicationId | 字串 | 必要。 您要為其更新提交之應用程式的 Store ID。 如需 Store 識別碼的詳細資訊,請參閱檢視應用程式識別詳細資料。 |
submissionId | 字串 | 必要。 提交的識別碼更新。 此識別碼可在要求建立應用程式提交的回應資料中取得。 針對在合作夥伴中心建立的提交,此識別碼也可以在合作夥伴中心提交頁面的 URL 中取得。 |
要求本文
要求本文具有下列參數。
值 | 類型 | 描述 |
---|---|---|
applicationCategory | 字串 | 為您的應用程式指定類別和/或子類別的字串 。 類別和子類別會用底線「_」字元結合成單一字串,例如:BooksAndReference_EReader。 |
價格 | object | 包含應用程式定價資訊的物件。 如需詳細資訊,請參閱定價資源一節。 |
可視性 | 字串 | 應用程式的可見度。 這可以是下列其中一值:
|
targetPublishMode | 字串 | 提交的發佈模式。 這可以是下列其中一值:
|
targetPublishDate | 字串 | 如果 targetPublishMode 設定為 SpecificDate,則會以 ISO 8601 格式顯示提交的發行日期。 |
listings | object | 索引鍵和值組的字典,其中每個索引鍵都是國家代碼,每個值都是 清單資源 物件,包含應用程式的清單資訊。 |
hardwarePreferences | 陣列 | 為應用程式定義硬體偏好設定的字串陣列。 這可以是下列其中一值:
|
automaticBackupEnabled | boolean | 指出 Windows 是否可以在自動備份至 OneDrive 時納入您應用程式的資料。 如需詳細資訊,請參閱應用程式宣告。 |
canInstallOnRemovableMedia | boolean | 指出客戶是否可以把您的應用程式安裝到卸除式儲存裝置。 如需詳細資訊,請參閱應用程式宣告。 |
isGameDvrEnabled | boolean | 指示是否為應用程式啟用了遊戲 DVR。 |
gamingOptions | object | 包含一個 遊戲選項資源的陣列 ,可為應用程式定義遊戲相關設定。 |
hasExternalInAppProducts | boolean | 指出您的應用程式是否允許使用者在 Microsoft Store 商務系統外購買。 如需詳細資訊,請參閱應用程式宣告。 |
meetAccessibilityGuidelines | boolean | 指出您的應用程式是否已經過測試,符合協助工具指南。 如需詳細資訊,請參閱應用程式宣告。 |
notesForCertification | 字串 | 包含您應用程式的認證注意事項。 |
applicationPackages | 陣列 | 包含為提交中每個套件提供詳細資料的物件。 如需詳細資訊,請參閱應用程式套件一節。 呼叫此方法以更新應用程式提交時,要求本文中只需要 這些物件的 fileName、 fileStatus、 minimumDirectXVersion 和 minimumSystemRam 值。 合作夥伴中心會填入其他值。 |
packageDeliveryOptions | object | 包含提交的漸進式套件推出模式和強制更新設定。 如需詳細資訊,請參閱 封裝傳遞選項物件。 |
enterpriseLicensing | 字串 | 其中一個企業授權值 指出應用程式的企業授權行為。 |
allowMicrosftDecideAppAvailabilityToFutureDeviceFamilies | boolean | 指出是否允許 Microsoft 把應用程式提供給未來的 Windows 10 和 Windows 11 裝置系列使用。 |
allowTargetFutureDeviceFamilies | boolean | 指出您的應用程式是否允許以未來的 Windows 10 和 Windows 11 裝置系列為目標。 |
預告片 | 陣列 | 一個包含預告片資源的陣列,代表應用程式清單的影片預告片。 |
要求範例
下列範例示範如何更新應用程式提交。
PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621230023 HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
"applicationCategory": "BooksAndReference_EReader",
"pricing": {
"trialPeriod": "FifteenDays",
"marketSpecificPricings": {},
"sales": [],
"priceId": "Tier2"
},
"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": "",
"applicationPackages": [
{
"fileName": "contoso_app.appx",
"fileStatus": "PendingUpload",
"minimumDirectXVersion": "None",
"minimumSystemRam": "None"
}
],
"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
},
"trailers": []
}
回應
下面的範例示範成功呼叫此方法的 JSON 回應本文。 回應本文包含已更新提交的相關資訊。 如需回應本文中關於值的詳細資訊,請參閱應用程式提交資源。
{
"id": "1152921504621243540",
"applicationCategory": "BooksAndReference_EReader",
"pricing": {
"trialPeriod": "FifteenDays",
"marketSpecificPricings": {},
"sales": [],
"priceId": "Tier2"
},
"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": "PendingUpload",
"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 錯誤碼。
錯誤碼 | 描述 |
---|---|
400 | 無法更新提交,因為要求無效。 |
409 | 無法更新提交,因為應用程式的目前狀態,或應用程式使用 Microsoft Store 提交 API 目前不支援的合作夥伴中心功能。 |