Kullanıcı İncelemeleri - Listeyi Almak (Steamworks Belgeleri)

Steamworks Belgeleri

Kullanıcı İncelemeleri - Listeyi Almak

Steamworks Belgeleri > Mağaza Görünümü > Kullanıcı İncelemeleri - Listeyi Almak

Eğer Steam'de bir uygulama için incelemeleri toplu olarak almak istiyorsanız, belirtilen parametrelerle aşağıdaki yöntemi kullanabilirsiniz.

Parametreler:

GET store.steampowered.com/appreviews/<appid>?json=1

İsim	Tür	Gerekli	Açıklama
filter	string	✔	recent - oluşturulma zamanına göre sıralanmış updated - son güncelleme zamanına göre sıralanmış all - (varsayılan) faydalılığa göre sıralanmış, day_range parametresine göre kaydırmalı pencere olarak, her zaman sonuçları döndürecektir. İncelemeleri `imleçle` görüntülüyorsanız, nihayetinde boş bir yanıt listesi almak için en son seçeneği veya güncellenmiş seçeneği kullanın.
language	string	✔	https://partner.steamgames.com/documentation/languages adresine gidin (ve API dil kodu listesini kulanın) veya bütün incelemeler için "all" olarak geçin.
day_range	string	✔	n gün önceden şimdiye kadar olan bütün faydalı incelemelere bakmak içindir. Sadece “all” filtresi için geçerlidir. Azami değer 365'tir.
cursor	string	✔	incelemeler 20'şer 20'şer döndürüldüğünden, ilk set için "*" karakterini aktarın, ardından yanıtta döndürülen "cursor" değerini bir sonraki set için kullanın. Bu işlemi her set için tekrar edin. ''cursor'' değerleri, sorgu dizesinde kullanılabilmesi için URL ile kodlanmayı gerektiren karakterler içerebilir.
review_type	string	✔	all – bütün incelemeler (varsayılan) positive – sadece olumlu incelemeler negative – sadece olumsuz incelemeler
purchase_type	string	✔	all – bütün incelemeler non_steam_purchase – Steam üzerinde ürün için para vermemiş kullanıcılar tarafından yazılmış incelemeler steam – Steam üzerinde ürün için para vermiş kullanıcılar tarafından yazılmış incelemeler (varsayılan)
num_per_page	string	✔	varsayılan olarak en fazla 20 inceleme döndürülür. Bu parametre temel alınarak daha fazla inceleme de döndürülebilir (en fazla 100 inceleme).
filter_offtopic_activity	number		Varsayılan olarak, konu dışı incelemeler (diğer adıyla "İnceleme Bombardımanları") filtrelenir ve bu API'da döndürülmez. Dâhil etmek için 0 girin. Buraya göz atın.

Dönüşler

Parametrelere uyan ve bilgi alanları içeren JSON olarak biçimlendirilmiş incelemeler listesi. JSON'daki dizeler kaçış dizileri (escape sequences) içerebileceğinden, kullanmadan önce yanıttaki verilerde bulunan kaçışların iptal edilmesi gerekebilir.

Yanıt:

success - Sorgu başarılı ise 1.
query_summary - İlk istekle döndürülür.
- num_reviews - Bu yanıtta döndürülen incelemelerin sayısı.
- review_score - İnceleme skoru.
- review_score_desc - İnceleme skorunun açıklaması.
- total_positive - Toplam olumlu inceleme sayısı.
- total_negative - Toplam olumsuz inceleme sayısı.
- total_reviews - Sorgu parametrelerine uyan toplam inceleme sayısı.
cursor - Bir sonraki incelemeleri almak için bir sonraki isteğe cursor olarak aktarılacak değer.
reviews
- recommendationid - Tavsiyenin özgün ID'si.
- author
  - steamid - Kullanıcının SteamID'si.
  - num_games_owned - Kullanıcının sahip olduğu oyun sayısı.
  - num_reviews - Kullanıcı tarafından yazılmış inceleme sayısı.
  - playtime_forever - Bu uygulamada kaydedilen toplam oynama süresi.
  - playtime_last_two_weeks - Bu uygulamada son iki haftada kaydedilen oynama süresi
  - playtime_at_review - İnceleme yazıldığında kaydedilmiş olan oynama süresi.
  - last_played - Kullanıcının bu uygulamayı başlattığı en son tarih.
- language - Kullanıcının incelemeyi yazarken belirttiği dil.
- review - İnceleme metni.
- timestamp_created - İncelemenin oluşturulduğu tarih (UNIX zaman damgası).
- timestamp_updated - İncelemenin son güncellendiği tarih (UNIX zaman damgası).
- voted_up - true, bunun olumlu bir tavsiye olduğunu gösterir.
- votes_up - Bu incelemeyi faydalı bulan kullanıcıların sayısı.
- votes_funny - Bu incelemeyi komik bulan kullanıcıların sayısı.
- weighted_vote_score - İncelemenin faydalılık skoru.
- comment_count - İncelemedeki toplam yorum sayısı.
- steam_purchase - Kullanıcı oyunu Steam'den satın almışsa true.
- received_for_free - Kullanıcı, uygulamayı ücretsiz aldığını belirten kutucuğu işaretlemişse true.
- written_during_early_access - Kullanıcı bu incelemeyi oyun Erken Erişim'deyken yazmışsa true.
- developer_response - Varsa, geliştirici yanıtının metni.
- timestamp_dev_responded - Varsa, geliştiricinin yanıt verdiği tarihin UNIX zaman damgası.