Реагирование на отзывы с помощью служб Store

  • Статья

Важно!

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

Используйте API отзывов Microsoft Store для программного реагирования на отзывы приложения в Магазине. Этот API особенно полезен разработчикам, которые хотят массово реагировать на множество отзывов без использования Центра партнеров. Этот API использует Azure Active Directory (Azure AD) для проверки подлинности вызовов из приложения или службы.

Следующие шаги описывают сквозной процесс.

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

Примечание.

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

Шаг 1. Выполнение предварительных требований для использования API проверки Microsoft Store

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

  • У вас (или вашей организации) должен иметься каталог Azure AD, а также у вас должен быть доступ уровня глобального администратора к этому каталогу. Если вы уже используете Microsoft 365 или другие бизнес-службы Microsoft, у вас уже есть каталог Azure AD. В противном случае вы можете создать Azure AD в Центре партнеров без дополнительной платы.

  • Необходимо связать приложение Azure AD с учетной записью Центра партнеров, получить идентификатор клиента и идентификатор клиента для приложения и создать ключ. Приложение Azure AD представляет приложение или службу, из которой требуется вызвать API проверки Microsoft Store. Для получения маркера доступа Azure AD, передаваемого в API, необходимы идентификатор арендатора, идентификатор и ключ клиента.

    Примечание.

    Эту задачу нужно выполнить только один раз. После получения идентификатора арендатора, идентификатора и ключа клиента их можно повторно использовать в любой момент, когда потребуется создать новый маркер доступа Azure AD.

Чтобы связать приложение Azure AD с учетной записью Центра партнеров и получить необходимые значения:

  1. В Центре партнеров свяжите учетную запись Центра партнеров своей организации с каталогом Azure AD организации.

  2. Затем на странице "Пользователи" в разделе параметров учетной записи Центра партнеров добавьте приложение Azure AD, представляющее приложение или службу, которое будет использоваться для ответа на отзывы. Убедитесь, что этому приложению назначена роль Менеджер. Если приложение еще не существует в каталоге Azure AD, можно создать новое приложение Azure AD в Центре партнеров.

  3. Вернитесь на страницу Пользователи, щелкните имя приложения Azure AD, чтобы перейти к параметрам приложения, и скопируйте идентификатор арендатора и идентификатор клиента.

  4. Щелкните Добавить новый ключ. На следующем экране скопируйте значение в поле Ключ. Покинув эту страницу, вы больше не сможете получить доступ к этим сведениям. Дополнительные сведения см. в разделе Управление ключами для приложения Azure AD.

Шаг 2. Получение маркера доступа Azure AD

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

Чтобы получить маркер доступа, следуйте инструкциям в разделе "Вызовы службы для вызовов служб с использованием учетных данных клиента" для отправки HTTP POST в конечную точку https://login.microsoftonline.com/<tenant_id>/oauth2/token . Ниже приведен пример запроса.

POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8

grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource=https://manage.devcenter.microsoft.com

Для значения tenant_id в URI POST и параметрах client_id и client_secret укажите идентификатор клиента, идентификатор клиента и ключ приложения, полученного из Центра партнеров в предыдущем разделе. Для параметра resource укажите значение https://manage.devcenter.microsoft.com.

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

Шаг 3. Вызов API отзывов в Microsoft Store

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

API проверки Microsoft Store содержит несколько методов, которые можно использовать для определения того, разрешено ли отвечать на данную проверку и отправлять ответы на один или несколько отзывов. Выполните этот процесс, чтобы использовать этот API:

  1. Получите идентификаторы отзывов, на которые вы хотите ответить. Идентификаторы проверки доступны в ответных данных метода получения отзывов приложений в API аналитики Microsoft Store и в автономном скачивании отчета [отзывы](/windows/apps/publish/reviews-report).
  2. Вызовите сведения о ответе для метода проверки приложений, чтобы определить, разрешено ли отвечать на отзывы. Когда клиент отправляет отзыв, он может не получать ответы на их проверку. Вы не можете отвечать на отзывы, отправленные клиентами, которые решили не получать ответы на проверку.
  3. Вызовите ответы отправки в метод проверки приложений, чтобы программно реагировать на отзывы.