Yorumları Yanıtlama

Google Play Developer Reply to Reviews API'si kullanıcı geri bildirimlerini görüntülemenizi sağlar ve bu geri bildirimi yanıtlayın. Bu API'yi kullanarak CRM gibi mevcut müşteri desteği araç setinizden bahsedeceğim.

Reply to Reviews API, yalnızca üretim ile ilgili geri bildirimlere erişmenizi sağlar. sürümleri de ekleyebilirsiniz. Uygulamanızın alfa veya beta sürümleriyle ilgili geri bildirim uygulamanızdan yararlanmak için Google Play Console'u kullanın. Ayrıca, API'nin yalnızca yorum içeren yorumları gösterir. Bir kullanıcı uygulamanızı derecelendirirse bu kullanıcıların geri bildirimlerine API'den erişilemez.

Erişim Kazanma

Reply to Reviews API ile çalışmak için OAuth istemcisi veya hizmet hesabı. Bir hizmet hesabı kullanıyorsanız "Yorumları yanıtla" bu hesapta oturum açma izni vermiş olursunuz. Daha fazla bilgi için API'ye yetkili erişim sağlanmasını daha kolay API Erişim İstemcilerini Ayarlama.

Yorumları Alma

Reply to Reviews API'yi kullanırken son yorumlarınızın tümünün veya ayrı bir yorum görebilirsiniz.

Bir dizi yorum alma

