Share via

Завершение выпуска для отправки приложения

  • Статья

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

Предварительные требования

Для использования этого метода сначала необходимо сделать следующее:

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

Запрос

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

Метод Универсальный код ресурса (URI) запроса
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/finalizepackagerollout

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

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

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

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

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

Предоставлять текст запроса для этого метода не требуется.

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

Следующий пример демонстрирует завершение выпуска пакета для отправки тестового пакета.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621243680/finalizepackagerollout HTTP/1.1
Authorization: Bearer <your access token>

Ответ

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

{
    "isPackageRollout": true,
    "packageRolloutPercentage": 100.0,
    "packageRolloutStatus": "PackageRolloutComplete",
    "fallbackSubmissionId": "1212922684621243058"
}

Коды ошибок

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

Код ошибки Описание
404 Не удалось найти отправку.
409 Этот код указывает на одну из следующих ошибок.

  • Отправка не находится в допустимом состоянии для операции постепенного выпуска (перед вызовом этого метода отправка должна быть опубликована, и значение packageRolloutStatus должно быть равно PackageRolloutInProgress).
  • Отправка не относится к указанному приложению.
  • Приложение использует функцию Центра разработчиков, которая в настоящее время не поддерживается API отправки в Microsoft Store.