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

Используйте этот метод в API отправки в Microsoft Store для получения данных для существующей отправки надстройки (также называется внутренним продуктом приложения или IAP).Use this method in the Microsoft Store submission API to get data for an existing 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}

Заголовок запроса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 you want to get. Идентификатор Store доступен в центре партнеров, и она включена в данные ответа для запросов к создать надстройку или получение сведений о надстройка.The Store ID is available in Partner Center, and it is included in the response data for requests to Create an add-on or get add-on details.
submissionIdsubmissionId строкаstring Обязательный.Required. Идентификатор отправки, которую требуется получить.The ID of the submission to get. Этот идентификатор добавляется в данные ответов для запросов на создание отправки надстройки.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 an add-on submission.

GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621243680 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 add-on submission resource.

{
  "id": "1152921504621243680",
  "contentType": "EMagazine",
  "keywords": [
    "books"
  ],
  "lifetime": "FiveDays",
  "listings": {
    "en": {
      "description": "English add-on description",
      "icon": {
        "fileName": "add-on-en-us-listing2.png",
        "fileStatus": "Uploaded"
      },
      "title": "Add-on Title (English)"
    },
    "ru": {
      "description": "Russian add-on description",
      "icon": {
        "fileName": "add-on-ru-listing.png",
        "fileStatus": "Uploaded"
      },
      "title": "Add-on Title (Russian)"
    }
  },
  "pricing": {
    "marketSpecificPricings": {
      "RU": "Tier3",
      "US": "Tier4",
    },
    "sales": [],
    "priceId": "Free",
    "isAdvancedPricingModel": true
  },
  "targetPublishDate": "2016-03-15T05:10:58.047Z",
  "targetPublishMode": "Immediate",
  "tag": "SampleTag",
  "visibility": "Public",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [
      {
        "code": "None",
        "details": "string"
      }
    ],
    "warnings": [
      {
        "code": "ListingOptOutWarning",
        "details": "You have removed listing language(s): []"
      }
    ],
    "certificationReports": [
      {
      }
    ]
  },

    "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/26920f66-b592-4439-9a9d-fb0f014902ec?sv=2014-02-14&sr=b&sig=usAN0kNFNnYE2tGQBI%2BARQWejX1Guiz7hdFtRhyK%2Bog%3D&se=2016-06-17T20:45:51Z&sp=rwl",
    "friendlyName": "Submission 2"
}

Коды ошибок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 submission does not belong to the specified add-on, or the add-on uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.