取得套件正式發行前小眾測試版提交Get a package flight submission

在 Microsoft Store 提交 API 中使用這個方法,取得現有套件正式發行前小眾測試版提交的資料。Use this method in the Microsoft Store submission API to get data for an existing package flight submission. 如需使用 Microsoft Store 提交 API 建立套件正式發行前小眾測試版提交程序的詳細資訊,請參閱管理套件正式發行前小眾測試版提交For more information about the process of process of creating a package flight submission by using the Microsoft Store submission API, see Manage package flight submissions.

先決條件Prerequisites

若要使用這個方法,您必須先進行下列動作:To use this method, you need to first do the following:

  • 如果您尚未完成,請先完成 Microsoft Store 提交 API 的所有先決條件If you have not done so already, complete all the prerequisites for the Microsoft Store submission API.
  • 取得 Azure AD 存取權杖以便用於這個方法的要求標頭。Obtain an Azure AD access token to use in the request header for this method. 在您取得存取權杖之後,您有 60 分鐘的使用時間,之後其便會到期。After you obtain an access token, you have 60 minutes to use it before it expires. 權杖到期之後,您可以取得新的權杖。After the token expires, you can obtain a new one.
  • 在合作夥伴中心中建立應用程式的套件航班提交。Create a package flight submission for an app in Partner Center. 您可以在合作夥伴中心中進行這項作業,也可以使用 建立封裝航班提交 方法來達到此目的。You can do this in Partner Center, or you can do this by using the create a package flight submission method.

要求Request

這個方法的語法如下。This method has the following syntax. 請參閱下列各小節了解標頭和要求主體的使用範例和描述。See the following sections for usage examples and descriptions of the header and request body.

方法Method 要求 URIRequest URI
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions{submissionId}

要求標頭Request header

標頭Header 類型Type 描述Description
授權Authorization 字串string 必要。Required. Azure AD 存取權杖,形式為 Bearer <token>。The Azure AD access token in the form Bearer <token>.

要求參數Request parameters

名稱Name 類型Type 說明Description
applicationIdapplicationId 字串string 必要。Required. 包含您想要取得套件正式發行前小眾測試版提交之 App 的 Store 識別碼。The Store ID of the app that contains the package flight submission you want to get. 如需有關 Store 識別碼的詳細資訊,請參閱檢視 App 身分識別詳細資料For more information about the Store ID, see View app identity details.
flightIdflightId 字串string 必要。Required. 包含您要取得提交之套件正式發行前小眾測試版的識別碼。The ID of the package flight that contains the submission you want to get. 識別碼可從建立套件正式發行前小眾測試版取得 App 套件正式發行前小眾測試版要求的回應資料中取得。This ID is available in the response data for requests to create a package flight and get package flights for an app. 針對在合作夥伴中心中建立的航班,此識別碼也可在合作夥伴中心中航班頁面的 URL 中取得。For a flight that was created in Partner Center, this ID is also available in the URL for the flight page in Partner Center.
submissionIdsubmissionId 字串string 必要。Required. 要取得之提交的識別碼。The ID of the submission to get. 建立套件正式發行前小眾測試版提交要求的回應資料中有提供此識別碼。This ID is available in the response data for requests to create a package flight submission. 針對合作夥伴中心中建立的提交,此識別碼也可在 [提交] 頁面的 URL 中找到合作夥伴中心。For a submission that was created in Partner Center, this ID is also available in the URL for the submission page in Partner Center.

Request bodyRequest body

不提供此方法的要求主體。Do not provide a request body for this method.

要求範例Request example

下列範例示範如何為 Store 識別碼為 9WZDNCRD91MD 的 App 取得套件正式發行前小眾測試版提交。The following example demonstrates how to get a package flight submission for an app that has the Store ID 9WZDNCRD91MD.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649 HTTP/1.1
Authorization: Bearer <your access token>

回應Response

下列範例示範成功呼叫這個方法的 JSON 回應本文。The following example demonstrates the JSON response body for a successful call to this method. 回應本文包含指定提交的相關資訊。The response body contains information about the specified submission. 如需回應本文中各個值的詳細資訊,請參閱套件正式發行前小眾測試版提交資源For more details about the values in the response body, see Package flight submission resource.

{
  "id": "1152921504621243649",
  "flightId": "cd2e368a-0da5-4026-9f34-0e7934bc6f23",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
  "flightPackages": [
    {
      "fileName": "newPackage.appx",
      "fileStatus": "PendingUpload",
      "id": "",
      "version": "1.0.0.0",
      "languages": ["en-us"],
      "capabilities": [],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/8b389577-5d5e-4cbe-a744-1ff2e97a9eb8?sv=2014-02-14&sr=b&sig=wgMCQPjPDkuuxNLkeG35rfHaMToebCxBNMPw7WABdXU%3D&se=2016-06-17T21:29:44Z&sp=rwl",
  "targetPublishMode": "Immediate",
  "targetPublishDate": "",
  "notesForCertification": "No special steps are required for certification of this app."
}

錯誤碼Error codes

如果要求無法順利完成,則回應會包含下列其中一個 HTTP 錯誤碼。If the request cannot be successfully completed, the response will contain one of the following HTTP error codes.

錯誤碼Error code 描述Description
404404 找不到套件正式發行前小眾測試版。The package flight submission could not be found.
409409 封裝航班提交不屬於指定的封裝航班,或應用程式使用 Microsoft Store 提交 API 目前不支援的合作夥伴中心功能。The package flight submission does not belong to the specified package flight, or the app uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.