Получение тестового пакета

  • Статья

Используйте этот метод в API отправки Microsoft Store, чтобы получить данные для тестового пакета для приложения, зарегистрированного в вашей учетной записи Центра партнеров.

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

Для использования этого метода сначала необходимо сделать следующее:

  • Если вы еще не сделали этого, выполните все необходимые условия для API отправки в Microsoft Store.
  • Получите маркер доступа Azure AD, который будет использоваться в заголовке запроса этого метода. После получения маркера доступа у вас будет 60 минут, чтобы использовать его до истечения срока действия. После истечения срока действия маркера можно получить новый маркер.

Запрос

У этого метода следующий синтаксис. Примеры использования и описание текста заголовка и запроса приведены в следующих разделах.

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

Заголовок запроса

Заголовок Тип Описание
Авторизация строка Обязательный. Маркер доступа Azure AD в видемаркера>носителя<.

Параметры запроса

Имя Тип Описание
applicationId строка Обязательный. Код продукта для приложения, содержащего тестовый пакет, который требуется получить. Идентификатор магазина для приложения доступен в Центре партнеров.
flightId строка Обязательный. Идентификатор получаемого тестового пакета. Этот идентификатор добавляется в данные ответов для запросов на создание тестового пакета и получение тестовых пакетов для приложения. Для тестовой версии, созданной в Центре партнеров, этот идентификатор также доступен в URL-адресе тестовой страницы в Центре партнеров.

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

Предоставлять текст запроса для этого метода не требуется.

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

В следующем примере показано, как получить информацию о тестовом пакете с идентификатором 43e448df-97c9-4a43-a0bc-2a445e736bcd для приложения с кодом продукта в Магазине 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>

Ответ

В следующем примере представлено тело ответа JSON в случае успешного вызова этого метода. Дополнительные сведения о значениях, которые могут содержаться в теле ответа, см. в следующих разделах.

{
  "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"
}

Текст ответа

Значение Тип Описание
flightId строка Идентификатор для тестового пакета. Это значение предоставляется Центром партнеров.
friendlyName строка Имя тестового пакета, указанное разработчиком.
lastPublishedFlightSubmission object Объект, который предоставляет сведения о последней опубликованной отправке для тестового пакета. Дополнительные сведения см. ниже в разделе Объект отправки.
pendingFlightSubmission object Объект, который предоставляет сведения о текущей ожидающей отправке для тестового пакета. Дополнительные сведения см. ниже в разделе Объект отправки.
groupIds array Массив строк, содержащий идентификаторы тестовых групп, которые связаны с тестовым пакетом. Дополнительные сведения о тестовых группах см. в разделе Тестовые пакеты.
rankHigherThan строка Понятное имя тестового пакета, приоритет которого на единицу ниже приоритета текущего тестового пакета. Дополнительные сведения о задании приоритетов тестовых групп см. в разделе Тестовые пакеты.

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

Значения lastPublishedFlightSubmission и pendingFlightSubmission в теле ответа содержат объекты, предоставляющие сведения о ресурсе для отправки тестового пакета. Эти объекты имеют следующие значения.

Значение Тип Описание
идентификатор строка Идентификатор отправки.
resourceLocation строка Относительный путь, который можно добавить к базовому URI запроса https://manage.devcenter.microsoft.com/v1.0/my/, чтобы получить полные данные для отправки.

Коды ошибок

Если запрос не удается выполнить, ответ будет содержать один из следующих кодов ошибок HTTP.

Код ошибки Описание
400 Недопустимый запрос.
404 Не удалось найти указанный тестовый пакет.
409 Приложение использует функцию Центра партнеров, которая в настоящее время не поддерживается API отправки Microsoft Store.