Freigeben über

Reagieren auf Rezensionen mithilfe von Store-Diensten

  • Artikel

Wichtig

Die Microsoft Store-Rezensions-API, wie in diesem Thema beschrieben, befindet sich derzeit nicht im Arbeitszustand. Anstatt die APIs zu verwenden, können Sie dieselbe Aufgabe(n) mithilfe des Partner Centers erreichen.

Verwenden Sie die Microsoft Store-Rezensions-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) zum Autorisieren der Aufrufe von Ihrer App oder Ihrem Dienst.

Dazu müssen folgende Schritte ausgeführt werden:

  1. Stellen Sie sicher, dass Sie alle Voraussetzungen erfüllt haben.
  2. Rufen Sie vor dem Aufrufen einer Methode in der Microsoft Store-Rezensions-API ein Azure AD-Zugriffstoken ab. 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. Rufen Sie die Microsoft Store-Rezensionen-API auf.

Hinweis

Zusätzlich zur verwendung der Microsoft Store-Rezensions-API, um programmgesteuert auf Rezensionen zu reagieren, können Sie alternativ mithilfe des Partner Centers auf Rezensionen reagieren.

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 Ihnen müssen die Berechtigungen globaler Administrator für das Verzeichnis gewährt worden sein. Wenn Sie Microsoft 365 oder andere Unternehmensdienste von Microsoft verwenden, verfügen Sie bereits über ein Azure AD-Verzeichnis. Andernfalls können Sie ohne zusätzliche Kosten eine neue Azure AD-Instanz in Partner Center 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 zu erhalten, 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. Verknüpfen Sie in Partner Center das Partner Center-Konto Ihrer Organisation mit dem Azure AD-Verzeichnis Ihrer Organisation.

  2. Fügen Sie als Nächstes auf der Seite "Benutzer" im Abschnitt "Kontoeinstellungen" des Partner Centers 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 in Partner Center eine neue Azure AD-Anwendung erstellen.

  3. Kehren Sie zur Seite Benutzer zurück, klicken Sie auf den Namen Ihrer Azure AD-Anwendung, um die Anwendungseinstellungen zu öffnen, und schreiben Sie die Werte Mandanten-ID und Client-ID auf.

  4. Klicken Sie auf Neuen Schlüssel hinzufügen. Notieren Sie auf dem folgenden Bildschirm den Wert von Schlüssel. 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 Autorisierungsheader jeder Methode in der API übergeben. Nachdem Sie ein Zugriffstoken erhalten haben, haben Sie 60 Minuten Zeit, es zu verwenden, bevor es abläuft. Nach dem Ablauf können Sie das Token aktualisieren, damit Sie es in weiteren Aufrufen der API weiterhin verwenden können.

Um das Zugriffstoken zu erhalten, folgen Sie den Anweisungen in Aufrufe von Dienst zu Dienst mit Anmeldeinformationen des Clients, 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

Für den Wert Mandant_id im POST-URI und die Parameter Client_id und Client_secret geben Sie die ID des Mandanten, die ID des Clients und den Schlüssel für Ihre Anwendung an, den Sie im vorherigen Abschnitt vom Partner Center erhalten haben. Für den Parameter resource müssen Sie https://manage.devcenter.microsoft.com angeben.

Nachdem Ihr Zugriffstoken abgelaufen ist, können Sie es aktualisieren, indem Sie die anweisungen hier befolgen.

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 Autorisierungsheader 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. Rufen Sie die IDs der Rezensionen ab, auf die Sie antworten möchten. Prüf-IDs sind in den Antwortdaten der Methode "Abrufen von App-Rezensionen " in der Microsoft Store-Analyse-API und im Offlinedownload des [Rezensionsberichts](/windows/apps/publish/reviews-report) verfügbar.
  2. Rufen Sie die Get-Antwortinformationen für die Methode "App-Rezensionen " auf, um zu ermitteln, 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 keine Rezensionsantworten erhalten haben.
  3. Rufen Sie die Übermittlungsantworten an die Methode "App-Rezensionen " auf, um programmgesteuert auf die Rezensionen zu reagieren.