获取应用数据

  • 项目

在 Microsoft Store 提交 API 中使用以下方法，可获取合作伙伴中心帐户中现有应用的数据。 有关 Microsoft Store 提交 API 的介绍（包括使用 API 的先决条件），请参阅使用 Microsoft Store 服务创建和管理提交。

在使用这些方法之前，应用必须已存在于你的合作伙伴中心帐户中。 若要创建或管理应用提交，请参阅管理应用提交中的方法。

方法 URI 说明
GET https://manage.devcenter.microsoft.com/v1.0/my/applications 获取所有应用的数据
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} 获取某个特定应用的数据。
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listinappproducts 获取应用的加载项
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights 获取应用的软件包外部测试版

先决条件

如果尚未开始操作，请先完成 Microsoft Store 提交 API 的所有先决条件，然后再尝试使用其中任何方法。

数据资源

获取应用数据的 Microsoft Store 提交 API 方法使用以下 JSON 数据资源。

应用程序资源

此资源表示已注册到你的帐户的应用。

{
  "id": "9NBLGGH4R315",
  "primaryName": "ApiTestApp",
  "packageFamilyName": "30481DevCenterAPITester.ApiTestAppForDevbox_ng6try80pwt52",
  "packageIdentityName": "30481DevCenterAPITester.ApiTestAppForDevbox",
  "publisherName": "CN=…",
  "firstPublishedDate": "1601-01-01T00:00:00Z",
  "lastPublishedApplicationSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621086517"
  },
  "pendingApplicationSubmission": {
    "id": "1152921504621243487",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621243487"
  },
  "hasAdvancedListingPermission": true
}

此资源具有以下值。

Value 类型 说明
id string 应用的应用商店 ID。 有关应用商店 ID 的详细信息，请参阅查看应用标识详细信息。
primaryName string 应用的显示名称。
packageFamilyName string 应用的程序包系列名称。
packageIdentityName string 应用的程序包标识名称。
publisherName 字符串 与应用相关联的 Windows 发布者 ID。 这对应于合作伙伴中心中应用的应用标识页上显示的 Package/Identity/Publisher 值。
firstPublishedDate string 应用的首次发布日期，采用 ISO 8601 格式。
lastPublishedApplicationSubmission object 提供有关应用的上次发布提交信息的 提交资源。
pendingApplicationSubmission object 提供有应用的当前挂起提交信息的 提交资源。
hasAdvancedListingPermission boolean 指示你是否可以配置gamingOptions或预告片以针对该应用提交。 2017 年 5 月之后创建的提交，此值为 true。

加载项资源

该资源提供有关加载项的信息。

{
    "inAppProductId": "9WZDNCRD7DLK"
}

此资源具有以下值。

Value 类型 说明
inAppProductId string 加载项的应用商店 ID。 此值由应用商店提供。 应用商店 ID 的一个示例是 9NBLGGH4TNMP。

外部测试版资源

该资源提供有关应用的软件包外部测试版的信息。

{
    "flightId": "7bfc11d5-f710-47c5-8a98-e04bb5aad310",
    "friendlyName": "myflight",
    "lastPublishedFlightSubmission": {
        "id": "1152921504621086517",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621086517"
    },
    "pendingFlightSubmission": {
        "id": "1152921504621215786",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621215786"
    },
    "groupIds": [
        "1152921504606962205"
    ],
    "rankHigherThan": "Non-flighted submission"
}

此资源具有以下值。

Value 类型 说明
flightId string 软件包外部测试版的 ID。 此值由合作伙伴中心提供。
friendlyName 字符串 软件包外部测试版的名称，如开发人员所指定。
lastPublishedFlightSubmission object 提供有关软件包外部测试版的上次发布提交信息的 提交资源。
pendingFlightSubmission object 提供有关软件包外部测试版的当前挂起提交信息的提交资源。
groupIds array 包含与软件包外部测试版关联的外部测试版组 ID 的字符串数组。 有关外部测试版组的详细信息，请参阅软件包外部测试版。
rankHigherThan string 排名紧跟在当前软件包外部测试版之后的软件包外部测试版的友好名称。 有关排名的外部测试版组的详细信息，请参阅 软件包外部测试版。

提交资源

该资源提供有关提交的信息。 以下示例演示了此资源的格式。

{
  "pendingApplicationSubmission": {
    "id": "1152921504621243487",
    "resourceLocation": "applications/9WZDNCRD9MMD/submissions/1152921504621243487"
  }
}

此资源具有以下值。

Value 类型 说明
id string 提交的 ID。
resourceLocation string 可追加到基本 https://manage.devcenter.microsoft.com/v1.0/my/ 请求 URI 的相对路径，用于检索提交的完整数据。