Создание отправки надстройкиCreate an add-on submission

Используйте этот метод в интерфейсе API отправки Microsoft Store для создания новой отправки надстройки (также известная как app продукта или IAP) для приложения, зарегистрированный для вашей учетной записи центра партнеров.Use this method in the Microsoft Store submission API to create a new add-on (also known as in-app product or IAP) submission for an app that is registered to your Partner Center account. После успешного создания новой отправки с помощью этого метода обновите отправку, чтобы внести любые необходимые изменения в данные отправки, а затем зафиксируйте отправку для внедрения и публикации.After you successfully create a new submission by using this method, update the submission to make any necessary changes to the submission data, and then commit the submission for ingestion and publishing.

Дополнительные сведения об использовании этого метода в процессе создания отправки надстройки с помощью API отправки Microsoft Store см. в разделе Управление отправками надстроек.For more information about how this method fits into the process of creating an add-on submission by using the Microsoft Store submission API, see Manage add-on submissions.

Примечание

При использовании этого метода выполняется создание отправки для имеющейся надстройки.This method creates a submission for an existing add-on. Чтобы создать надстройку, используйте метод Создание надстройки.To create an add-on, use the Create an add-on method.

Предварительные требования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 for one of your apps. Это можно сделать в центре партнеров, или это можно сделать с помощью создать надстройку метод.You can do this in Partner Center, or you can do this by using the Create an add-on 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
ПОМЕСТИТЬPOST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions

Заголовок запроса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 for which you want to create a submission. Идентификатор 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.

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

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

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

В следующем примере кода показано, как создать новую отправку для надстройки.The following example demonstrates how to create a new submission for an add-on.

POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions 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 new 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": [
      {
         "name": "Sale1",
         "basePriceId": "Free",
         "startDate": "2016-05-21T18:40:11.7369008Z",
         "endDate": "2016-05-22T18:40:11.7369008Z",
         "marketSpecificPricings": {
            "RU": "NotAvailable"
         }
      }
    ],
    "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
400400 Не удалось создать отправку. Недопустимый запрос.The submission could not be created because the request is invalid.
409409 Не удалось создать отправки из-за текущего состояния приложения или приложение использует функцию центра партнеров, которая в настоящее время не поддерживается API отправки Microsoft Store.The submission could not be created because of the current state of the app, or the app uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.