获取加载项

2025-06-10

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

先决条件

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

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

请求

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

方法	请求 URI
获取	`https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}`

请求标头

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

请求参数

名称	类型	DESCRIPTION
id	字符串	必填。要检索的加载项的应用商店 ID。商店 ID 可以在合作伙伴中心获得。

请求主体

请勿为此方法提供请求主体。

请求示例

以下示例演示如何检索有关加载项的信息。

GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP HTTP/1.1
Authorization: Bearer <your access token>

响应

以下示例演示了成功调用此方法的 JSON 响应正文。有关响应正文中数值的更多详细信息，请参阅插件资源。

{
  "applications": {
    "value": [
      {
        "id": "9NBLGGH4R315",
        "resourceLocation": "applications/9NBLGGH4R315"
      }
    ],
    "totalCount": 1
  },
  "id": "9NBLGGH4TNMP",
  "productId": "Test-add-on",
  "productType": "Durable",
  "pendingInAppProductSubmission": {
    "id": "1152921504621243619",
    "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243619"
  },
  "lastPublishedInAppProductSubmission": {
    "id": "1152921504621243705",
    "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243705"
  }
}

错误代码

如果请求无法成功完成，响应将包含以下 HTTP 错误代码之一。

错误代码	DESCRIPTION
404	找不到指定的加载项。
409	加载项使用合作伙伴中心功能，Microsoft应用商店提交 API当前不支持该功能。

通过