Получение отзывов о приложении

Используйте этот метод в API аналитики Microsoft Store для получения данных в формате JSON для заданного диапазона дат и других необязательных фильтров. Эти сведения также доступны в отчете "Отзывы " в Центре партнеров.

После получения отзывов вы можете использовать метод для получения информации о ответах на отзывы приложений и метод для отправки ответов на отзывы приложений в API отзывов Microsoft Store для автоматического реагирования на отзывы.

Предпосылки

Чтобы использовать этот метод, сначала необходимо выполнить следующие действия:

• Если это еще не сделано, выполните все предварительные требования для API аналитики Microsoft Store.
• Получите маркер доступа Azure AD для использования в заголовке запроса для этого метода. После получения маркера доступа у вас есть 60 минут, чтобы использовать его до истечения срока действия. После истечения срока действия токена можно получить новый токен.

Просьба

Синтаксис запроса

Заголовок запроса

Параметры запроса

Фильтрация полей

Параметр фильтра запроса содержит одну или несколько инструкций, которые фильтруют строки в ответе. Каждое утверждение содержит поле и значение, которые связаны с операторами eq или ne, а некоторые поля также поддерживают операции contains, gt, lt, geи le. Утверждения можно объединять, используя и, или , или.

Ниже приведен пример строки фильтра: filter=contains(reviewText,'great') и contains(reviewText,'ads') и deviceRAM lt 2048 и market eq 'US'

Список поддерживаемых полей и операторов поддержки для каждого поля см. в следующей таблице. Строковые значения должны быть окружены одними кавычками в параметре фильтра .

Пример запроса

В следующих примерах показано несколько запросов на получение данных проверки. Замените значение applicationId идентификатором Магазина для приложения.

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>

Ответ

Основная часть ответа

Просмотр значений

Элементы в массиве значений содержат следующие значения.

Пример запроса и ответа

В следующих фрагментах кода показан пример текста запроса и текста ответа 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 Store
• Получение информации о ответах на отзывы приложений
• Отправка ответов на отзывы приложений
• Покупка приложений
• Приобретение дополнений
• Получение данных о сообщениях об ошибках
• Получите оценки приложений