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