Comments

comment kaynağı, tek bir YouTube yorumuyla ilgili bilgiler içerir. comment kaynağı, bir video veya kanal hakkındaki yorumu temsil edebilir. Ayrıca yorum, üst düzey bir yorum veya üst düzey bir yoruma verilen yanıt 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.
insert
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üncelleme
bir yorumu değiştiriyor. Hemen deneyin.
sil
Yorumu siler. 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.

Kaynak temsili

Aşağıdaki JSON yapısında, comments kaynağının biçimi gösterilmektedir:

{
  "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 olur.
etag etag
Bu kaynağın ETag'i.
id string
YouTube'un yorumu benzersiz ş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
Yorumu yazan kullanıcının YouTube kanalının URL'si (varsa).
snippet.authorChannelId object
Bu nesne, yorum yazarının YouTube kanalıyla ilgili bilgileri (varsa) kapsar.
snippet.authorChannelId.value string
Yorumu yazan kullanıcının YouTube kanalının kimliği (varsa).
snippet.channelId string
Yorumla ilişkili YouTube kanalının kimliği.
snippet.textDisplay string
Yorumun metni. Metin, düz metin veya HTML olarak alınabilir. (Hem comments.list hem de commentThreads.list yöntemleri, seçilen metin biçimini belirten bir textFormat parametresini destekler.)

Düz metin bile orijinal yorum metninden farklı olabilir. Ö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, ham metni. Orijinal metin, yalnızca yorumun yazarı olan kimliği doğrulanmış kullanıcıya döndürülür.
snippet.parentId string
Üst yorumun benzersiz kimliği. Bu özellik yalnızca yorum başka bir yoruma yanıt olarak gönderildiyse ayarlanır.
snippet.canRate boolean
Bu ayar, mevcut görüntüleyenin yorumu derecelendirip derecelendiremeyeceğini gösterir.
snippet.viewerRating string
İzleyicinin bu yoruma verdiği puan. Bu özellik, dislike puanlarını tanımlamaz ancak bu davranış değişebilir. Bu süre zarfında, izleyici yorumu olumlu olarak değerlendirmişse mülk değeri like olur. Değer, kullanıcının yoruma olumsuz puan verdiği veya yorumu puanlamadığı durumlar da dahil olmak üzere diğer tüm durumlarda none olur.

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

Bu özelliğin geçerli değerleri şunlardır:
  • heldForReview
  • likelySpam
  • published
  • rejected
snippet.publishedAt datetime
Yorumun ilk yayınlandığı tarih ve saat. Değer, ISO 8601 biçiminde belirtilir.
snippet.updatedAt datetime
Yorumun son güncellendiği tarih ve saat. Değer, ISO 8601 biçiminde belirtilir.