Ta strona została przetłumaczona przez Cloud Translation API.

Odpowiadanie na opinie

Interfejs Google Play Developer Reply to Reviews API umożliwia wyświetlanie opinii użytkowników za swoją aplikację i odpowiedz na tę opinię. Za pomocą tego interfejsu API możesz wchodzić w interakcje z: użytkowników bezpośrednio w ramach istniejących narzędzi do obsługi klienta, takich jak system zarządzania relacjami z klientami (CRM) systemu.

Interfejs Reply to Reviews API zapewnia dostęp do opinii tylko na potrzeby produkcji wersji Twojej aplikacji. Jeśli chcesz poznać opinie na temat wersji alfa lub beta usługi Twojej aplikacji, użyj Konsoli Google Play. Pamiętaj też, że interfejs API wyświetla tylko opinie zawierające komentarze. Jeśli użytkownik ocenia Twoją aplikację, ale to robi nie doda komentarza, jego opinia nie będzie dostępna z poziomu interfejsu API.

Uzyskiwanie dostępu

Aby korzystać z interfejsu Reply to Reviews API, musisz zezwolić na autoryzację za pomocą konto klienta OAuth lub konto usługi. Jeśli używasz konta usługi, włącz „Odpowiadanie na opinie” na tym koncie. Więcej informacji na temat: ustanawia autoryzowany dostęp do tego interfejsu API, zapoznaj się z Konfigurowanie klientów dostępu do interfejsu API.

Pobieranie opinii

Przy użyciu interfejsu Reply to Reviews API możesz pobrać listę wszystkich ostatnich opinii o aplikacji. Możesz też wyświetlić indywidualną opinię.

Pobieranie zestawu opinii

Aby poprosić o listę opinii o aplikacji, użyj metody GET. W swojej prośbie zawierają pełną nazwę pakietu aplikacji, np. com.google.android.apps.maps – oraz token autoryzacji otrzymany podczas uzyskiwanie dostępu do interfejsu API.

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

Odpowiedź jest ciągiem znaków JSON zawierającym listę opinii o aplikacji. pierwszy wynik na liście pokazuje najnowszy komentarz użytkownika lub zmodyfikowane.

W poniższym przykładzie pierwsza opinia pokazuje metadane, które pojawiają się we wszystkich wyników. Druga opinia zawiera metadane, które pojawiają się tylko w niektórych wynikach:

{
  "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"
  }
}

Każdy wynik zawiera te metadane:

reviewId

Jednoznacznie identyfikuje tę opinię. Wskazuje też dane użytkownika ponieważ użytkownicy mogą napisać tylko jedną opinię o danej aplikacji.

authorName

Nazwa użytkownika, który napisał opinię.

Uwaga: w rzadkich przypadkach authorName może nie pojawiają się w danym wyniku.

komentarze

Lista zawierająca opinie użytkownika na temat aplikacji. Jeśli zawiera tytuł, ten tytuł i treść opinii zostaną wyświetlone w elemencie text, znak tabulatora rozdziela tytuł i tekst główny. Element lastModified wskazuje, o której godzinie użytkownik zalogował się ostatnio przesłał(a) swoją opinię.

Jeśli otrzymaliśmy już od Ciebie odpowiedź na tę opinię, będzie ona widoczna jako jako drugiego elementu na liście komentarzy.

starRating

Ocena aplikacji przez użytkownika w skali od 1 do 5. Wynik: 5 wskazuje, że użytkownik jest bardzo zadowolony z aplikacji.

Domyślnie na każdej stronie pojawia się 10 opinii. Możesz wyświetlać maksymalnie 100 opinii na stronę, ustawiając w żądaniu parametr maxResults.

Jeśli lista opinii będzie kontynuowana na innej stronie, interfejs API zawiera link Element tokenPagination w odpowiedzi. Podczas żądania wyświetlenia następnej strony opinie, dołącz element token. Jako wartość tego elementu ustaw nextPageToken, która pojawia się w pierwotnej odpowiedzi.

Uwaga: możesz pobierać tylko opinie utworzone przez użytkowników. lub zmodyfikowane w ciągu ostatniego tygodnia. Jeśli chcesz pobrać wszystkie opinie na temat aplikacji, można pobrać w pliku CSV, korzystając z Konsoli Google Play.

