Получение сведений о выпуске для отправки приложения
Используйте этот метод в API отправки в Microsoft Store для получения сведений о выпуске пакета в составе отправки тестового пакета. Подробнее о процессе создания отправки приложения с помощью API отправки в Microsoft Store см. в статье Управление отправками приложений.
Предварительные требования
Для использования этого метода сначала необходимо сделать следующее:
- Если вы еще не сделали этого, выполните все необходимые условия для API отправки в Microsoft Store.
- Получите маркер доступа Azure AD, который будет использоваться в заголовке запроса этого метода. После получения маркера доступа у вас будет 60 минут, чтобы использовать его до истечения срока действия. После истечения срока действия маркера можно получить новый маркер.
- Создайте отправку для одного из ваших приложений. Это можно сделать в Центре партнеров или с помощью метода создания отправки приложения .
Запрос
У этого метода следующий синтаксис. Примеры использования и описание заголовка и параметров запроса приведены в следующих разделах.
Метод | Универсальный код ресурса (URI) запроса |
---|---|
GET | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/packagerollout |
Заголовок запроса
Заголовок | Тип | Описание |
---|---|---|
Авторизация | строка | Обязательный. Маркер доступа Azure AD в видемаркера>носителя<. |
Параметры запроса
Имя | Тип | Описание |
---|---|---|
applicationId | строка | Обязательный. Код продукта в Магазине для приложения, содержащего отправку с информацией о выпуске пакета, которую требуется получить. Дополнительные сведения о коде продукта в Магазине см. в разделе Просмотр сведений об идентификации приложения. |
submissionId | строка | Обязательный. Идентификатор отправки с информацией о выпуске пакета, которую требуется получить. Этот идентификатор добавляется в данные ответов для запросов на создание отправки приложения. Для отправки, созданной в Центре партнеров, этот идентификатор также доступен в URL-адресе страницы отправки в Центре партнеров. |
Текст запроса
Предоставлять текст запроса для этого метода не требуется.
Пример запроса
Следующий пример демонстрирует получение сведений о выпуске пакета для отправки приложения.
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621243649/packagerollout HTTP/1.1
Authorization: Bearer <your access token>
Ответ
В следующем примере показано тело ответа JSON, позволяющего успешно выполнить вызов этого метода для отправки приложения с поддержкой постепенного выпуска пакета. Подробнее о значениях в тексте ответа см. в описании ресурса "Выпуск пакета".
{
"isPackageRollout": true,
"packageRolloutPercentage": 25.0,
"packageRolloutStatus": "PackageRolloutInProgress",
"fallbackSubmissionId": "1212922684621243058"
}
Если отправка приложения не поддерживает постепенный выпуск пакета, возвращается следующее тело ответа.
{
"isPackageRollout": false,
"packageRolloutPercentage": 0.0,
"packageRolloutStatus": "PackageRolloutNotStarted",
"fallbackSubmissionId": "0"
}
Коды ошибок
Если запрос не удается выполнить, ответ будет содержать один из следующих кодов ошибок HTTP.
Код ошибки | Описание |
---|---|
404 | Не удалось найти отправку. |
409 | Отправка не принадлежит указанному приложению или использует функцию Центра партнеров, которая в настоящее время не поддерживается API отправки Microsoft Store. |
Связанные темы
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по