获取应用数据

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

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

方法 URI DESCRIPTION
获取 https://manage.devcenter.microsoft.com/v1.0/my/applications 获取所有应用的数据
获取 https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} 获取特定应用的数据
获取 https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listinappproducts 获取应用程序的附加组件
获取 https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights 获取应用的套餐航班

先决条件

如果尚未这样做,请先完成 Microsoft 应用商店提交 API 的所有 先决条件,然后再尝试使用这些方法。

数据资源

用于获取应用数据的Microsoft应用商店提交 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
}

此资源具有以下值。

价值 类型 DESCRIPTION
ID 字符串 应用的商店 ID。 有关应用商店 ID 的详细信息,请参阅 “查看应用标识详细信息”。
主要名称 字符串 应用的主要名称。
包系列名称 字符串 应用的包系列名称。
程序包标识名称 字符串 应用程序的包标识名称。
出版商名称 字符串 与应用关联的 Windows 发布者 ID。 这与合作伙伴中心中应用的 应用标识 页上显示的 包/身份/发布者 值相对应。
首次发布时间 字符串 应用首次发布的日期(采用 ISO 8601 格式)。
最后发布的应用程序提交 物体 提交资源,提供有关应用上次发布的提交的信息。
待处理的申请提交 物体 提交资源,用于提供关于应用程序当前挂起的提交的信息。
具有高级列出权限 布尔 指示是否可以为应用的提交配置 游戏选项预告片。 此值适用于在 2017 年 5 月之后创建的提交。

附加资源

此资源提供有关插件的信息。

{
    "inAppProductId": "9WZDNCRD7DLK"
}

此资源具有以下值。

价值 类型 DESCRIPTION
应用内产品ID 字符串 加载项的应用商店 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"
}

此资源具有以下值。

价值 类型 DESCRIPTION
航班编号 字符串 包裹航班的 ID。 此值由合作伙伴中心提供。
友好名称 字符串 由开发人员指定的软件包航班的名称。
最新发布的航班提交 物体 提交资源,提供有关包飞行中最后一次发布的提交的信息。
待提交的航班 物体 提交资源,提供有关软件包发布当前待审核提交的信息。
组 ID 数组 一个字符串数组,其中包含与软件包航班关联的航班组ID。 有关航班组的详细信息,请参阅 打包航班
rankHigherThan 字符串 当前套餐飞行之下一级的套餐飞行的友好名称。 有关排名航班组的详细信息,请参阅 航班套餐

提交资源

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

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

此资源具有以下值。

价值 类型 DESCRIPTION
ID 字符串 提交的ID。
resourceLocation 字符串 用于检索提交完整数据的相对路径,可以追加到基础 https://manage.devcenter.microsoft.com/v1.0/my/ 请求 URI。