Создание тестового пакетаCreate a package flight

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

Примечание

При использовании этого метода выполняется создание тестового пакета без отправок.This method creates a package flight without any submissions. Руководство по созданию отправки для тестового пакета см. в описании методов в разделе Управление отправками тестовых пакетов.To create a submission for package flight, see the methods in Manage package flight submissions.

Предварительные требования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
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights

Заголовок запроса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 for which you want to create a package flight. Дополнительные сведения о коде продукта в Магазине см. в разделе Просмотр сведений об идентификации приложения.For more information about the Store ID, see View app identity details.

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

Текст запроса содержит следующие параметры.The request body has the following parameters.

ПараметрParameter ТипType ОписаниеDescription ОбязательноRequired
friendlyNamefriendlyName строкаstring Имя тестового пакета, указанное разработчиком.The name of the package flight, as specified by the developer. НетNo
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. НетNo
rankHigherThanrankHigherThan строкаstring Понятное имя тестового пакета, приоритет которого на единицу ниже приоритета текущего тестового пакета.The friendly name of the package flight that is ranked immediately lower than the current package flight. Если не настроить этот параметр, новый тестовый пакет будет иметь самый высокий приоритет среди всех тестовых пакетов.If you do not set this parameter, the new package flight will have the highest rank of all package flights. Дополнительные сведения о задании приоритетов тестовых групп см. в разделе Тестовые пакеты.For more information about ranking flight groups, see Package flights. НетNo

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

В примере кода ниже показано, как создать новый тестовый пакет приложения с кодом продукта 9WZDNCRD911W в Магазине.The following example demonstrates how to create a new package flight for an app that has the Store ID 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 в случае успешного вызова этого метода.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",
  "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 in the request.
groupIdsgroupIds массивеarray Массив строк, содержащий идентификаторы тестовых групп, которые связаны с тестовым пакетом, как указано в запросе.An array of strings that contain the IDs of the flight groups that are associated with the package flight, as specified in the request. Дополнительные сведения о тестовых группах см. в разделе Тестовые пакеты.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, as specified in the request. Дополнительные сведения о задании приоритетов тестовых групп см. в разделе Тестовые пакеты.For more information about ranking flight groups, see Package flights.

Коды ошибок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.
409409 Не удалось создать рейс пакета из-за его текущего состояния, или приложение использует функцию центра партнеров, которая в настоящее время не поддерживается API отправки Microsoft Store.The package flight could not be created because of its current state, or the app uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.