CommentThreads

commentThread kaynağı, YouTube yorum ileti dizisi hakkında bilgiler içerir. Bu ileti dizisi, üst düzey bir yorumdan ve varsa söz konusu yoruma verilen yanıtlardan oluşur. commentThread kaynağı, bir video veya kanalla ilgili yorumları temsil edebilir.

Hem üst düzey yorum hem de yanıtlar, commentThread kaynağının içine yerleştirilmiş comment kaynaktır. Bir yoruma verilen tüm yanıtlar commentThread kaynağında yer almayabilir. Belirli bir yoruma verilen tüm yanıtları almak istiyorsanız comments.list yöntemini kullanmanız gerekir. Ayrıca bazı yorumlarda yanıt olmadığını unutmayın.

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 bunun yerine comments.insert yöntemini kullanın. Hemen deneyin.

Kaynak temsili

Aşağıdaki 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 olacak.
etag etag
Bu kaynağın Etag'i.
id string
YouTube'un yorum ileti dizisini benzersiz şekilde tanımlamak için kullandığı kimlik.
snippet object
snippet nesnesi, yorum dizisiyle ilgili temel ayrıntıları içerir. Ayrıca, ileti dizisinin en üst düzey yorumunu (bir comment kaynağı) içerir.
snippet.channelId string
İleti dizisindeki yorumlarla ilişkilendirilmiş YouTube kanalı. (snippet.videoId özelliği, videoyu tanımlar.)
  • Yorumlar bir videoyla ilgiliyse değer, videoyu yükleyen kanalı tanımlar. (snippet.videoId özelliği, videoyu tanımlar.)
  • Yorumlar kanalın kendisiyle ilgiliyse snippet.videoId özelliğinin bir değeri olmaz.
snippet.videoId string
Yorumlarda kullanılan videonun kimliği (varsa). Bu özellik mevcut değilse veya bir değer içermiyorsa ileti dizisi belirli bir videoya değil, kanala uygulanır.
snippet.topLevelComment object
Mesaj dizisinin en üst düzey yorumu. Mülkün değeri bir comment kaynağıdır.
snippet.canReply boolean
Bu ayar, mevcut izleyicinin mesaj dizisine yanıt verip veremeyeceğini 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ı gösterir.
replies object
replies nesnesi, varsa yoruma verilen yanıtların listesini içeren bir kapsayıcıdır. replies.comments özelliği yorumların 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.

Listede sınırlı sayıda yanıt bulunur. Listedeki öğe sayısı snippet.totalReplyCount özelliğinin değerine eşit olmadığı sürece yanıt listesi, en üst düzey yorum için kullanılabilen toplam yanıt sayısının yalnızca bir alt kümesidir. Üst düzey yorumun tüm yanıtlarını 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.