创建加载项

2025-06-10

在 Microsoft 应用商店提交 API 中使用此方法为注册到合作伙伴中心帐户的应用创建加载项（也称为应用内产品或 IAP）。

注释

此方法无需提交即可创建加载项。若要为加载项创建提交，请参阅 “管理加载项提交”中的方法。

先决条件

若要使用此方法，首先需要执行以下操作：

如果尚未这样做，请完成Microsoft应用商店提交 API 的所有先决条件。
获取 Azure AD 访问令牌，以供在此方法的请求标头中使用。获取访问令牌后，在它到期前，你有 60 分钟的使用时间。令牌过期后，可以获取一个新令牌。

请求

此方法具有以下语法。有关标头和请求正文的使用示例和说明，请参阅以下部分。

方法	请求 URI
帖子	`https://manage.devcenter.microsoft.com/v1.0/my/inappproducts`

请求标头

标题	类型	DESCRIPTION
授权	字符串	必填。 Azure AD 访问令牌，形式为Bearer<token>。

请求主体

请求正文具有以下参数。

参数	类型	DESCRIPTION	必选
应用程序ID	数组	一个数组，其中包含与此加载项关联的应用的应用商店 ID。此数组中仅支持一个元素。	是的
productId	字符串	加载项的产品 ID。这是可在代码中用于引用加载项的标识符。有关详细信息，请参阅设置产品类型和产品 ID。	是的
产品类型	字符串	加载项的产品类型。支持以下值：耐用和消耗品。	是的

请求示例

以下示例演示如何为应用创建新的易耗型加载项。

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 错误代码之一。

错误代码	DESCRIPTION
400	请求无效。
409	由于加载项的当前状态或加载项使用合作伙伴中心功能，而该功能的 Microsoft 应用商店提交 API 当前不支持，因此无法创建加载项。

通过