Diese Seite wurde von der Cloud Translation API übersetzt.

Auf Rezensionen antworten

Mit der Google Play Developer Reply to Reviews API können Sie Nutzerfeedback für Ihre App und antworten Sie auf dieses Feedback. Über diese API können Sie mit direkt in Ihrem Toolkit für den Bestandskundensupport, z. B. in einem CRM-System, System.

Mit der Reply to Reviews API können Sie nur auf Feedback für die Produktion zugreifen Versionen Ihrer App. Wenn Sie Feedback zu Alpha- oder Betaversionen von verwenden Sie stattdessen die Google Play Console. Beachten Sie außerdem, dass die API zeigt nur die Rezensionen an, die Kommentare enthalten. Wenn ein Nutzer Ihre App bewertet, keinen Kommentar abgeben, ist ihr Feedback über die API nicht zugänglich.

Zugriff erhalten

Zur Verwendung der Reply to Reviews API müssen Sie die Autorisierung entweder über ein OAuth-Client oder Dienstkonto. Wenn Sie ein Dienstkonto verwenden, aktivieren Sie die Methode „Auf Rezensionen antworten“ Berechtigung für dieses Konto. Weitere Informationen zu zum Einrichten des autorisierten Zugriffs auf diese API, siehe API-Zugriffsclients einrichten

Rezensionen abrufen

Mit der Reply to Reviews API können Sie eine Liste aller aktuellen Rezensionen für deine App oder du kannst dir eine einzelne Rezension ansehen.

Eine Reihe von Rezensionen abrufen

Verwenden Sie die Methode GET, um eine Liste mit Rezensionen für Ihre App anzufordern. In Ihrer Anfrage den voll qualifizierten Paketnamen für Ihre App, z. B. com.google.android.apps.maps und das Autorisierungstoken, das Sie beim Zugriff auf die API erhalten

GET https://www.googleapis.com/androidpublisher/v3/applications/your_package_name/reviews?
access_token=your_auth_token

Die Antwort ist ein JSON-String, der eine Liste von Rezensionen für Ihre Anwendung enthält. Die erstes Ergebnis in der Liste enthält den zuletzt erstellten Nutzerkommentar. oder modifiziert wurden.

Im folgenden Beispiel enthält die erste Rezension Metadaten, die in allen Die zweite Überprüfung enthält Metadaten, die nur in einigen Ergebnissen angezeigt werden:

{
  "reviews": [
    {
      "reviewId": "12345678",
      "authorName": "Jane Bloggs",
      "comments": [
        {
          "userComment": {
            "text": "This is the best app ever!",
            "lastModified": {
              "seconds": "1443676826",
              "nanos": 713000000
            },
            "starRating": 5
          }
        }
      ]
    },
    {
      "reviewId": "11223344",
      "authorName": "John Doe",
      "comments": [
        {
          "userComment": {
            "text": "I love using this app!",
            "lastModified": {
              "seconds": "141582134",
              "nanos": 213000000
            },
            "starRating": 5,
            "reviewerLanguage": "en",
            "device": "trltecan",
            "androidOsVersion": 21,
            "appVersionCode": 12345,
            "appVersionName": "1.2.3",
            "thumbsUpCount": 10,
            "thumbsDownCount": 3,
            "deviceMetadata": {
              "productName": "E5333 (Xperia™ C4 Dual)",
              "manufacturer": "Sony",
              "deviceClass": "phone",
              "screenWidthPx": 1080,
              "screenHeightPx": 1920,
              "nativePlatform": "armeabi-v7a,armeabi,arm64-v8a",
              "screenDensityDpi": 480,
              "glEsVersion": 196608,
              "cpuModel": "MT6752",
              "cpuMake": "Mediatek",
              "ramMb": 2048
            }
          }
        },
        {
          "developerComment": {
            "text": "That's great to hear!",
            "lastModified": {
              "seconds": "1423101467",
              "nanos": 813000000
            }
          }
        }
      ]
    }
  ],
  "tokenPagination": {
    "nextPageToken": "12334566"
  }
}

Jedes Ergebnis enthält die folgenden Metadaten:

