使用 Microsoft 市集提交 API 中的這個方法，為註冊至合作夥伴中心帳戶的應用程式建立新的提交。 使用此方法成功建立新的提交之後，更新提交，以對提交數據進行任何必要的變更，然後 認可提交 以進行擷取和發佈。
如需瞭解此方法如何融入使用 Microsoft 市集提交 API 建立應用程式提交流程的詳細資訊，請參閱 管理應用程式提交。
先決條件
若要使用此方法，您必須先執行下列動作：
- 如果您尚未這麼做，請完成 Microsoft Store 提交 API 的所有 必要條件。
- 取得 Azure AD 存取權杖以便用於此方法的要求標頭中。 取得存取令牌之後，您必須在 60 分鐘内使用它，否則將會失效。 令牌到期之後，您可以取得新的令牌。
- 請確保應用程式至少有一個提交內容，且已經完成 年齡分級 資訊。
請求
此方法具有下列語法。 如需了解標頭和請求正文的使用範例和描述，請參閱下列各節。
| 方法 | 請求網址識別碼 (URI) |
|---|---|
| 郵件 | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions |
請求標頭
| 頁首 | 類型 | 說明 |
|---|---|---|
| 授權 | 字符串 | 必須的。 Azure AD 存取令牌的形式為 Bearer<token>。 |
要求參數
| 名稱 | 類型 | 說明 |
|---|---|---|
| 應用程式ID | 字符串 | 必須的。 您要建立提交的應用程式的商店 ID。 如需市集標識碼的詳細資訊，請參閱 檢視應用程式身分識別詳細數據。 |
請求主體
不要為此方法提供請求主體。
範例請求
下列範例示範如何為應用創建新的提交項目。
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions 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 錯誤碼。
| 錯誤碼 | 說明 |
|---|---|
| 400 | 無法建立提交項目，因為要求無效。 |
| 409 | 無法建立提交，因為應用程式的目前狀態，或應用程式使用合作夥伴中心功能，Microsoft市集提交 API 目前不支援。 |