Создать надстройку

Статья
2025-03-24

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

Заметка

Этот метод создает надстройку без каких-либо отправок. Чтобы создать заявку для надстройки, ознакомьтесь с методами в Управление заявками надстроек.

Необходимые условия

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

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

Просьба

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

Метод	URI запроса
ПОСТ	`https://manage.devcenter.microsoft.com/v1.0/my/inappproducts`

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

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

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

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

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

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

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

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.

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