Freigeben über

Reagieren auf Rezensionen mithilfe von Store-Diensten

Von Bedeutung

Die Microsoft Store-Bewertungen-API, wie in diesem Thema beschrieben, ist derzeit nicht funktionsfähig. Anstatt die APIs zu verwenden, können Sie dieselben Aufgaben ausführen, indem Sie Partner Centerverwenden.

Verwenden Sie die Microsoft Store-Rezensionen-API, um programmgesteuert auf Rezensionen Ihrer App im Store zu reagieren. Diese API ist besonders nützlich für Entwickler, die massenweise auf viele Rezensionen reagieren möchten, ohne Partner Center zu verwenden. Diese API verwendet Azure Active Directory (Azure AD), um die Aufrufe von Ihrer App oder Ihrem Dienst zu authentifizieren.

Die folgenden Schritte beschreiben den ganzheitlichen Prozess:

  1. Vergewissern Sie sich, dass Sie alle Voraussetzungenabgeschlossen haben.
  2. Bevor Sie eine Methode in der Microsoft Store-Rezensions-API aufrufen, ein Azure AD-Zugriffstokenabrufen. Nachdem Sie ein Token abgerufen haben, haben Sie 60 Minuten Zeit, dieses Token in Aufrufen der Microsoft Store-Rezensions-API zu verwenden, bevor das Token abläuft. Nach Ablauf des Tokens können Sie ein neues Token generieren.
  3. Aufrufen der Microsoft Store-Rezensionen-API.

Hinweis

Neben der Verwendung der Microsoft Store-Bewertungs-API, um automatisiert auf Rezensionen zu reagieren, können Sie alternativ über das Partner Centerauf Rezensionen antworten.

Schritt 1: Abschließen der Voraussetzungen für die Verwendung der Microsoft Store-Rezensions-API

Bevor Sie mit dem Schreiben von Code zum Aufrufen der Microsoft Store-Rezensions-API beginnen, stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllt haben.

  • Sie (oder Ihre Organisation) müssen über ein Azure AD-Verzeichnis verfügen und die globale Administratorberechtigung für das Verzeichnis besitzen. Wenn Sie Bereits Microsoft 365 oder andere Geschäftsdienste von Microsoft verwenden, verfügen Sie bereits über das Azure AD-Verzeichnis. Andernfalls können Sie einen neuen Azure AD im Partner Center ohne zusätzliche Gebühr erstellen.

  • Sie müssen ihrer Partner Center-Konto eine Azure AD-Anwendung zuordnen, die Mandanten-ID und die Client-ID für die Anwendung abrufen und einen Schlüssel generieren. Die Azure AD-Anwendung stellt die App oder den Dienst dar, aus der Sie die Microsoft Store-Rezensionen-API aufrufen möchten. Sie benötigen die Mandanten-ID, die Client-ID und den Schlüssel, um ein Azure AD-Zugriffstoken abzurufen, das Sie an die API übergeben.

    Hinweis

    Sie müssen diese Aufgabe nur einmal ausführen. Nachdem Sie über die Mandanten-ID, die Client-ID und den Schlüssel verfügen, können Sie diese jederzeit wiederverwenden, wenn Sie ein neues Azure AD-Zugriffstoken erstellen müssen.

So ordnen Sie eine Azure AD-Anwendung Ihrem Partner Center-Konto zu und rufen die erforderlichen Werte ab:

  1. im Partner Center das Partner Center-Konto Ihrer Organisation dem Azure AD-Verzeichnis Ihrer Organisationzuordnen.

  2. Fügen Sie als Nächstes auf der Seite Benutzer im Abschnitt Kontoeinstellungen Partner Center die Azure AD-Anwendung hinzu, die die App oder den Dienst darstellt, die Sie verwenden werden, um auf Rezensionen zu reagieren. Stellen Sie sicher, dass Sie dieser Anwendung die Rolle Manager zuweisen. Wenn die Anwendung noch nicht in Ihrem Azure AD-Verzeichnis vorhanden ist, können Sie eine neue Azure AD-Anwendung im Partner Centererstellen.

  3. Kehren Sie zur Seite Benutzer zurück, klicken Sie auf den Namen Ihrer Azure AD-Anwendung, um zu den Anwendungseinstellungen zu wechseln, und kopieren Sie die werte Mandanten-ID und Client-ID.

  4. Klicken Sie auf Neuen Schlüssel hinzufügen. Notieren Sie sich auf dem folgenden Bildschirm den Wert Key. Nachdem Sie diese Seite verlassen haben, können Sie nicht mehr auf diese Informationen zugreifen. Weitere Informationen finden Sie unter Verwalten von Schlüsseln für eine Azure AD-Anwendung.

Schritt 2: Abrufen eines Azure AD-Zugriffstokens

Bevor Sie eine der Methoden in der Microsoft Store-Rezensions-API aufrufen, müssen Sie zuerst ein Azure AD-Zugriffstoken abrufen, das Sie an den Autorisierungs-Header jeder Methode in der API übergeben. Nachdem Sie ein Zugriffstoken abgerufen haben, müssen Sie es 60 Minuten verwenden, bevor es abläuft. Nachdem das Token abgelaufen ist, können Sie das Token aktualisieren, damit Sie es weiterhin in weiteren Aufrufen der API verwenden können.

Um das Zugriffstoken abzurufen, befolgen Sie die Anweisungen in Dienstanrufe mithilfe von Clientanmeldeinformationen, um einen HTTP POST an den https://login.microsoftonline.com/<tenant_id>/oauth2/token Endpunkt zu senden. Hier ist eine Beispielanforderung.

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

Geben Sie für den tenant_id Wert im POST-URI und den Parametern client_id und client_secret die Mandanten-ID, die Client-ID und den Schlüssel für Ihre Anwendung an, die Sie im vorherigen Abschnitt aus Partner Center abgerufen haben. Für den parameter Ressource müssen Sie https://manage.devcenter.microsoft.comangeben.

Nachdem Ihr Zugriffstoken abgelaufen ist, können Sie es aktualisieren, indem Sie die Anweisungen hierfolgen.

Schritt 3: Aufrufen der Microsoft Store-Rezensionen-API

Nachdem Sie über ein Azure AD-Zugriffstoken verfügen, können Sie die Microsoft Store-Rezensions-API aufrufen. Sie müssen das Zugriffstoken an den Authorization Header jeder Methode übergeben.

Die Microsoft Store-Rezensions-API enthält mehrere Methoden, mit denen Sie bestimmen können, ob Sie auf eine bestimmte Rezension antworten und Antworten an eine oder mehrere Rezensionen senden dürfen. Gehen Sie folgendermaßen vor, um diese API zu verwenden:

  1. Ermitteln Sie die IDs der Rezensionen, auf die Sie antworten möchten. Rezensions-IDs sind in den Antwortdaten der App-Rezensionen-Methode in der Microsoft Store-Analyse-API und im Offline-Download des [Rezensionsberichts](/windows/apps/publish/reviews-report) verfügbar.
  2. Rufen Sie die Methode „Antwortinformationen für App-Rezensionen abrufen“ auf, um zu bestimmen, ob Sie auf die Rezensionen antworten dürfen. Wenn ein Kunde eine Rezension übermittelt, kann er sich entscheiden, keine Antworten auf seine Rezension zu erhalten. Sie können nicht auf Rezensionen antworten, die von Kunden eingereicht wurden, die sich entschieden haben, keine Rezensionsantworten zu erhalten.
  3. Rufen Sie die Antworten auf App-Rezensionen Methode auf, um programmgesteuert auf die Rezensionen zu reagieren.
  • Last updated on