Получение состоянии отправки надстройкиGet the status of an add-on submission

Используйте этот метод в API отправки в Microsoft Store для получения сведения о состоянии отправки надстройки (также называется внутренним продуктом приложения или IAP).Use this method in the Microsoft Store submission API to get the status of an add-on (also known as in-app product or IAP) submission. Дополнительные сведения о процессе создания отправки надстройки с помощью API отправки в Microsoft Store см. в разделе Управление отправками надстроек.For more information about the process of process of creating an add-on submission by using the Microsoft Store submission API, see Manage add-on submissions.

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

Для использования этого метода сначала необходимо сделать следующее:To use this method, you need to first do the following:

  • Если вы еще не сделали этого, выполните все необходимые условия для API отправки в Microsoft Store.If you have not done so already, complete all the prerequisites for the Microsoft Store submission API.
  • Получите маркер доступа Azure AD, который будет использоваться в заголовке запроса этого метода.Obtain an Azure AD access token to use in the request header for this method. После получения токена доступа у вас будет 60 минут, чтобы использовать его до окончания его срока действия.After you obtain an access token, you have 60 minutes to use it before it expires. После истечения срока действия токена можно получить новый токен.After the token expires, you can obtain a new one.
  • Создайте надстройку адресация, одно из приложений.Create an add-on submission for one of your apps. Это можно сделать в центре партнеров, или это можно сделать с помощью создать надстройку отправки метод.You can do this in Partner Center, or you can do this by using the Create an add-on submission method.

ЗапросRequest

У этого метода следующий синтаксис.This method has the following syntax. Примеры использования и описание текста заголовка и запроса приведены в следующих разделах.See the following sections for usage examples and descriptions of the header and request body.

МетодMethod Универсальный код ресурса (URI) запросаRequest URI
GETGET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId}/status

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

HeaderHeader ТипType ОписаниеDescription
AuthorizationAuthorization строкаstring Обязательный.Required. Маркер доступа Azure AD в форме носителя < маркера>.The Azure AD access token in the form Bearer <token>.

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

ИмяName ТипType ОписаниеDescription
inAppProductIdinAppProductId строкаstring Обязательный.Required. Код продукта в Магазине для надстройки, содержащей отправку, для которой требуется получить сведения о состоянии.The Store ID of the add-on that contains the submission for which you want to get the status. Идентификатор Store доступен в центре партнеров.The Store ID is available in Partner Center.
submissionIdsubmissionId строкаstring Обязательный.Required. Идентификатор отправки, для которой требуется получить сведения о состоянии.The ID of the submission for which you want to get the status. Этот идентификатор добавляется в данные ответов для запросов на создание отправки надстройки.This ID is available in the response data for requests to create an add-on submission. Для отправки, который был создан в центре партнеров этот идентификатор также доступна в URL-АДРЕСЕ для отправки страницы в центре партнеров.For a submission that was created in Partner Center, this ID is also available in the URL for the submission page in Partner Center.

Тело запросаRequest body

Предоставлять текст запроса для этого метода не требуется.Do not provide a request body for this method.

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

В приведенном ниже примере показано, как получить сведения о состоянии отправки надстройки.The following example demonstrates how to get the status of an add-on submission.

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

ОтветResponse

В следующем примере представлен текст ответа JSON в случае успешного вызова этого метода.The following example demonstrates the JSON response body for a successful call to this method. В теле ответа содержатся сведения об указанной отправке.The response body contains information about the specified submission. Дополнительные сведения о значениях, которые могут содержаться в теле ответа, см. в следующих разделах.For more details about the values in the response body, see the following sections.

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

Тело ответаResponse body

ЗначениеValue ТипType ОписаниеDescription
statusstatus строкаstring Состояние отправки.The status of the submission. Может принимать одно из следующих значений.This can be one of the following values:
  • НетNone
  • Canceled (Отменено)Canceled
  • PendingCommit (Ожидание фиксации)PendingCommit
  • CommitStarted (Фиксация запущена)CommitStarted
  • CommitFailed (Сбой фиксации)CommitFailed
  • PendingPublication (Ожидание публикации)PendingPublication
  • Publishing (Выполняется публикация)Publishing
  • Published (Опубликовано)Published
  • PublishFailed (Сбой публикации)PublishFailed
  • PreProcessing (Предварительная обработка)PreProcessing
  • PreProcessingFailed (Сбой предварительной обработки)PreProcessingFailed
  • Certification (Сертификация)Certification
  • CertificationFailed (Сбой сертификации)CertificationFailed
  • ВыпускRelease
  • ReleaseFailed (Сбой выпуска)ReleaseFailed
statusDetailsstatusDetails Объектobject Содержит дополнительные сведения о состоянии отправки, включая сведения об ошибках.Contains additional details about the status of the submission, including information about any errors. Дополнительные сведения см. в разделе Ресурс сведений о состоянии.For more information, see Status details resource.

Коды ошибокError codes

Если запрос не удается выполнить, ответ будет содержать один из следующих кодов ошибок HTTP.If the request cannot be successfully completed, the response will contain one of the following HTTP error codes.

Код ошибкиError code ОписаниеDescription
404404 Не удалось найти отправку.The submission could not be found.
409409 Надстройка использует возможности центра партнеров, в настоящее время не поддерживается API отправки Microsoft Store.The add-on uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.