Videos: rate

Videolara beğenme veya beğenmeme puanı ekleyebilir ya da videolardan puan kaldırabilirsiniz.

Kota etkisi: Bu yönteme yapılan bir çağrının kota maliyeti 50 birimdir.

NOT: Bu işlem, videonun resmi beğenme/beğenmeme sayısını etkilemez.

Yaygın kullanım alanları

İstek

HTTP isteği

POST https://www.googleapis.com/youtube/v3/videos/rate

Yetkilendirme

Bu istek, aşağıdaki kapsamlardan en az biriyle yetkilendirme gerektirir (kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinin).

Kapsam
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parametreler

Aşağıdaki tabloda, bu sorgunun desteklediği parametreler listelenmiştir. Listelenen tüm parametreler sorgu parametreleridir.

Parametreler
Gerekli parametreler
id string
id parametresi, derecelendirilen veya derecelendirmesi kaldırılan videonun YouTube video kimliğini belirtir.
rating string
Kaydedilecek derecelendirmeyi belirtir.

Kabul edilebilir değerler:
  • dislike: Kimliği doğrulanmış kullanıcının videoyu beğenmediğini kaydeder.
  • like: Kimliği doğrulanmış kullanıcının videoyu beğendiğini kaydeder.
  • none: Kimliği doğrulanmış kullanıcının video için daha önce belirlediği tüm puanları kaldırır.

İstek metni

Bu yöntemi çağırırken istek gövdesi sağlamayın.

Yanıt

Başarılı olursa bu yöntem bir HTTP 204 yanıt kodu (No Content) döndürür.

Hatalar

Aşağıdaki tabloda, API'nin bu yönteme yapılan bir çağrıya yanıt olarak döndürebileceği hata mesajları tanımlanmaktadır. Daha fazla bilgi için lütfen hata mesajı belgelerine bakın.

Hata türü Hata ayrıntısı Açıklama
badRequest (400) emailNotVerified Kullanıcı, puan vermeden önce e-posta adresini doğrulamalıdır.
badRequest (400) invalidRating İstek, rating parametresi için beklenmeyen bir değer içeriyordu.
badRequest (400) videoPurchaseRequired Kiralık videolar yalnızca kiralayan kullanıcılar tarafından değerlendirilebilir.
forbidden (403) forbidden Derecelendirmeye çalıştığınız video derecelendirilemiyor. İstek düzgün şekilde yetkilendirilmemiş olabilir.
forbidden (403) videoRatingDisabled Puan vermeye çalıştığınız videonun sahibi, bu videonun puanlarını devre dışı bırakmış olabilir.
notFound (404) videoNotFound Değerlendirmeye çalıştığınız video bulunamıyor. İsteğin id parametresinin değerini kontrol ederek doğru olduğundan emin olun.

Deneyin.

Bu API'yi çağırmak ve API isteğini ve yanıtını görmek için APIs Explorer simgesini kullanın.