Поделиться через

Создание тестового пакета

  • Статья

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

Примечание.

Этот метод создает тестовый пакет без отправки. Сведения о создании отправки для тестового пакета см. в статье "Управление отправкой тестового пакета".

Необходимые компоненты

Чтобы использовать этот метод, сначала необходимо выполнить следующие действия:

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

Запросить

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

Способ URI запроса
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights

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

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

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

Имя. Тип Описание
applicationId строка Обязательный. Идентификатор магазина приложения, для которого требуется создать тестовый пакет. Дополнительные сведения об идентификаторе Магазина см. в разделе "Просмотр сведений об удостоверении приложения".

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

Текст запроса имеет следующие параметры.

Параметр Тип Описание Обязательное поле
friendlyName строка Имя тестового пакета, указанное разработчиком. No
groupIds array Массив строк, содержащих идентификаторы групп полетов, связанных с полетом пакета. Дополнительные сведения о группах полетов см. в разделе "Пакеты полетов". No
rankHigherThan строка Понятное имя тестового пакета, которое ранжируется сразу же ниже текущего тестового пакета. Если этот параметр не задан, новый тестовый пакет будет иметь самый высокий рейтинг всех рейсов пакета. Дополнительные сведения о ранжировании групп полетов см. в разделе "Пакеты полетов". No

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

В следующем примере показано, как создать новый тест пакета для приложения с идентификатором Магазина 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
}

Response

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

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "groupIds": [
    "0"
  ],
  "rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}

Текст ответа

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

Коды ошибок

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

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