Share via

Отправка ответов на отзывы

  • Статья

Важно!

API проверки Microsoft Store, как описано в этом разделе, в настоящее время не находится в рабочем состоянии. Вместо использования API можно достичь одной и той же задачи с помощью Центра партнеров.

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

Когда клиент отправляет отзыв, он может не получать ответы на их проверку. Если вы пытаетесь ответить на проверку, для которой клиент решил не получать ответы, текст ответа этого метода будет указывать на то, что попытка ответа была неудачной. Перед вызовом этого метода можно при необходимости определить, разрешено ли отвечать на данную проверку с помощью получения сведений о ответе для метода проверки приложений.

Примечание.

Помимо использования этого метода для программного реагирования на отзывы, можно также ответить на отзывы с помощью Центра партнеров.

Предварительные требования

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

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

Запрос

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

Метод URI запроса
POST https://manage.devcenter.microsoft.com/v1.0/my/reviews/responses

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

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

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

Этот метод не имеет параметров запроса.

Текст запроса

Текст запроса имеет следующие значения.

Значение Тип Описание
Ответы хранилища Массив объектов, содержащих данные ответа, которые нужно отправить. Дополнительные сведения о данных в каждом объекте см. в следующей таблице.

Каждый объект в массиве Responses содержит следующие значения.

Значение Тип Описание Обязательно
ApplicationId строка Идентификатор магазина приложения с проверкой, на которую вы хотите ответить. Идентификатор Магазина доступен на странице удостоверений приложения Центра партнеров. Пример идентификатора магазина — 9WZDNCRFJ3Q8. да
ReviewId строка Идентификатор проверки, на которую вы хотите ответить (это GUID). Идентификаторы проверки доступны в ответных данных метода получения отзывов приложений в API аналитики Microsoft Store и в автономном скачиванииотчета о проверках. да
ResponseText строка Ответ, который вы хотите отправить. Ответ должен соответствовать этим рекомендациям. да
SupportEmail строка Адрес электронной почты службы поддержки вашего приложения, который клиент может использовать для прямого обращения к вам. Это должен быть допустимый адрес электронной почты. да
IsPublic Логическое Если указать значение true, ваш ответ будет отображаться в списке Магазина вашего приложения, непосредственно под проверкой клиента и будет отображаться всем клиентам. Если вы указали false и пользователь не отказался от получения ответов электронной почты, ваш ответ будет отправлен клиенту по электронной почте, и он не будет отображаться другим клиентам в списке Магазина вашего приложения. Если вы указали false и пользователь отказался от получения ответов электронной почты, будет возвращена ошибка. да

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

В следующем примере показано, как использовать этот метод для отправки ответов на несколько проверок.

POST https://manage.devcenter.microsoft.com/v1.0/my/reviews/responses HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
  "Responses": [
    {
      "ApplicationId": "9WZDNCRFJ3Q8",
      "ReviewId": "6be543ff-1c9c-4534-aced-af8b4fbe0316",
      "ResponseText": "Thank you for pointing out this bug. I fixed it and published an update, you should have the fix soon",
      "SupportEmail": "support@contoso.com",
      "IsPublic": true
    },
    {
      "ApplicationId": "9NBLGGH1RP08",
      "ReviewId": "80c9671a-96c2-4278-bcbc-be0ce5a32a7c",
      "ResponseText": "Thank you for submitting your review. Can you tell more about what you were doing in the app when it froze? Thanks very much for your help.",
      "SupportEmail": "support@contoso.com",
      "IsPublic": false
    }
  ]
}

Ответ

Текст ответа

Значение Тип Описание
Результат хранилища Массив объектов, содержащих данные о каждом отправленном ответе. Дополнительные сведения о данных в каждом объекте см. в следующей таблице.

Каждый объект в массиве результатов содержит следующие значения.

Значение Тип Описание
ApplicationId строка Идентификатор магазина приложения с отзывом, на который вы ответили. Пример идентификатора магазина — 9WZDNCRFJ3Q8.
ReviewId строка Идентификатор отзыва, на который вы ответили. Это GUID.
Выполнено строка Значение true указывает, что ваш ответ был отправлен успешно. Значение false указывает, что ответ был неудачным.
FailureReason строка Если успешно выполненозначение false, это значение содержит причину сбоя. Если значение успешно выполнено, это значение пусто.

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

В следующем примере показан пример текста ответа JSON для этого запроса.

{
  "Result": [
    {
      "ApplicationId": "9WZDNCRFJ3Q8",
      "ReviewId": "6be543ff-1c9c-4534-aced-af8b4fbe0316",
      "Successful": "true",
      "FailureReason": ""
    },
    {
      "ApplicationId": "9NBLGGH1RP08",
      "ReviewId": "80c9671a-96c2-4278-bcbc-be0ce5a32a7c",
      "Successful": "false",
      "FailureReason": "No Permission"
    }
  ]
}