Получение тестового пакетаGet a package flight

Используйте этот метод в API отправки Microsoft Store, чтобы получить данные для приложения, зарегистрированного в учетной записи центра партнеров.Use this method in the Microsoft Store submission API to get data for a package flight for an app that is registered to your Partner Center account.

Предварительные требованияPrerequisites

Для использования этого метода сначала необходимо сделать следующее:To use this method, you need to first do the following:

  • Если вы еще не сделали этого, выполните все необходимые условия для API отправки в Microsoft Store.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.

ЗапросRequest

У этого метода следующий синтаксис.This method has the following syntax. Примеры использования и описание текста заголовка и запроса приведены в следующих разделах.See the following sections for usage examples and descriptions of the header and request body.

МетодMethod Универсальный код ресурса (URI) запросаRequest URI
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}

Заголовок запроса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. Код продукта для приложения, содержащего тестовый пакет, который требуется получить.The Store ID of the app that contains the package flight you want to get. ИДЕНТИФИКАТОР магазина для приложения доступен в центре партнеров.The Store ID for the app is available in Partner Center.
flightIdflightId строкаstring Обязательный.Required. Идентификатор получаемого тестового пакета.The ID of the package flight to get. Этот идентификатор добавляется в данные ответов для запросов на создание тестового пакета и получение тестовых пакетов для приложения.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.

Текст запросаRequest body

Предоставлять текст запроса для этого метода не требуется.Do not provide a request body for this method.

Пример запросаRequest example

В следующем примере показано, как получить информацию о тестовом пакете с идентификатором 43e448df-97c9-4a43-a0bc-2a445e736bcd для приложения с кодом продукта в Магазине 9WZDNCRD91MD.The following example demonstrates how to retrieve information about a package flight with the ID 43e448df-97c9-4a43-a0bc-2a445e736bcd for an app with the Store ID value 9WZDNCRD91MD.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd 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. Дополнительные сведения о значениях, которые могут содержаться в теле ответа, см. в следующих разделах.For more details about the values in the response body, see the following sections.

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "lastPublishedFlightSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621086517"
  },
  "pendingFlightSubmission": {
    "id": "115292150462124364",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243647"
  },
  "groupIds": [
    "0"
  ],
  "rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}

Текст ответаResponse body

ЗначениеValue ТипType ОписаниеDescription
flightIdflightId строкаstring Идентификатор для тестового пакета.The ID for the package flight. Это значение предоставляется центром партнеров.This value is supplied by Partner Center.
friendlyNamefriendlyName строкаstring Имя тестового пакета, указанное разработчиком.The name of the package flight, as specified by the developer.
lastPublishedFlightSubmissionlastPublishedFlightSubmission объектobject Объект, который предоставляет сведения о последней опубликованной отправке для тестового пакета.An object that provides information about the last published submission for the package flight. Дополнительные сведения см. ниже в разделе Объект отправки.For more information, see the Submission object section below.
pendingFlightSubmissionpendingFlightSubmission объектobject Объект, который предоставляет сведения о текущей ожидающей отправке для тестового пакета.An object that provides information about the current pending submission for the package flight. Дополнительные сведения см. ниже в разделе Объект отправки.For more information, see the Submission object section below.
groupIdsgroupIds массивеarray Массив строк, содержащий идентификаторы тестовых групп, которые связаны с тестовым пакетом.An array of strings that contain the IDs of the flight groups that are associated with the package flight. Дополнительные сведения о тестовых группах см. в разделе Тестовые пакеты.For more information about flight groups, see Package flights.
rankHigherThanrankHigherThan строкаstring Понятное имя тестового пакета, приоритет которого на единицу ниже приоритета текущего тестового пакета.The friendly name of the package flight that is ranked immediately lower than the current package flight. Дополнительные сведения о задании приоритетов тестовых групп см. в разделе Тестовые пакеты.For more information about ranking flight groups, see Package flights.

Объект отправкиSubmission object

Значения lastPublishedFlightSubmission и pendingFlightSubmission в теле ответа содержат объекты, предоставляющие сведения о ресурсе для отправки тестового пакета.The lastPublishedFlightSubmission and pendingFlightSubmission values in the response body contain objects that provide resource information about a submission for the package flight. Эти объекты имеют следующие значения.These objects have the following values.

ЗначениеValue ТипType ОписаниеDescription
идентификаторid строкаstring Идентификатор отправки.The ID of the submission.
resourceLocationresourceLocation строкаstring Относительный путь, который можно добавить к базовому URI запроса https://manage.devcenter.microsoft.com/v1.0/my/, чтобы получить полные данные для отправки.A relative path that you can append to the base https://manage.devcenter.microsoft.com/v1.0/my/ request URI to retrieve the complete data for the submission.

Коды ошибокError codes

Если запрос не удается выполнить, ответ будет содержать один из следующих кодов ошибок HTTP.If the request cannot be successfully completed, the response will contain one of the following HTTP error codes.

Код ошибкиError code ОписаниеDescription
400400 Недопустимый запрос.The request is invalid.
404404 Не удалось найти указанный тестовый пакет.The specified package flight could not be found.
409409 Приложение использует функцию центра партнеров, которая в настоящее время не поддерживается API-интерфейсом отправки Microsoft Store.The app uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.