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

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

  • Статья

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

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

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

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

Запросить

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

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

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

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

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

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

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

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

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

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

GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621243680/status HTTP/1.1
Authorization: Bearer <your access token>

Response

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

{
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
}

Текст ответа

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

Коды ошибок

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

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