CommentThreads

commentThread kaynağı, üst düzey yorumu ve varsa ilgili yoruma verilen yanıtları içeren YouTube yorum ileti dizisiyle ilgili bilgileri içerir. commentThread kaynağı bir videodaki yorumları temsil eder.

Hem üst düzey yorum hem de yanıtlar aslında commentThread kaynağının içine yerleştirilmiş comment kaynaktır. commentThread kaynağı, bir yoruma verilen tüm yanıtları içermez ve belirli bir yoruma verilen tüm yanıtları almak istiyorsanız comments.list yöntemini kullanmanız gerekir. Bazı yorumların yanıtı yok.

Yöntemler

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

list
API isteği parametreleriyle eşleşen yorum ileti dizilerinin listesini döndürür. Hemen deneyin.
ekle
Yeni bir üst düzey yorum oluşturur. Mevcut bir yoruma yanıt eklemek için comments.insert yöntemini kullanın. Hemen deneyin.

Kaynak temsili

JSON yapısı, bir commentThreads kaynağının biçimini gösterir:

{
  "kind": "youtube#commentThread",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "videoId": string,
    "topLevelComment": comments Resource,
    "canReply": boolean,
    "totalReplyCount": unsigned integer,
    "isPublic": boolean
  },
  "replies": {
    "comments": [
      comments Resource
    ]
  }
}

Ö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#commentThread olur.
etag etag
Bu kaynağın ETag'i.
id string
YouTube'un yorum dizisini benzersiz şekilde tanımlamak için kullandığı kimlik.
snippet object
snippet nesnesi, yorum ileti dizisiyle ilgili temel ayrıntıları içerir. Ayrıca, ileti dizisinin bir comment kaynağı olan üst düzey yorumunu da içerir.
snippet.channelId string
İleti dizisindeki yorumlarla ilişkili YouTube kanalı. snippet.videoId özelliği videoyu tanımlar.
snippet.videoId string
Yorumların atıfta bulunduğu videonun kimliği.
snippet.topLevelComment object
İleti dizisinin üst düzey yorumu. Özelliğin değeri bir comment kaynağı.
snippet.canReply boolean
Bu ayar, mevcut görüntüleyenin ileti dizisini yanıtlayıp yanıtlayamayacağını gösterir.
snippet.totalReplyCount unsigned integer
Üst düzey yoruma yanıt olarak gönderilen toplam yanıt sayısı.
snippet.isPublic boolean
Bu ayar, tüm yorumları ve yorum yanıtları dahil olmak üzere mesaj dizisinin tüm YouTube kullanıcılarına görünür olup olmadığını belirtir.
replies object
replies nesnesi, varsa yoruma verilen yanıtların listesini içeren bir kapsayıcıdır. replies.comments özelliği, yorum listesini temsil eder.
replies.comments[] list
Üst düzey yoruma verilen bir veya daha fazla yanıtın listesi. Listedeki her öğe bir comment kaynağıdır.

Listedeki yanıt sayısı sınırlıdır. Listedeki öğelerin sayısı snippet.totalReplyCount özelliğinin değerine eşit değilse yanıt listesi yalnızca üst düzey yorum için kullanılabilecek toplam yanıt sayısının alt kümesidir. Üst düzey yoruma ait tüm yanıtları almak için, comments.list yöntemini çağırmanız ve yanıtlarını almak istediğiniz yorumu tanımlamak üzere parentId istek parametresini kullanmanız gerekir.