Poniższy przykład żądania GET wyświetla następną stronę opinii. Ten zakłada, że bieżąca strona opinii (jak pokazano w odpowiedzi poprzednie żądanie) zawiera wartość nextPageToken w wysokości "12334566". wskazuje też, że na następnej stronie powinno wyświetlić się maksymalnie 50 opinii.

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

Pobieranie pojedynczej opinii

Aby pobrać pojedynczą opinię, możesz też użyć metody GET. Ty dostarczasz taki sam adres URL, jaki został użyty do pobierania zestawu opinii, z wyjątkiem dołącz też pole review_id odpowiadające opinii, którą chcesz zobaczyć:

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

Powiązana odpowiedź jest ciągiem znaków JSON, który zawiera treść i metadane do pojedynczej opinii:

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

Tłumaczenie tekstu opinii

Przed zwróceniem opinii tekst może zostać przetłumaczony automatycznie API opinii. Pobierając listę lub pojedynczą opinię, dodaj parametr translationLanguage do zapytania. Na przykład:

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

Parametr translationLanguage może określać język z ustawieniem lub bez niego. kraju. Na przykład „en” i „en_GB” są prawidłowe.

Jeśli podasz język tłumaczenia inny niż oryginał , system zwróci przetłumaczony tekst we właściwości text oraz oryginalny tekst we właściwości originalText. Oto przykład:

    {
      "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!"
          }
        }
      ]
    }

Odpowiadanie na opinie

Możesz też nawiązywać kontakt z użytkownikami aplikacji, odpowiadając na ich opinie. Po Gdy wyślesz odpowiedź, użytkownik otrzyma powiadomienie z informacją, że odpowiedzieli na swoją opinię.

Odradzamy stosowanie automatycznych odpowiedzi na opinie, ponieważ ma to na celu zaktualizować je później ręcznie. Chociaż możesz także odpowiedzieć na do sprawdzenia dowolną liczbę razy, użytkownik otrzyma tylko powiadomienie po pierwszej odpowiedzi na utworzoną lub zmodyfikowaną opinię. Poniżej Ta tabela ilustruje sposób powiadamiania użytkownika podczas interakcji z nim:

Interakcja użytkownika z programistą	Wysłano powiadomienie do użytkownika?
Użytkownik pisze opinię. deweloper przesyła odpowiedź	Tak
Aktualizacje dewelopera odpowiadają na pierwotną opinię	Nie
sprawdzanie aktualizacji użytkownika; odpowiedź na aktualizacje deweloperskie	Tak

Uwaga: Twoje odpowiedzi na opinie są widoczne publicznie w stronie w sklepie z aplikacjami, nie podawaj informacji poufnych o użytkownikach.

Aby przesłać odpowiedź na opinię użytkownika, użyj metody POST. W swojej prośbie wskaż, że Content-Type to application/json i dodaj kod JSON dokument zawierający Twoją odpowiedź:

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!"
}

Uwaga: pole replyText dołączone do pliku Żądanie POST może zawierać maksymalnie 350 znaków. Należy użyć zwykły tekst w odpowiedzi; prawidłowe tagi HTML są usuwane, uwzględnione w liczbie znaków odpowiedzi. publikowane przez Ciebie treści; wewnątrz prawidłowych tagów HTML.

Jeśli żądanie się powiedzie, w odpowiedzi otrzymasz poniższy ciąg znaków JSON. Element lastEdited wskazuje czas zarejestrowania odpowiedzi przez interfejs API. do opinii użytkownika.

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

Jeśli jednak żądanie POST jest nieprawidłowe, w odpowiedzi wyświetli się jeden z z tymi kodami błędów:

400 Bad Reply Request: Element replyText jest za długi lub nie ma go wcale.
404 Not Found: Opinia z danym review_id nie istnieje.

Limity

Aby ułatwić pracę innym deweloperom, interfejs Reply to Reviews API wymusza kilka limity. Te limity są egzekwowane oddzielnie w przypadku każdej aplikacji:

Prośby (GET) o pobranie list opinii i pojedynczych opinii – 200 na godzinę
POST próśb (dotyczących odpowiadania na opinie) – 2000 dziennie

Jeśli Twoja aplikacja musi pobierać więcej opinii lub odpowiadać na nie limity, wyślij prośba , aby zwiększyć limit aplikacji.