Comments

comment kaynağı, tek bir YouTube yorumuyla ilgili bilgileri içerir. comment kaynağı, bir video veya kanal hakkındaki bir yorumu temsil edebilir. Ayrıca yorum, üst düzey bir yorum veya üst düzey bir yoruma cevap da olabilir.

Yöntemler

API, comments kaynakları için aşağıdaki yöntemleri destekler:

list
API isteği parametreleriyle eşleşen yorumların listesini döndürür. Hemen deneyin.
ekle
Mevcut bir yoruma yanıt oluşturur. Not: Üst düzey yorum oluşturmak için commentThreads.insert yöntemini kullanın. Hemen deneyin.
güncelle
Bir yorumu değiştirir. Hemen deneyin.
sil
Bir yorum silinir. Hemen deneyin.
setModerationStatus
Bir veya daha fazla yorumun moderasyon durumunu ayarlar. API isteği, yorumlarla ilişkili kanalın veya videonun sahibi tarafından yetkilendirilmelidir. Hemen deneyin.
markAsSpam
Not: Bu yöntem kullanımdan kaldırılmıştır ve artık desteklenmemektedir.
Arayanın, bir veya daha fazla yorumun spam olarak işaretlenmesi gerektiğine dair görüşünü ifade eder.

Kaynak temsili

Aşağıdaki JSON yapısı, bir comments kaynağının biçimini gösterir:

{
  "kind": "youtube#comment",
  "etag": etag,
  "id": string,
  "snippet": {
    "authorDisplayName": string,
    "authorProfileImageUrl": string,
    "authorChannelUrl": string,
    "authorChannelId": {
      "value": string
    },
    "channelId": string,
    "textDisplay": string,
    "textOriginal": string,
    "parentId": string,
    "canRate": boolean,
    "viewerRating": string,
    "likeCount": unsigned integer,
    "moderationStatus": string,
    "publishedAt": datetime,
    "updatedAt": datetime
  }
}

Özellikler

Aşağıdaki tabloda bu kaynakta görünen özellikler tanımlanmaktadır:

Özellikler
kind string
API kaynağının türünü tanımlar. Değer youtube#comment olacak.
etag etag
Bu kaynağın Etag'i.
id string
YouTube'un yorumu benzersiz bir şekilde tanımlamak için kullandığı kimlik.
snippet object
snippet nesnesi, yorumla ilgili temel ayrıntıları içerir.
snippet.authorDisplayName string
Yorumu yayınlayan kullanıcının görünen adı.
snippet.authorProfileImageUrl string
Yorumu yayınlayan kullanıcının avatarının URL'si.
snippet.authorChannelUrl string
Varsa yorumu yazan kullanıcının YouTube kanalının URL'si.
snippet.authorChannelId object
Bu nesne, varsa yorumu yazan kullanıcının YouTube kanalıyla ilgili bilgileri içerir.
snippet.authorChannelId.value string
Varsa yorumu yazan kullanıcının YouTube kanalının kimliğidir.
snippet.channelId string
Yorumla ilişkilendirilen YouTube kanalının kimliği.
  • Yorum bir kanal yorumuysa bu özellik, yorumun ilgili olduğu kanalı tanımlar.
snippet.textDisplay string
Yorumun metni. Metin, düz metin veya HTML olarak alınabilir. (comments.list ve commentThreads.list yöntemlerinin her ikisi de istenen metin biçimini belirten textFormat parametresini destekler.)

Düz metnin bile orijinal yorum metninden farklı olabileceğini unutmayın. Örneğin, video bağlantılarını video başlıklarıyla değiştirebilir.
snippet.textOriginal string
Yorumun ilk yayınlandığı veya son güncellendiği şekliyle orijinal, işlenmemiş metni. Orijinal metin yalnızca kimliği doğrulanmış kullanıcı tarafından erişilebiliyorsa döndürülür ve yalnızca kullanıcının yorumun yazarı olması garanti edilir.
snippet.parentId string
Üst yorumun benzersiz kimliği. Bu özellik yalnızca yorum başka bir yoruma yanıt olarak gönderilmişse ayarlanır.
snippet.canRate boolean
Bu ayar, mevcut izleyicinin yorumu derecelendirip derecelendiremeyeceğini ifade eder.
snippet.viewerRating string
İzleyicinin bu yoruma verdiği puan. Bu özelliğin şu anda dislike puanlarını tanımlamadığını unutmayın, ancak bu davranış değişebilir. Bu süre zarfında izleyici, yorumu olumlu değerlendirdiyse özelliğin değeri like olur. Değer, yoruma olumsuz puan veren veya yorumlanmayan kullanıcı da dahil olmak üzere diğer tüm durumlarda none şeklindedir.

Bu tesis için geçerli değerler şunlardır:
  • like
  • none
snippet.likeCount unsigned integer
Yorumun aldığı toplam beğeni (olumlu puan) sayısı.
snippet.moderationStatus string
Yorumun moderasyon durumu. Bu özellik, yalnızca API isteği kanalın sahibi veya istenen yorumların yapıldığı video tarafından yetkilendirildiyse döndürülür. Ayrıca, API isteği id filtre parametresini kullanıyorsa bu özelliğin ayarlanmadığını unutmayın.

Bu mülk için geçerli değerler şunlardır:
  • heldForReview
  • likelySpam
  • published
  • rejected
snippet.publishedAt datetime
Yorumun orijinal olarak yayınlandığı tarih ve saat. Değer ISO 8601 biçiminde belirtilir.
snippet.updatedAt datetime
Yorumun en son güncellendiği tarih ve saat. Değer ISO 8601 biçiminde belirtilir.