在 Microsoft Store 提交 API 中使用此方法，為註冊到合作夥伴中心帳戶的應用程式建立套件飛行。
備註
此方法會建立套件飛行，而不需要任何提交。 若要建立逐步套件發行的提交，請參閱 管理逐步套件發行提交中的方法。
先決條件
若要使用此方法，您必須先執行下列動作：
- 如果您尚未這麼做，請完成Microsoft市集提交 API 的所有 必要條件 。
- 取得 Azure AD 存取令牌 ，以用於此方法的要求標頭中。 取得存取令牌之後，您必須在 60 分鐘内使用它，否則將會失效。 令牌到期之後，您可以取得新的令牌。
請求
此方法具有下列語法。 如需了解標頭和請求正文的使用範例和描述，請參閱下列各節。
| 方法 | 請求網址識別碼 (URI) |
|---|---|
| 郵件 | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights |
請求標頭
| 頁首 | 類型 | 說明 |
|---|---|---|
| 授權 | 字符串 | 必須的。 持有人令牌<形式的> Azure AD 存取令牌。 |
要求參數
| 名稱 | 類型 | 說明 |
|---|---|---|
| 應用程式ID | 字符串 | 必須的。 您要為應用程式建立套件飛行的市集 ID。 如需市集標識碼的詳細資訊，請參閱 檢視應用程式身分識別詳細數據。 |
請求主體
要求主體具有下列參數。
| 參數 | 類型 | 說明 | 為必填項目 |
|---|---|---|---|
| 友善名稱 | 字符串 | 套件航班的名稱，如開發人員所指定。 | 否 |
| 群組ID | 陣列 | 包含與套件飛行相關聯的飛行群組ID的字串陣列。 如需有關航班群組的詳細資訊，請參閱 套件航班。 | 否 |
| rankHigherThan | 字符串 | 排名緊接在目前套件航班之下的套件航班的易記名稱。 如果您未設定此參數，新的套件測試版將擁有所有套件測試版的最高等級。 如需對飛行群組排名的詳細資訊，請參閱 套裝行程。 | 否 |
範例請求
下列範例示範如何為具有 Store ID 9WZDNCRD911W 的應用程式建立新的套件飛行。
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Content-Type: application/json
{
"friendlyName": "myflight",
"groupIds": [
0
],
"rankHigherThan": null
}
回應
下列範例示範成功呼叫此方法的 JSON 回應主體。 如需有關回應內容中數值的詳細資訊，請參閱下列各節。
{
"flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
"friendlyName": "myflight",
"groupIds": [
"0"
],
"rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}
回應主體
| 價值觀 | 類型 | 說明 |
|---|---|---|
| 航班編號 (flightId) | 字符串 | 包裝航班的識別碼。 此值是由合作夥伴中心提供。 |
| 友善名稱 | 字符串 | 包裹航班的名稱，如要求中所指定。 |
| 群組ID | 陣列 | 字串陣列，包含與套件航班相關聯的航班群組 ID，如要求中所指定。 如需有關航班群組的詳細資訊，請參閱 套件航班。 |
| rankHigherThan | 字符串 | 在請求中指定的緊接低於目前套件航班等級的套件航班的易記名稱。 如需對飛行群組排名的詳細資訊，請參閱 套裝行程。 |
錯誤碼
如果要求無法順利完成，回應將會包含下列其中一個 HTTP 錯誤碼。
| 錯誤碼 | 說明 |
|---|---|
| 400 | 要求無效。 |
| 409 | 無法建立套件飛行配置，因為其當前狀態，或者應用程式使用 當前 Microsoft 市集提交 API 不支援的合作夥伴中心功能。 |