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. |