reviewId

Identifiziert diese Rezension eindeutig. Außerdem gibt er an, Rezension schreiben, da Nutzer nur eine Rezension für eine bestimmte App schreiben können.

authorName

Der Name des Nutzers, der die Rezension verfasst hat.

Hinweis: In seltenen Fällen kann das authorName in einem bestimmten Ergebnis nicht vorkommen.

Kommentare

Eine Liste, die das Feedback der Nutzenden zur App enthält. Wenn dieses Rezension einen Titel enthält, dann werden sowohl dieser Titel als auch der Textkörper der Rezension angezeigt. im text-Element und ein Tabulatorzeichen trennt Titel und Textkörper. Das Element lastModified gibt den Zeitpunkt an, zu dem der Nutzer zuletzt hat seine Rezension abgegeben.

Wenn Sie bereits auf diese Rezension geantwortet haben, wird Ihr Feedback als das zweite Element der Kommentarliste.

starRating

Die Bewertung Ihrer App durch den Nutzer auf einer Skala von 1 bis 5. Punktzahl von 5 zeigt an, dass der Nutzer mit Ihrer App sehr zufrieden ist.

Standardmäßig werden auf jeder Seite zehn Rezensionen angezeigt. Sie können bis zu 100 Rezensionen anzeigen lassen pro Seite, indem Sie den Parameter maxResults in Ihrer Anfrage festlegen.

Wird die Liste der Rezensionen auf einer anderen Seite fortgesetzt, enthält die API ein tokenPagination-Element in der Antwort. Wenn Sie die nächste Seite Rezensionen enthalten das Element token. Legen Sie den Wert dieses Elements auf den Wert nextPageToken-Wert, der in der ursprünglichen Antwort angezeigt wird.

Hinweis:Sie können nur Rezensionen abrufen, die von Nutzern erstellt wurden. die in der letzten Woche geändert wurden. Wenn Sie alle Bewertungen für Ihre können Sie Ihre Apps herunterladen, um herauszufinden, Rezensionen als CSV-Datei über die Google Play Console speichern.

Im folgenden Beispiel für eine GET-Anfrage wird die nächste Seite mit Rezensionen angezeigt. Dieses wird davon ausgegangen, dass die aktuelle Seite mit Rezensionen (wie in der Antwort von der vorherigen Anfrage) den nextPageToken-Wert "12334566" enthält. Die -Anforderung gibt außerdem an, dass auf der nächsten Seite bis zu 50 Erfahrungsberichte angezeigt werden sollen.

GET https://www.googleapis.com/androidpublisher/v3/applications/your_package_name/reviews?
access_token=your_auth_token&token=12334566&maxResults=50

Einzelne Rezension abrufen

Sie können auch die Methode GET verwenden, um eine einzelne Rezension abzurufen. Sie geben URL wie die für eine Reihe von Rezensionen abrufen, mit dem Unterschied, Geben Sie außerdem die review_id für die gewünschte Rezension an:

GET https://www.googleapis.com/androidpublisher/v3/applications/your_package_name/reviews/
review_id?access_token=your_auth_token

Die entsprechende Antwort ist ein JSON-String, der Inhalte und Metadaten enthält. für eine einzelne Rezension:

{
  "reviewId": "87654321",
  "authorName": "Joan Smith",
  "comments": [
    {
      "userComment": {
        "text": "This app is awesome!",
        "lastModified": {
          "seconds": "1452114723",
          "nanos": 913000000
        },
        "starRating": 5
      }
    }
  ]
}

Rezensionstext übersetzen

Rezensionstext kann automatisch übersetzt werden, bevor er vom Review API verfügbar. Wenn Sie eine Liste oder eine einzelne Rezension abrufen, fügen Sie translationLanguage-Parameter hinzu. Beispiel:

GET https://www.googleapis.com/androidpublisher/v3/applications/your_package_name/reviews?
access_token=your_auth_token&translationLanguage=en

Mit dem Parameter translationLanguage kann eine Sprache mit oder ohne angegeben werden Land. Zum Beispiel ist sowohl „en“ und „en_GB“ sind gültig.

