Создание надстройки

  • Статья

Используйте этот метод в API отправки Microsoft Store, чтобы создать надстройку (продукт из приложения или IAP) для приложения, зарегистрированного в вашей учетной записи Центра партнеров.

Примечание

При использовании этого метода выполняется создание надстройки без отправок. Руководство по созданию отправки для надстройки см. в описании методов в разделе Управление отправками надстроек.

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

Для использования этого метода сначала необходимо сделать следующее:

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

Запрос

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

Метод Универсальный код ресурса (URI) запроса
POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts

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

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

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

Текст запроса содержит следующие параметры.

Параметр Тип Описание Обязательно
applicationIds array Массив, содержащий код продукта в Магазине для приложения, с которым связана эта надстройка. Этот массив поддерживает только один элемент. Да
productId строка Код продукта этой надстройки. Этот идентификатор можно использовать в коде для установки ссылки на надстройку. Дополнительные сведения см. в разделе Установка типа и кода продукта. Да
productType строка Тип продукта этой надстройки. Поддерживаются следующие значения: Длительного пользования и Потребляемый. Да

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

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

POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Content-Type: application/json
{
    "applicationIds": [  "9NBLGGH4R315"  ],
    "productId": "my-new-add-on",
    "productType": "Consumable",
}

Ответ

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

{
  "applications": {
    "value": [
      {
        "id": "9NBLGGH4R315",
        "resourceLocation": "applications/9NBLGGH4R315"
      }
    ],
    "totalCount": 1
  },
  "id": "9NBLGGH4TNMP",
  "productId": "my-new-add-on",
  "productType": "Consumable",
}

Коды ошибок

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

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