Uygulamanızla ilgili yorumların listesini istemek için GET yöntemini kullanın. İsteğinizde, uygulamanızın tam paket adını içermelidir (örneğin, com.google.android.apps.maps ve API'ye erişim elde etme.

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

Yanıt, uygulamanızla ilgili yorumların listesini içeren bir JSON dizesidir. İlgili içeriği oluşturmak için kullanılan listedeki ilk sonuç, en son oluşturulan kullanıcı yorumunu gösterir söz konusu olabilir.

Aşağıdaki örnekte ilk yorumda, sonuç ise, ikinci incelemede yalnızca bazı sonuçlarda görünen meta veriler gösterilmektedir:

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

Her sonuçta aşağıdaki meta veriler bulunur:

reviewId
Bu yorumu benzersiz olarak tanımlar. Ayrıca belirli bir kullanıcının çünkü kullanıcılar belirli bir uygulama için sadece tek bir yorum yazabiliyor.
authorName

Yorumu yazan kullanıcının adı.

Not: Nadir durumlarda, authorName belirli bir sonuçta görünmez.

yorumlar

Kullanıcının uygulama hakkındaki geri bildirimlerini içeren bir liste. Bu yorum bir başlık içeriyorsa, hem bu başlık hem de yorumun gövde metni görünür text öğesinde yer alıyor. Sekme karakteri, başlık ile gövde metnini ayırıyor. lastModified öğesi, kullanıcının en son hangi zamanı ziyaret ettiğini gösterir incelemesini gönderdi.

Bu incelemeye zaten yanıt verdiyseniz geri bildiriminiz ikinci öğesi olarak görünür.

starRating

Kullanıcının uygulamanızla ilgili 1 ile 5 arası bir ölçekte yaptığı değerlendirme. 5 puan kullanıcının uygulamanızdan çok memnun olduğunu gösterir.

Varsayılan olarak her sayfada 10 yorum gösterilir. En fazla 100 yorum gösterebilirsiniz maxResults parametresini ayarlayarak her sayfa için ayrı bir değer belirleyebilirsiniz.

Yorum listesi başka bir sayfada devam ederse API, Yanıtta tokenPagination öğesi var. Şu sayfanın sonraki sayfası istenirken: token öğesini ekleyin. Bu öğenin değerini Orijinal yanıtta görünen nextPageToken değeri.

Not: Yalnızca kullanıcıların oluşturduğu yorumları alabilirsiniz. veya son bir hafta içinde değiştirilmiş olmalıdır. Sitenizin tüm yorumlarını almak istiyorsanız uygulamayı indirdikten sonra indirebilirsiniz. Google Play Console'u kullanarak yorumlarınızı CSV dosyası olarak oluşturabilirsiniz.

Aşağıdaki GET isteği örneğinde, yorumların sonraki sayfası gösterilir. Bu isteği, yorumların geçerli sayfasının ( önceki istek) "12334566" nextPageToken değerini içeriyor. İlgili içeriği oluşturmak için kullanılan isteği, sonraki sayfada en fazla 50 incelemenin gösterileceğini de belirtir.

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

Tek yorum alma

Tek bir yorumu almak için GET yöntemini de kullanabilirsiniz. Sizin sağlayacaklarınız için kullanılan URL ile aynı URL bir dizi yorum almak ayrıca, görmek istediğiniz yoruma karşılık gelen review_id öğesini de ekleyin:

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

Karşılık gelen yanıt, içerik ve meta veri barındıran bir JSON dizesidir tek bir yorum için:

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

Yorum Metnini Çevirme

İnceleme metni, şuradan döndürülmeden önce otomatik olarak çevrilebilir: yorumlar API'si. Yorum listesi veya tek bir yorum alırken translationLanguage parametresi eklemeniz gerekir. Örneğin:

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

translationLanguage parametresi, dili içeren veya içermeyen bir dil belirtebilir ülke. Örneğin, hem "en" ve "en_GB" geçerlidir.

Orijinal dilden farklı bir çeviri dili belirtirseniz metin olduğunda, sistem text özelliğinde çevrilen metni ve originalText özelliğinde orijinal metin. Aşağıda bununla ilgili bir örnek verilmiştir:

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

Yorumları Yanıtlama

Ayrıca, kullanıcıların yorumlarına yanıt vererek uygulama kullanıcılarıyla etkileşimde bulunabilirsiniz. Şu tarihten sonra: yanıtınızı gönderdiğinizde, kullanıcı bir bildirim aldığını ve Google'ın adlı kullanıcı geri bildirimine yanıt verdi.

Yorumlara otomatik yanıt kullanılmasını şu nedenle önermiyoruz: daha sonra manuel olarak güncellemeniz gerekir. Ayrıca, Yeşil Ofis’teki kullanıcı bir bildirim alırsa kullanıcıya yalnızca bir bildirim gönderilir Oluşturulan veya değiştirilen bir yoruma ilk yanıt vermenizden sonra. Aşağıdakiler Tablo, kullanıcıyla etkileşimleriniz sırasında kullanıcıya nasıl bilgi verildiğini gösterir:

Kullanıcı-Geliştirici Etkileşimi Kullanıcıya Bildirim Gönderildi mi?
Kullanıcı yorum yazar; geliştirici yanıt gönderir Evet
Geliştirici güncellemeleri orijinal yoruma yanıt veriyor Hayır
Kullanıcı güncellemeleri incelemesi; geliştirici güncellemelerinin yanıtı Evet

Not: Yorumlara verdiğiniz yanıtlar uygulama mağazasına giriş yapmadan, hassas bilgileri eklememeli kullanıcılarla ilgili daha fazla bilgi edinin.

Kullanıcı yorumlarına yanıt göndermek için POST yöntemini kullanın. İsteğinizde, Content-Type öğesinin application/json olduğunu belirtin ve bir JSON ekleyin yanıtınızı içeren doküman:

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

Not: replyText POST isteği en fazla 350 karakter içerebilir. Hangi tür stratejilerin yanıtınızda düz metin; iyi biçimlendirilmiş HTML etiketleri kaldırılır ve yanıtınızın karakter sayısına eklenir. Yerleştirdiğiniz içerik gibi korunduğundan emin olun.

İsteğiniz başarılı olursa yanıt olarak aşağıdaki JSON dizesini alırsınız. lastEdited öğesi, API'nin yanıtınızı kaydettiği zamanı gösterir ekler.

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

Ancak POST isteğiniz geçersizse yanıtta şu hata kodlarını kullanın:

400 Bad Reply Request
replyText çok uzun veya eksik.
404 Not Found
Belirtilen review_id öğesine sahip yorum mevcut değil.

Kotalar

Diğer geliştiricileri de düşünerek Reply to Reviews API API'de bazı kotalar. Bu kotalar uygulama bazında ayrı ayrı uygulanır:

  • GET istekleri (yorum listelerini ve bağımsız yorumları almak için) – 200 /saat

  • POST istek (yorumlara yanıt vermek için) – günde 2.000 istek

Uygulamanızın bunlardan daha yüksek sayıda yorum alması veya yanıtlaması gerekiyorsa kotalar izin verdiğinden, kolayca talep edin ve uygulamanızın kotasını artırın.