Bir comment
kaynağı, tek bir YouTube yorumuyla ilgili bilgileri içerir. comment
kaynağı, bir video veya kanal hakkındaki bir yorumu temsil edebilir. Ayrıca yorum, üst düzey bir yorum veya üst düzey bir yoruma yanıt da olabilir.
Yöntemler
API, comments
kaynakları için aşağıdaki yöntemleri destekler:
- list
- API isteği parametreleriyle eşleşen yorumların listesini döndürür. Hemen deneyin.
- ekle
- Mevcut bir yoruma yanıt oluşturur. Not: Üst düzey yorum oluşturmak için
commentThreads.insert
yöntemini kullanın. Hemen deneyin. - güncelle
- Bir yorumu değiştirir. Hemen deneyin.
- sil
- Bir yorumu siler. Hemen deneyin.
- setModerationStatus
- Bir veya daha fazla yorumun denetleme durumunu ayarlar. API isteği, yorumlarla ilişkili kanalın veya videonun sahibi tarafından yetkilendirilmelidir. Hemen deneyin.
- markAsSpam
- Not: Bu yöntem kullanımdan kaldırılmıştır ve artık desteklenmemektedir.
- Arayanın, bir veya daha fazla yorumun spam olarak işaretlenmesi gerektiği konusundaki fikrini ifade eder.
Kaynak temsili
Aşağıdaki JSON yapısı, comments
kaynağının biçimini gösterir:
{ "kind": "youtube#comment", "etag": etag, "id": string, "snippet": { "authorDisplayName": string, "authorProfileImageUrl": string, "authorChannelUrl": string, "authorChannelId": { "value": string }, "channelId": string, "textDisplay": string, "textOriginal": string, "parentId": string, "canRate": boolean, "viewerRating": string, "likeCount": unsigned integer, "moderationStatus": string, "publishedAt": datetime, "updatedAt": datetime } }
Ö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#comment olur. |
etag |
etag Bu kaynağın Etag'i. |
id |
string YouTube'un yorumu benzersiz şekilde tanımlamak için kullandığı kimlik. |
snippet |
object snippet nesnesi, yorumla ilgili temel ayrıntıları içerir. |
snippet.authorDisplayName |
string Yorumu yayınlayan kullanıcının görünen adı. |
snippet.authorProfileImageUrl |
string Yorumu yayınlayan kullanıcının avatarının URL'si. |
snippet.authorChannelUrl |
string Varsa yorumu yazan kullanıcının YouTube kanalının URL'si. |
snippet.authorChannelId |
object Bu nesne, yorumu yazan kullanıcının (varsa) YouTube kanalıyla ilgili bilgileri içerir. |
snippet.authorChannelId.value |
string Varsa yorumu yazan kullanıcının YouTube kanalının kimliği. |
snippet.channelId |
string Yorumla ilişkilendirilen YouTube kanalının kimliği. |
snippet.textDisplay |
string Yorumun metni. Metin, düz metin veya HTML olarak alınabilir. ( comments.list ve commentThreads.list yöntemlerinin her ikisi de, seçilen metin biçimini belirten textFormat parametresini destekler.)Düz metin bile orijinal yorum metninden farklı olabilir. Örneğin, video bağlantılarını video başlıklarıyla değiştirebilir. |
snippet.textOriginal |
string Yorumun ilk yayınlandığı veya son güncellendiği haliyle orijinal, işlenmemiş metni. Orijinal metin, yalnızca yorumun yazarı kimliği doğrulanmış kullanıcıya döndürülür. |
snippet.parentId |
string Üst yorumun benzersiz kimliği. Bu özellik yalnızca yorum başka bir yoruma yanıt olarak gönderilmişse ayarlanır. |
snippet.canRate |
boolean Bu ayar, geçerli izleyicinin yorumu değerlendirip değerlendiremeyeceğini ifade eder. |
snippet.viewerRating |
string İzleyicinin bu yoruma verdiği puan. Bu özellik, dislike puanlarını tanımlamaz ancak bu davranış değişebilir. Bu süre zarfında, izleyici yorumu olumlu olarak değerlendirmişse özelliğin değeri like olur. Yoruma olumsuz puan veren veya yorum yapmayan kullanıcı da dahil olmak üzere diğer tüm durumlarda değer none şeklindedir.Bu özellik için geçerli değerler şunlardır:
|
snippet.likeCount |
unsigned integer Yorumun aldığı toplam beğeni (olumlu puan) sayısı. |
snippet.moderationStatus |
string Yorumun denetleme durumu. Bu özellik, yalnızca API isteği kanalın sahibi veya istenen yorumların yapıldığı video tarafından yetkilendirildiyse döndürülür. Ayrıca, API isteği id filtre parametresini kullandıysa bu özellik ayarlanmaz.Bu mülk için geçerli değerler şunlardır:
|
snippet.publishedAt |
datetime Yorumun orijinal olarak yayınlandığı tarih ve saat. Değer, ISO 8601 biçiminde belirtilir. |
snippet.updatedAt |
datetime Yorumun en son güncellendiği tarih ve saat. Değer, ISO 8601 biçiminde belirtilir. |