API Google Play do odpowiadania na opinie: lista i odpowiedzi

English · Español · Deutsch · Français

Interfejs API do odpowiadania na opinie pozwala odczytywać opinie z Google Play i odpowiadać na nie we własnych narzędziach obsługi klienta. Wszystko poniżej pochodzi z przewodnika Google po tym API.

Dostęp

• Uwierzytelnij się za pomocą klienta OAuth lub konta usługi, które ma uprawnienie „Odpowiadanie na opinie” (Google Play Developer API: Odpowiadanie na opinie).
• API obejmuje tylko wersje produkcyjne Twojej aplikacji i tylko opinie zawierające komentarz (Google Play Developer API: Odpowiadanie na opinie).

Lista opinii

GET https://www.googleapis.com/androidpublisher/v3/applications/{packageName}/reviews?maxResults=100&translationLanguage=en

• Domyślnie 10 opinii na stronę, do 100 z parametrem maxResults. Następną stronę pobierzesz, przekazując tokenPagination.nextPageToken jako token.
• Zwracane są tylko opinie utworzone lub zmodyfikowane w ostatnim tygodniu. Starsze opinie pobierzesz jako plik CSV z Konsoli Play.
• Jeśli opinia ma tytuł, tytuł i treść znajdują się w jednym polu text, oddzielone tabulatorem.
• Twoja dotychczasowa odpowiedź jest drugim elementem comments, jako developerComment.

Pojedyncza opinia: GET …/reviews/{reviewId}. Wszystko z Google Play Developer API: Odpowiadanie na opinie.

Odpowiadanie

POST https://www.googleapis.com/androidpublisher/v3/applications/{packageName}/reviews/{reviewId}:reply
Content-Type: application/json

{"replyText": "Thanks, Sam. 4.2.1 fixes the sync bug. If it still fails, email support@yourapp.com."}

• replyText: maksymalnie 350 znaków, zwykły tekst. Poprawnie sformułowane znaczniki HTML są usuwane i nie są wliczane.
• Błędy: 400, gdy odpowiedź jest za długa lub jej brakuje, 404, gdy opinia nie istnieje.
• Limity na aplikację: 200 żądań GET na godzinę i 2000 żądań POST dziennie. Możesz poprosić Google o wyższy limit.

Wszystko z Google Play Developer API: Odpowiadanie na opinie.

Powiadomienia i automatyzacja

Użytkownik jest powiadamiany po Twojej pierwszej odpowiedzi na nową lub zaktualizowaną opinię. Sama aktualizacja odpowiedzi nie powoduje powiadomienia. Google odradza automatyczne odpowiedzi, które zamierzasz później ręcznie aktualizować (Google Play Developer API: Odpowiadanie na opinie). Odpowiedzi muszą być zgodne z zasadami publikowania komentarzy dewelopera (Pomoc Konsoli Play: Wyświetlanie oraz analizowanie ocen aplikacji i opinii o niej).

Źródła

• Google Play Developer API: Odpowiadanie na opinie
• Pomoc Konsoli Play: Wyświetlanie oraz analizowanie ocen aplikacji i opinii o niej

Powiązane poradniki

• Odpowiedzi na opinie w Google Play: zasady i limit 350 znaków
• API App Store Connect: odczytywanie opinii klientów i odpowiadanie na nie
• Szablony odpowiedzi na recenzje aplikacji: błędy, ceny, logowanie i awarie
• Wszystkie poradniki dla deweloperów

Najczęstsze pytania

Czy API Google Play może zwrócić wszystkie opinie?

Nie. Zwraca tylko opinie utworzone lub zmodyfikowane w ostatnim tygodniu. Google zaleca pobranie pliku CSV z Konsoli Play w przypadku starszych opinii.

Jakie limity ma API do odpowiadania na opinie?

200 żądań GET na godzinę i 2000 żądań POST dziennie na aplikację. Google przyjmuje prośby o wyższe limity.

Jakie uprawnienie musi mieć konto usługi?

Uprawnienie „Odpowiadanie na opinie” w Konsoli Play.

Co oznacza błąd 400 z reviews.reply?

Brakuje pola replyText lub ma ponad 350 znaków.