建立套件發行小眾測試版

  • 發行項

在 Microsoft Store 提交 API 中使用此方法，為向合作夥伴中心帳戶註冊的應用程式建立套件發行小眾測試版。

注意

此方法會建立套件發行小眾測試版，而不含任何提交。 若要建立套件發行小眾測試版的提交，請參閱管理套件發行小眾測試版提交中的方法。

必要條件

要使用此方法，您需要先執行以下操作：

  • 如果您尚未執行此操作，請完成 Microsoft Store 提交 API 的所有必要條件。
  • 取得 Azure AD 存取權杖以便用於此方法的要求標頭中。 取得存取權杖之後，您在其到期之前有 60 分鐘的時間可以使用。 權杖到期之後，您可以取得新的權杖。

要求

此方法具有下列語法。 如需標頭和要求本文的使用範例和描述，請參閱下列各節。

方法 要求 URI
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights

要求標頭

標題 類型 描述
授權 字串 必要。 持有人<權杖>形式的 Azure AD 存取權杖。

要求參數

名稱 類型​​ 描述
applicationId 字串 必要。 您要為其建立套件發行小眾測試版之應用程式的 Store ID。 如需 Store ID 的詳細資訊，請參閱檢視應用程式識別詳細資料。

要求本文

要求本文具有下列參數。

參數 類型 描述 必要
friendlyName 字串 套件發行小眾測試版的名稱，如開發人員所指定。 否
groupIds 陣列 字串的陣列，其中包含與套件發行小眾測試版相關聯之發行小眾測試版群組的識別碼。 如需發行小眾測試版群組的詳細資訊，請參閱套件發行小眾測試版。 否
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 字串 套件發行小眾測試版的識別碼。 此值是由合作夥伴中心提供。
friendlyName 字串 套件發行小眾測試版的名稱，如要求中所指定。
groupIds 陣列 字串陣列，其中包含與套件發行小眾測試版相關聯之發行小眾測試版群組的識別碼，如要求中所指定。 如需發行小眾測試版群組的詳細資訊，請參閱套件發行小眾測試版。
rankHigherThan 字串 順位緊接於目前套件發行小眾測試版之後的套件發行小眾測試版易記名稱，如要求中所指定。 如需發行小眾測試版群組排名的詳細資訊，請參閱套件發行小眾測試版。

錯誤碼

如果要求無法成功完成，回應將會包含下列其中一個 HTTP 錯誤碼。

錯誤碼 描述
400 要求無效。
409 無法建立套件發行小眾測試版，因為其目前狀態，或應用程式使用 Microsoft Store 提交 API 目前不支援的合作夥伴中心功能。