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

Получение сведений о выпуске для отправки тестируемой возможности

  • Статья

Используйте этот метод в API отправки Microsoft Store, чтобы получить сведения о выпуске пакета для отправки тестового пакета. Дополнительные сведения о процессе создания отправки тестового пакета с помощью API отправки пакета в Microsoft Store см. в статье "Управление отправкой тестового пакета".

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

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

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

Запросить

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

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

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

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

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

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

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

Не предоставляйте текст запроса для этого метода.

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

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

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649/packagerollout HTTP/1.1
Authorization: Bearer <your access token>

Response

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

{
    "isPackageRollout": true,
    "packageRolloutPercentage": 25.0,
    "packageRolloutStatus": "PackageRolloutInProgress",
    "fallbackSubmissionId": "1212922684621243058"
}

Если отправка тестового пакета не включает постепенное развертывание пакета, будет возвращен следующий текст ответа.

{
    "isPackageRollout": false,
    "packageRolloutPercentage": 0.0,
    "packageRolloutStatus": "PackageRolloutNotStarted",
    "fallbackSubmissionId": "0"
}

Коды ошибок

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

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