CommentThreads

Bir commentThread kaynağı, bir YouTube yorum ileti dizisiyle ilgili bilgiler içerir. Üst düzey bir yorum ve yoruma verilen yanıtlar (varsa) bu ileti dizisine dahildir. commentThread kaynağı, bir videodaki yorumları temsil eder.

Hem üst düzey yorum hem de yanıtlar, commentThread kaynağının içine yerleştirilmiş comment kaynaklardır. commentThread kaynağı bir yoruma verilen tüm yanıtları içermez. Belirli bir yoruma ilişkin tüm yanıtları almak istiyorsanız comments.list yöntemini kullanmanız gerekir. Bazı yorumlara yanıt verilmedi.

Yöntemler

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

list
API istek 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

JSON yapısı, 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 en üst düzey yorumunu da içerir.
snippet.channelId string
İleti dizisindeki yorumlarla ilişkilendirilmiş 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 en üst düzey yorumu. Tesisin değeri bir comment kaynağı.
snippet.canReply boolean
Bu ayar, geçerli izleyicinin mesaj dizisine yanıt verip veremeyeceğini ifade eder.
snippet.totalReplyCount unsigned integer
Üst düzey yoruma yanıt olarak gönderilen yanıtların toplam sayısı.
snippet.isPublic boolean
Bu ayar, tüm yorumları ve yorum yanıtları da dahil olmak üzere mesaj dizisinin tüm YouTube kullanıcılarına görünür olup olmadığını ifade eder.
replies object
replies nesnesi, varsa yoruma verilen yanıtların listesini içeren bir kapsayıcıdır. replies.comments özelliği, yorum listesinin kendisini 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 öğelerin sayısı snippet.totalReplyCount özelliğinin değerine eşit olmadığı sürece, yanıt listesi yalnızca üst düzey yorum için kullanılabilen toplam yanıt sayısının 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 için parentId istek parametresini kullanmanız gerekir.