Wenn Sie eine andere als die Originalsprache für die Übersetzung angeben Text eingeben, gibt das System den übersetzten Text im Attribut text und den Originaltext in der originalText-Property Beispiel:

    {
      "reviewId": "12345678",
      "authorName": "Jane Bloggs",
      "comments": [
        {
          "userComment": {
            "text": "This is the best app ever!",
            "lastModified": {
              "seconds": "1443676826",
              "nanos": 713000000
            },
            "starRating": 5,
            "originalText": "Dies ist die beste App überhaupt!"
          }
        }
      ]
    }

Auf Rezensionen antworten

Sie können auch mit den Nutzern Ihrer App interagieren, indem Sie auf deren Rezensionen antworten. Nachher wenn du deine Antwort sendest, erhält der Nutzer eine Benachrichtigung, dass du haben bereits auf ihr Feedback reagiert.

Wir raten von automatischen Antworten auf Rezensionen ab, um und diese Antworten später manuell aktualisieren. Sie können zwar auf so oft Sie möchten, erhält der Nutzer nur eine Benachrichtigung nach der ersten Antwort auf eine erstellte oder geänderte Rezension hinzu. Die folgenden Die Tabelle zeigt, wie der Nutzer während Ihrer Interaktionen mit ihm benachrichtigt wird:

Interaktion zwischen Nutzer und Entwickler	Benachrichtigung an Nutzer gesendet?
Der Nutzer schreibt eine Rezension. Entwickler sendet Antwort	Ja
Entwicklerupdates – Antwort auf ursprüngliche Rezension	Nein
Prüfung der Nutzer-Updates: Antwort auf Entwicklerupdates	Ja

Hinweis:Da Ihre Antworten auf Rezensionen öffentlich sichtbar sind, App Store-Seite zu laden, ist es wichtig, dass Sie keine vertraulichen Informationen wenn ihr diese Antworten schreibt.

Verwende die POST-Methode, um eine Antwort auf eine Nutzerrezension zu senden. In Ihrer Anfrage geben an, dass die Content-Type application/json ist, und fügen eine JSON-Datei hinzu Dokument, das Ihre Antwort enthält:

POST https://www.googleapis.com/androidpublisher/v3/applications/your_package_name/reviews/
review_id:reply?access_token=your_access_token
Content-Type: application/json

{
  "replyText": "Thanks for your feedback!"
}

Hinweis:Die replyText, die Sie in Ihrem Die POST-Anfrage darf höchstens 350 Zeichen enthalten. Sie sollten Nur-Text in Ihrer Antwort; korrekt formatierte HTML-Tags entfernt und in Ihrer Antwort enthalten. Die Inhalte, die Sie in korrekt formatierten HTML-Tags bleiben.

Wenn Ihre Anfrage erfolgreich ist, erhalten Sie den folgenden JSON-String als Antwort. Das lastEdited-Element gibt den Zeitpunkt an, zu dem die API Ihre Antwort aufzeichnet. auf den Erfahrungsbericht des Nutzers.

{
  "result": {
    "replyText": "Thanks for your feedback!",
    "lastEdited": {
      "seconds": "1453978803",
      "nanos": 796000000
    }
  }
}

Wenn Ihre POST-Anfrage ungültig ist, wird in der Antwort jedoch einer der folgenden Fehlercodes angezeigt:

400 Bad Reply Request: replyText ist zu lang oder fehlt.
404 Not Found: Die Rezension mit dem review_id ist nicht vorhanden.

Kontingente

Aus Gefälligkeit gegenüber anderen Entwicklern gelten für die Reply to Reviews API Kontingenten. Diese Kontingente werden separat pro App durchgesetzt:

GET Anfragen (zum Abrufen von Rezensionslisten und einzelnen Rezensionen) – 200 pro Stunde
POST Anfragen (zum Beantworten von Rezensionen) – 2.000 pro Tag

Wenn für Ihre App mehr Rezensionen benötigt oder beantwortet werden müssen Kontingente zulassen, senden Sie Anfrage um das Kontingent Ihrer Anwendung zu erhöhen.