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

Статья
07/05/2024

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

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

Необходимые компоненты

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

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

Запросить

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

Способ	URI запроса
GET	`https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews`

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

Верхний колонтитул	Тип	Описание
Авторизация	строка	Обязательный. Маркер доступа Azure AD в маркере> носителя<формы.

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

Параметр	Тип	Описание	Обязательное поле
applicationId	строка	Идентификатор приложения, для которого требуется получить данные проверки.	Да
startDate	Дата	Дата начала в диапазоне дат для получения данных проверки. Значение по умолчанию — текущая дата.	No
endDate	Дата	Дата окончания в диапазоне дат для получения данных проверки. Значение по умолчанию — текущая дата.	No
популярное	INT	Количество строк данных, возвращаемых в запросе. Максимальное значение и значение по умолчанию, если не указано значение 10000. Если в запросе есть больше строк, текст ответа содержит следующую ссылку, которую можно использовать для запроса следующей страницы данных.	No
skip	INT	Количество строк, пропускаемых в запросе. Используйте этот параметр для страницы с помощью больших наборов данных. Например, top=10000 и skip=0 извлекает первые 10000 строк данных, top=10000 и skip=10000 извлекает следующие 10000 строк данных и т. д.	No
Фильтр	строка	Одна или несколько инструкций, которые фильтруют строки в ответе. Дополнительные сведения см. в разделе полей фильтра ниже.	No
orderby	строка	Инструкция, которая упорядочивает значения результирующих данных. Синтаксис — orderby=field [order], field [order],.... Параметр поля может быть одной из следующих строк: date osVersion рынок deviceType isRevised packageVersion deviceModel productFamily deviceScreenResolution isTouchEnabled рецензентName reviewTitle reviewText полезныйcount notHelpfulCount responseDate responseText deviceRAM deviceStorageCapacity рейтинг Параметр order является необязательным и может быть asc или desc , чтобы указать возрастание или убывание для каждого поля. Значение по умолчанию — asc. Ниже приведен пример строки заказа : orderby=date,market	No

Поля фильтра

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

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

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

Поля	Поддерживаемые операторы	Description
на рынок	eq, ne	Строка, содержащая код страны ISO 3166 рынка устройств.
osVersion	eq, ne	Одна из следующих строк: Windows Phone 7.5 Windows Phone 8 Windows Phone 8.1 Windows Phone 10 Windows 8 Windows 8.1 Windows 10 Windows 11 Unknown
deviceType	eq, ne	Одна из следующих строк: ПК Для телефонов Console-Xbox One Серия Xbox X консоли Интернет вещей Голографический Unknown
isRevised	eq, ne	Укажите значение true , чтобы отфильтровать проверки, которые были изменены; в противном случае — значение false.
packageVersion	eq, ne	Версия пакета приложения, который был проверен.
deviceModel	eq, ne	Тип устройства, на котором было проверено приложение.
productFamily	eq, ne	Одна из следующих строк: ПК Таблетка Для телефонов Пригодный для носки Сервер Совместных Другое
deviceRAM	eq, ne, gt, lt, ge, le	Физический ОЗУ в МБ.
deviceScreenResolution	eq, ne	Разрешение экрана устройства в формате "ширина x высота".
deviceStorageCapacity	eq, ne, gt, lt, ge, le	Емкость основного диска хранилища в ГБ.
isTouchEnabled	eq, ne	Укажите значение true , чтобы фильтровать устройства с поддержкой сенсорного ввода; в противном случае — значение false.
рецензентName	eq, ne	Имя рецензента.
оценка	eq, ne, gt, lt, ge, le	Оценка приложения в звездах.
reviewTitle	eq, ne, содержит	Заголовок проверки.
reviewText	eq, ne, содержит	Текстовое содержимое проверки.
полезныйcount	eq, ne	Количество раз, когда проверка была отмечена полезной.
notHelpfulCount	eq, ne	Количество раз, когда проверка была отмечена не полезной.
responseDate	eq, ne	Дата отправки ответа.
responseText	eq, ne, содержит	Текстовое содержимое ответа.
id	eq, ne	Идентификатор проверки (это GUID).

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

В следующих примерах показано несколько запросов на получение данных проверки. Замените значение 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>

Response

Текст ответа

Значение	Тип	Описание
Значение	array	Массив объектов, содержащих данные проверки. Дополнительные сведения о данных в каждом объекте см . в разделе "Просмотр значений " ниже.
@nextLink	строка	Если есть дополнительные страницы данных, эта строка содержит универсальный код ресурса (URI), который можно использовать для запроса следующей страницы данных. Например, это значение возвращается, если верхний параметр запроса имеет значение 10000, но существует более 10000 строк данных проверки для запроса.
TotalCount	INT	Общее количество строк в результатах данных для запроса.

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

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

Значение	Тип	Описание
Дата	строка	Первая дата в диапазоне дат для данных проверки. Если запрос указал один день, это значение равно дате. Если запрос указал неделю, месяц или другой диапазон дат, это значение является первой датой в этом диапазоне дат.
applicationId	строка	Идентификатор магазина приложения, для которого извлекаются данные проверки.
applicationName	строка	Отображаемое имя приложения.
на рынок	строка	Код страны ISO 3166 рынка, на котором была отправлена проверка.
osVersion	строка	Версия ОС, на которую была отправлена проверка. Список поддерживаемых строк см. в разделе "Поля фильтра" выше.
deviceType	строка	Тип устройства, на котором была отправлена проверка. Список поддерживаемых строк см. в разделе "Поля фильтра" выше.
isRevised	Логический	Значение true указывает, что проверка была изменена; в противном случае — значение false.
packageVersion	строка	Версия пакета приложения, который был проверен.
deviceModel	строка	Тип устройства, на котором было проверено приложение.
productFamily	строка	Имя семейства устройств. Список поддерживаемых строк см. в разделе "Поля фильтра" выше.
deviceRAM	number	Физический ОЗУ в МБ.
deviceScreenResolution	строка	Разрешение экрана устройства в формате "ширина x высота".
deviceStorageCapacity	number	Емкость основного диска хранилища в ГБ.
isTouchEnabled	Логический	Значение true указывает, что касание включено; в противном случае значение false.
рецензентName	строка	Имя рецензента.
оценка	number	Оценка приложения в звездах.
reviewTitle	строка	Заголовок проверки.
reviewText	строка	Текстовое содержимое проверки.
полезныйcount	number	Количество раз, когда проверка была отмечена полезной.
notHelpfulCount	number	Количество раз, когда проверка была отмечена не полезной.
responseDate	строка	Дата отправки ответа.
responseText	строка	Текстовое содержимое ответа.
id	строка	Идентификатор проверки (это GUID). Этот идентификатор можно использовать в получите сведения о ответе для отзывов приложений и отправить ответы методам проверки приложений.

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

В следующих фрагментах кода показан пример текста запроса и текста ответа 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
}

Поделиться через

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

Необходимые компоненты

Запросить

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

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

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

Поля фильтра

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

Response

Текст ответа

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

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

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

Пример ответа

Обратная связь

Дополнительные ресурсы

Поделиться через

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

Необходимые компоненты

Запросить

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

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

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

Поля фильтра

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

Response

Текст ответа

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

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

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

Пример ответа

См. также

Обратная связь

Дополнительные ресурсы