Comments

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 verilen yanıt olabilir.

Yöntemler

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

list
API istek 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 yorum silinir. Hemen deneyin.
setModerationStatus
Bir veya daha fazla yorumun moderasyon durumunu belirler. 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 uygun değildir desteklenir.
ziyaret edin.
Arayanın bir veya daha fazla yorumun spam olarak işaretlenmesi gerektiği görüşünü ifade eder.

Kaynak temsili

Aşağıdaki JSON yapısında, comments kaynağının biçimi gösterilmektedir:

{
  "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 değeri.
id
string YouTube'un yorumu benzersiz şekilde tanımlamak için kullandığı kimliktir.
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 Yorumu yazan kullanıcının YouTube kanalının (varsa) URL'si.
snippet.authorChannelId object
Bu nesne, yorum yazarı varsa YouTube kanalıyla ilgili bilgileri kapsar.
snippet.authorChannelId.value string
Yorumu yazan kullanıcının YouTube kanalının kimliği (varsa).
snippet.channelId
string Yorumla ilişkili YouTube kanalının kimliğidir.
snippet.textDisplay string
Yorumun metni. Metin, düz metin veya HTML olarak alınabilir. (Hem comments.list hem de commentThreads.list yöntemleri, 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, ham metni. Orijinal metin, yalnızca kimliği doğrulanmış kullanıcıya (yorum yazarı) 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 görüntüleyenin yoruma puan verip veremeyeceğini gösterir.
snippet.viewerRating string
İzleyicinin bu yoruma verdiği puan. Bu özellik, dislike puanlarını tanımlamaz ancak bu davranış değişebilir. İzleyicinin yorumu olumlu değerlendirdiği durumlarda özellik değeri like olur. Bu değer, kullanıcının yoruma olumsuz puan vermiş veya yoruma oy vermemiş olması dahil diğer tüm durumlarda none şeklindedir.

Bu tesis için geçerli değerler şunlardır:
  • like
  • none
snippet.likeCount unsigned integer
Yorumun aldığı toplam beğeni (olumlu puan) sayısı.
snippet.moderationStatus string
Yorumun moderasyon durumu. Bu özellik yalnızca API isteğinin, kanalın veya istenen yorumların yapıldığı videonun sahibi tarafından yetkilendirilmesi durumunda döndürülür. Ayrıca, API isteği id filtre parametresini kullandıysa bu özellik ayarlanmaz.

Bu özellik için geçerli değerler şunlardır:
  • heldForReview
  • likelySpam
  • published
  • rejected
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.