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

Фиксация отправки надстройки

  • Статья

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

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

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

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

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

Запросить

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

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

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

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

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

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

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

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

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

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

POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621230023/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.