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

  • Статья

Используйте этот метод в 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 строка Имя тестового пакета, указанное разработчиком. Нет
groupIds array Массив строк, содержащий идентификаторы тестовых групп, которые связаны с тестовым пакетом. Дополнительные сведения о тестовых группах см. в разделе Тестовые пакеты. Нет
rankHigherThan строка Понятное имя тестового пакета, приоритет которого на единицу ниже приоритета текущего тестового пакета. Если не настроить этот параметр, новый тестовый пакет будет иметь самый высокий приоритет среди всех тестовых пакетов. Дополнительные сведения о задании приоритетов тестовых групп см. в разделе Тестовые пакеты. Нет

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

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

Ответ

В следующем примере представлено тело ответа 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.