获取应用评论

在 Microsoft Store 分析 API 中使用此方法，以获取给定日期范围和其他可选筛选器的 JSON 格式的评论数据。 此信息也可以在合作伙伴中心的 评审报告 中获得。

检索应用评审后，可以使用 获取评审回复信息的功能 和 Microsoft Store 评价 API 中的提交评审回复 方法，以编程方式对评审进行回应。

先决条件

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

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

请求

请求语法

请求标头

请求参数

筛选字段

请求的 筛选器 参数包含一个或多个语句，用于筛选响应中的行。 每个语句都包含一个字段和值，这些字段与 eq 或 ne 运算符相关联，某些字段还支持 包含、gt、lt、ge和 le 运算符。 语句可以使用 和 或 或组合。

下面是 筛选器 字符串的示例：filter=contains（reviewText，'great'） 和 contains（reviewText，'ads'） 和 deviceRAM lt 2048 和 market eq 'US'

有关每个字段及其支持的运算符的列表，请参阅下表。 字符串值必须用 筛选器 参数中的单引号括起来。

请求示例

以下示例演示了获取评审数据的多个请求。 将 applicationId 值替换为应用的应用商店 ID。

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?applicationId=9NBLGGGZ5QDR&startDate=1/1/2015&endDate=2/1/2015&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?applicationId=9NBLGGGZ5QDR&startDate=8/1/2015&endDate=8/31/2015&skip=0&filter=contains(reviewText,'great') and contains(reviewText,'ads') and deviceRAM lt 2048 and market eq 'US' HTTP/1.1
Authorization: Bearer <your access token>

响应

响应体

审核值

Value 数组中的元素包含以下值。

请求和响应示例

以下代码片段演示了这些请求的一些示例请求和 JSON 响应正文。

示例请求

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?applicationId=9WZDNCRFJB4P&top=10&skip=0
HTTP/1.1
Authorization: Bearer <your access token>

示例响应

{
    "Value": [
        {
            "date": "3/5/2021 12:48:33 PM",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "ES",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": false,
            "packageVersion": "2.5.2.34894",
            "reviewerName": "Jose Antonio",
            "rating": 5,
            "reviewTitle": "Contoso Demo",
            "reviewText": "Un juego fantastico",
            "helpfulCount": 3,
            "notHelpfulCount": 0,
            "id": "b5e27de9-2334-4849-d17d-4eae3e1e7aa9"
        },
        {
            "date": "1/6/2021 8:41:42 AM",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "TR",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": false,
            "packageVersion": "2.5.2.34894",
            "reviewerName": "fef",
            "rating": 5,
            "helpfulCount": 0,
            "notHelpfulCount": 0,
            "id": "f5d2510a-9796-45ee-01e5-6d5cc4550b09"
        }
    ],
    "TotalCount": 2
}

相关主题

• 审核报告
• 通过 Microsoft 应用商店服务 获取分析数据
• 获取应用评论的响应信息
• 提交对应用评论的回复
• 获取应用安装量
• 获取插件
• 获取错误报告数据
• 获取应用分级