Bu sayfa, Cloud Translation API ile çevrilmiştir.

Comments

comment kaynağı, tek bir YouTube yorumuyla ilgili bilgileri içerir. comment kaynağı, bir video veya kanalla ilgili 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.
insert: 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: Yorumu siler. 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ıldı ve artık desteklenmiyor.; Arayanı, bir veya daha fazla yorumun spam olarak işaretlenmesi gerektiğine dair fikrini 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ığı 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` Yorumu yazan kullanıcının YouTube kanalının URL'si (varsa).
`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ği.
`snippet.textDisplay`	`string` Yorumun metni. Metin, düz metin veya HTML olarak alınabilir. (`comments.list` ve `commentThreads.list` yöntemleri, seçilen metin biçimini belirten bir `textFormat` parametresini destekler.) Sabit 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ıysa) 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, mevcut izleyicinin yorumu derecelendirip derecelendiremeyeceğini belirtir.
`snippet.viewerRating`	`string` İzleyicinin bu yoruma verdiği puan. Bu mülk `dislike` puanlarını tanımlamaz ancak bu davranış değişebilir. Bu sırada, izleyici yorumu olumlu olarak değerlendirdiyse mülk değeri `like` olur. Kullanıcının yoruma olumsuz puan vermesi veya yorumu puanlamaması da dahil olmak üzere diğer tüm durumlarda değer `none` olur. Bu özellik 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ği, istenen yorumların yapıldığı kanalın veya videonun sahibi tarafından yetkilendirilmişse 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 ilk 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.