取得應用程式的套件發行小眾測試版

  • 發行項

在 Microsoft Store 提交 API 中使用此方法，列出向合作夥伴中心帳戶註冊之應用程式的套件發行小眾測試版。 如需套件發行小眾測試版的詳細資訊，請參閱套件發行小眾測試版。

必要條件

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

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

要求

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

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

要求標頭

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

要求參數

名稱 類型​​ 描述 必要
applicationId 字串 您想要擷取套件發行小眾測試版之應用程式的 Store ID。 如需 Store ID 的詳細資訊，請參閱檢視應用程式識別詳細資料。 是
熱門 int 要求中要傳回的項目數 (也就是要傳回的套件發行小眾測試版數目)。 如果您的帳戶擁有的套件發行小眾測試版多於您在查詢中指定的值，回應本文會包含相對 URI 路徑，讓您附加至方法 URI 以要求下一頁資料。 否
skip int 傳回其餘項目之前，查詢中要略過的項目數。 使用此參數逐頁瀏覽資料集。 例如，top=10 和 skip=0 會擷取項目 1 到 10，top=10 和 skip=10 會擷取項目 11 到 20，依此類推。 否

要求本文

請勿提供此方法的要求本文。

要求範例

下列範例示範如何列出應用程式的所有套件發行小眾測試版。

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/listflights HTTP/1.1
Authorization: Bearer <your access token>

下列範例示範如何列出應用程式的第一個套件發行小眾測試版。

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/listflights?top=1 HTTP/1.1
Authorization: Bearer <your access token>

回應

下列範例示範針對具有三個套件發行小眾測試版之應用程式，成功要求第一個套件發行小眾測試版所傳回的 JSON 回應本文。 如需回應本文中的值的詳細資訊，請參閱下一節。

{
  "value": [
    {
      "flightId": "7bfc11d5-f710-47c5-8a98-e04bb5aad310",
      "friendlyName": "myflight",
      "lastPublishedFlightSubmission": {
        "id": "1152921504621086517",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621086517"
      },
      "pendingFlightSubmission": {
        "id": "1152921504621215786",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621215786"
      },
      "groupIds": [
        "1152921504606962205"
      ],
      "rankHigherThan": "Non-flighted submission"
    }
  ],
  "totalCount": 3
}

回應本文

值 類型 描述
@nextLink 字串 如果有額外的資料頁，此字串會包含相對路徑，讓您附加至基底 https://manage.devcenter.microsoft.com/v1.0/my/ 要求 URI，以要求下一頁的資料。 例如，如果初始要求本文的 top 參數設定為 2，但應用程式有 4 個套件發行小眾測試版，回應本文會包含 applications/{applicationid}/listflights/?skip=2&top=2 的 @nextLink 值，這表示您可以呼叫 https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationid}/listflights/?skip=2&top=2 來要求接下來的 2 個套件發行小眾測試版。
值 陣列 物件的陣列，提供指定應用程式套件發行小眾測試版的相關資訊。 如需每個物件中的資料的詳細資訊，請參閱發行小眾測試版資源。
totalCount int 查詢資料結果中的資料列總數 (也就是指定應用程式的套件發行小眾測試版總數)。

錯誤碼

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

錯誤碼 描述
404 找不到套件發行小眾測試版。
409 應用程式使用 Microsoft Store 提交 API 目前不支援的合作夥伴中心功能。