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

Фиксация отправки приложения

  • Статья

Используйте этот метод в API отправки Microsoft Store для фиксации новой или обновленной отправки приложения в Центр партнеров. Действие фиксации предупреждает Центр партнеров о том, что данные отправки были отправлены (включая все связанные пакеты и изображения). В ответ Центр партнеров фиксирует изменения данных отправки для приема и публикации. После успешной операции фиксации изменения отправки отображаются в Центре партнеров.

Дополнительные сведения о том, как операция фиксации вписывается в процесс отправки приложения с помощью API отправки в Microsoft Store, см. в разделе "Управление отправкой приложений".

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

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

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

Запросить

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

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

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

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

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

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

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

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

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

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

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

Response

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

{
  "status": "CommitStarted"
}

Текст ответа

Значение Тип Описание
статус строка Состояние отправки. Это может быть одно из следующих значений:
  • нет
  • Отмененные
  • ОжиданиеCommit
  • CommitStarted
  • CommitFailed
  • Ожидание публикации
  • Публикация
  • Опубликованные
  • PublishFailed
  • Предварительная обработка
  • PreProcessingFailed
  • Сертификация
  • CertificationFailed
  • Выпуск
  • ReleaseFailed

Коды ошибок

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

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