LiveChatMessages

liveChatMessage kaynağı, YouTube canlı sohbetindeki bir sohbet mesajını temsil eder. Kaynak, yeni yayınlanan bir kısa mesaj veya destek etkinliği gibi çeşitli mesaj türleriyle ilgili ayrıntılar içerebilir.

Canlı sohbet özelliği, canlı yayınlarda varsayılan olarak etkindir ve canlı etkinlik devam ederken kullanılabilir. (Etkinlik bittikten sonra canlı sohbet özelliği kullanılamaz.)

Yöntemler

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

list
Belirli bir sohbetin canlı sohbet mesajlarını listeler. Hemen deneyin.
streamList
Belirli bir sohbette canlı sohbet mesajlarını düşük gecikmeyle almak için sunucu akışı bağlantısını etkinleştirir. Hemen deneyin.
insert
Canlı sohbete mesaj veya anket ekler. Hemen deneyin.
transition
Canlı mesajın durumunu değiştirir. Hemen deneyin.
sil
Sohbet mesajını siler. API isteği, kanal sahibi veya canlı sohbet moderatörü tarafından yetkilendirilmelidir. Hemen deneyin.

Kaynak temsili

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

{
  "kind": "youtube#liveChatMessage",
  "etag": etag,
  "id": string,
  "snippet": {
    "type": string,
    "liveChatId": string,
    "authorChannelId": string,
    "publishedAt": datetime,
    "hasDisplayContent": boolean,
    "displayMessage": string,
    "fanFundingEventDetails": {
      "amountMicros": unsigned long,
      "currency": string,
      "amountDisplayString": string,
      "userComment": string
    },
    "textMessageDetails": {
      "messageText": string
    },
    "messageDeletedDetails": {
      "deletedMessageId": string
    },
    "userBannedDetails": {
      "bannedUserDetails": {
        "channelId": string,
        "channelUrl": string,
        "displayName": string,
        "profileImageUrl": string
      },
      "banType": string,
      "banDurationSeconds": unsigned long
    },
    "memberMilestoneChatDetails": {
      "userComment": string,
      "memberMonth": unsigned integer,
      "memberLevelName": string
    },
    "newSponsorDetails": {
      "memberLevelName": string,
      "isUpgrade": bool
    },
    "superChatDetails": {
      "amountMicros": unsigned long,
      "currency": string,
      "amountDisplayString": string,
      "userComment": string,
      "tier": unsigned integer
    },
    "superStickerDetails": {
      "superStickerMetadata": {
        "stickerId": string,
        "altText": string,
        "language": string
      },
      "amountMicros": unsigned long,
      "currency": string,
      "amountDisplayString": string,
      "tier": unsigned integer
    },
    "pollDetails": {
      "metadata": {
        "options": {
          "optionText": string,
          "tally": string,
        },
        "questionText": string,
        "status": enum
      },
    },
    "membershipGiftingDetails": {
      "giftMembershipsCount": integer,
      "giftMembershipsLevelName": string
    },
    "giftMembershipReceivedDetails": {
      "memberLevelName": string,
      "gifterChannelId": string,
      "associatedMembershipGiftingMessageId": string
    },
  
  },
  "authorDetails": {
    "channelId": string,
    "channelUrl": string,
    "displayName": string,
    "profileImageUrl": string,
    "isVerified": boolean,
    "isChatOwner": boolean,
    "isChatSponsor": boolean,
    "isChatModerator": boolean
  },
}

Ö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#liveChatMessage olur.
etag etag
Bu kaynağın ETag'i.
id string
YouTube'un iletiyi benzersiz şekilde tanımlamak için atadığı kimlik.
snippet object
snippet nesnesi, sohbet mesajıyla ilgili temel ayrıntıları içerir.
snippet.type string
Mesajın türü. Bu özellik her zaman mevcuttur ve değeri, kaynakta hangi alanların bulunduğunu belirler.

Bu özelliğin geçerli değerleri şunlardır:
  • chatEndedEvent: Sohbet sona erdi ve bundan sonra başka mesaj eklenemez. Bu işlem, yayın sona erdikten kısa bir süre sonra otomatik olarak gerçekleşir. Bu tür mesajlar, bir kanalın varsayılan yayınındaki canlı sohbetler için gönderilmez.
  • messageDeletedEvent – Bir mesaj, moderatör tarafından silindi. author alanında moderatörün bilgileri yer alır. Bu etkinliğin gösterilecek içeriği yok.
  • sponsorOnlyModeEndedEvent – Sohbet artık yalnızca sponsorlara özel modda değil. Bu nedenle, sponsor olmayan kullanıcılar da mesaj gönderebiliyor. Bu etkinliğin gösterilecek içeriği yok.
  • sponsorOnlyModeStartedEvent: Sohbet, yalnızca sponsorların mesaj gönderebileceği sponsorlara özel moda girmiştir. Bu etkinliğin gösterilecek içeriği yok.
  • newSponsorEvent – Yeni bir kullanıcı, canlı sohbetin sahibi olan kanala sponsor oldu. author alanları, yeni sponsora ait ayrıntıları içerir.
  • memberMilestoneChatEvent: Bir kullanıcı Üye Dönüm Noktası Mesajı gönderdiğinde
  • superChatEvent: Bir kullanıcı Super Chat satın aldı.
  • superStickerEvent: Bir kullanıcı Super Sticker satın aldı.
  • textMessageEvent: Kullanıcı kısa mesaj gönderdiğinde.
  • tombstone: Mezar taşı, bu kimliğe ve yayınlanma zamanına sahip bir mesajın daha önce var olduğunu ancak daha sonra silindiğini gösterir. Bu ileti, silinen iletinin yerine gönderilmez. Bunun yerine, silinmeden önce iletinin bulunduğu yeri belirtmek için gösterilir. Bu tür mesajlarda yalnızca snippet.liveChatId, snippet.type ve snippet.publishedAt alanları bulunur.
  • userBannedEvent: Bir kullanıcı, moderatör tarafından yasaklanmıştır. author alanında moderatörün bilgileri yer alır.
  • membershipGiftingEvent: Bir kullanıcı, diğer izleyiciler için üyelik satın aldı.
  • giftMembershipReceivedEvent: Bir kullanıcıya üyelik hediye edildiğinde
  • pollDetails: Bir kullanıcı canlı anket oluşturdu.
snippet.liveChatId string
İletinin ilişkilendirildiği canlı sohbeti benzersiz şekilde tanımlayan kimlik. Bir yayınla ilişkili canlı sohbet kimliği, liveBroadcast kaynağının snippet.liveChatId özelliğinde döndürülür.
snippet.authorChannelId string
İletiyi yazan kullanıcının kimliği. Bu alan yalnızca aşağıdaki mesaj türleri için doldurulur:
  • İleti türü textMessageEvent ise özellik değeri, iletiyi yazan kullanıcıyı tanımlar.
  • İleti türü fanFundingEvent ise özellik değeri, yayını finanse eden kullanıcıyı tanımlar.
  • İleti türü messageDeletedEvent ise özellik değeri, iletiyi silen moderatörü tanımlar.
  • Mesaj türü newSponsorEvent ise özellik değeri, yeni sponsor olan kullanıcıyı tanımlar.
  • İleti türü memberMilestoneChatEvent ise özellik değeri, iletiyi gönderen üyeyi tanımlar.
  • Mesaj türü userBannedEvent ise özellik değeri, kullanıcıyı yasaklayan moderatörü tanımlar.
  • Mesaj türü membershipGiftingEvent ise mülk değeri, üyelik hediye etme satın alma işlemini yapan kullanıcıyı tanımlar.
  • İleti türü giftMembershipReceivedEvent ise mülk değeri, hediye üyeliği alan kullanıcıyı tanımlar.
  • Mesaj türü pollEvent ise özellik değeri, canlı anket oluşturan kullanıcıyı tanımlar.
snippet.publishedAt datetime
İletinin ilk yayınlandığı tarih ve saat. Değer, ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) biçiminde belirtilir.
snippet.hasDisplayContent boolean
İletinin, kullanıcılara gösterilmesi gereken görüntüleme içeriğine sahip olup olmadığını belirtir.
snippet.displayMessage string
Kullanıcılara gösterilen bir dize içerir. İleti türü chatEndedEvent veya tombstone ise bu alan mevcut değildir.
snippet.fanFundingEventDetails object
Not: Bu nesnenin ve alt mülklerinin desteği sonlandırıldı. 28 Şubat 2017'den itibaren liveChatMessage kaynakları, Fan Funding etkinlikleriyle ilgili ayrıntıları döndürmeyecek.

Bu nesne, bağış etkinliğiyle ilgili ayrıntıları içerir. Yalnızca mesaj türü fanFundingEvent ise bulunur.
snippet.fanFundingEventDetails.amountMicros unsigned long
Not: Bu özelliğin desteği sonlandırıldı.

Fonun tutarı.
snippet.fanFundingEventDetails.currency string
Not: Bu özelliğin desteği sonlandırıldı.

Fonun oluşturulduğu para birimi.
snippet.fanFundingEventDetails.amountDisplayString string
Not: Bu özellik kullanımdan kaldırılmıştır.

Fon tutarını ve para birimini kullanıcıya gösteren oluşturulmuş bir dize.
snippet.fanFundingEventDetails.userComment string
Not: Bu özellik kullanımdan kaldırılmıştır.

Kullanıcının bu destek etkinliğine eklediği yorum.
snippet.textMessageDetails object
Bu nesne, kısa mesajla ilgili ayrıntıları içerir. Yalnızca mesaj türü textMessageEvent ise bulunur.
snippet.textMessageDetails.messageText string
Kullanıcının mesajı.
snippet.messageDeletedDetails object
Bu nesne, bir sohbet moderatörü veya canlı yayın kanalının sahibi tarafından silinen bir mesajla ilgili ayrıntılar içerir. Yalnızca mesaj türü messageDeletedEvent ise bulunur.
snippet.messageDeletedDetails.deletedMessageId string
Silinen iletiyi benzersiz şekilde tanımlayan kimlik. Değer, orijinal kısa mesajın id özellik değeriyle aynıdır. Örneğin, bir textMessageEvent öğesinin id özellik değeri 123 ise ve bu ileti daha sonra silinirse bu ileti için snippet.messageDeletedDetails.deletedMessageId değeri 123 olur.

Sohbet iletilerini aldıktan sonra önbelleğe alırsanız artık gösterilmemesi gereken iletiyi belirlemek için bu özelliğin değerini kullanın.
snippet.userBannedDetails object
Bu nesne, sohbetten yasaklanan bir kullanıcıyla ilgili ayrıntıları içerir. Ayrıca, yasakla ilgili ayrıntılar da yer alır. Kullanıcılar, sohbetlerden kalıcı veya geçici olarak yasaklanabilir.
snippet.userBannedDetails.bannedUserDetails object
Bu nesne, yasaklanan kullanıcıyla ilgili bilgiler içerir.
snippet.userBannedDetails.bannedUserDetails.channelId string
Yasaklanan kullanıcının YouTube kanal kimliği.
snippet.userBannedDetails.bannedUserDetails.channelUrl string
Yasaklanan kullanıcının YouTube kanalının URL'si.
snippet.userBannedDetails.bannedUserDetails.displayName string
Yasaklanan kullanıcının YouTube kanalının görünen adı.
snippet.userBannedDetails.bannedUserDetails.profileImageUrl string
Yasaklanan kullanıcının YouTube kanalının avatarı.
snippet.userBannedDetails.banType string
Yasak türü. Bu özellik için geçerli değerler şunlardır:
  • kalıcı
  • geçici
snippet.userBannedDetails.banDurationSeconds unsigned long
Yasak süresi. Bu özellik yalnızca snippet.userBannedDetails.banType özelliğinin değeri temporary ise bulunur.
snippet.memberMilestoneChatDetails object
Bu nesne, üye dönüm noktası etkinliği ile ilgili ayrıntıları içerir. Yalnızca mesaj türü memberMilestoneChatEvent ise bulunur.
snippet.memberMilestoneChatDetails.userComment string
Üyenin bu üye dönüm noktası mesajına eklediği yorum. Bu alan, üyenin yorumu olmayan iletiler için boştur.
snippet.memberMilestoneChatDetails.memberMonth unsigned integer
İzleyicinin, bu üye dönüm noktası mesajını almasını sağlayan üyeliğinin toplam süresi (yukarı yuvarlanmış). Bu süre, YouTube kullanıcılarına gösterilen süreyle aynıdır.
snippet.memberMilestoneChatDetails.memberLevelName string
İzleyicinin üyesi olduğu seviyenin adı. Seviye adları, üyeliği sunan YouTube kanalı tarafından belirlenir. Bazı durumlarda bu alan doldurulmaz.
snippet.newSponsorDetails object
Bu nesne, yeni üye duyurusu etkinliğiyle ilgili ayrıntıları içerir. Bu yalnızca tür newSponsorEvent ise ayarlanır. "Üye", "sponsor" teriminin karşılığıdır.
snippet.newSponsorDetails.memberLevelName string
İzleyicinin üyesi olduğu seviyenin adı. Seviye adları, üyeliği sunan YouTube kanalı tarafından belirlenir. Bazı durumlarda bu alan doldurulmaz.
snippet.newSponsorDetails.isUpgrade bool
İzleyicinin kısa süre önce daha düşük bir seviyeden yükselip yükselmediğini gösterir. Satın alma işlemi sırasında üye olmayan izleyiciler için alan değeri false olur.
snippet.superChatDetails object
Bu nesne, Super Chat etkinliğiyle ilgili ayrıntıları içerir. Yalnızca mesaj türü superChatEvent ise bulunur.
snippet.superChatDetails.amountMicros unsigned long
Satın alma para biriminin mikro cinsinden satın alma tutarı. Örneğin, satın alma tutarı bir dolarsa snippet.amountMicros özelliği değeri 1000000 olur.
snippet.superChatDetails.currency string
Satın alma işleminin yapıldığı para birimi. Değer, ISO 4217 para birimi kodudur.
snippet.superChatDetails.amountDisplayString string
Satın alma tutarını ve para birimini içeren $1.00 gibi bir dize. Dizenin kullanıcıya gösterilmesi amaçlanmıştır.
snippet.superChatDetails.userComment string
Kullanıcının bu Süper Chat etkinliğine eklediği yorum.
snippet.superChatDetails.tier unsigned integer
Ücretli mesajın katmanı. superChatEvent kaynağında snippet.messageType özelliğinin bu değeri içerdiğini unutmayın.

Katman, mesajı satın almak için harcanan para miktarına göre belirlenir. Ayrıca, canlı sohbet kullanıcı arayüzünde mesajı vurgulamak için kullanılan rengi, maksimum mesaj uzunluğunu ve mesajın bantta sabitleneceği süreyi belirler.

Süper Chat katmanları YouTube Yardım Merkezi'nde belgelenmiştir. (Süper Chat satın alma ile ilgili ayrıntılı bilgi için genişletilebilir bölüme bakın.) Bu listede, en düşük satın alma tutarına sahip kademe 1. kademe, sonraki en düşük tutar 2. kademe vb. olarak sıralanır.
snippet.superStickerDetails object
Bu nesne, Super Sticker etkinliğiyle ilgili ayrıntıları içerir. Yalnızca mesaj türü superStickerEvent ise bulunur.
snippet.superStickerDetails.superStickerMetadata object
Süper Etiket ile ilgili ayrıntılar.
snippet.superStickerDetails.superStickerMetadata.stickerId string
Çıkartma resmini tanımlayan benzersiz kimlik. Resmin yalnızca kullanıcılar YouTube'da sohbet penceresini görüntülediğinde Super Sticker mesajının bir parçası olarak gösterildiğini unutmayın. Ancak resim URL'si API kullanılarak alınamaz. Hangi çıkartma kimliklerinin hangi Süper Etiketlerle ilişkili olduğunu yalnızca referans amaçlı olarak bu CSV dosyasında bulabilirsiniz.
snippet.superStickerDetails.superStickerMetadata.altText string
Çıkartmayı açıklayan bir metin dizesi. snippet.superStickerDetails.superStickerMetadata.language alanı, metnin dilini tanımlar. liveChatMessages.list yöntemini çağırırken hl parametre değerini metin için seçilen dile ayarlayın.
snippet.superStickerDetails.superStickerMetadata.language string
snippet.superStickerDetails.superStickerMetadata.altText özellik değerinin dili.
snippet.superStickerDetails.amountMicros unsigned long
Satın alma para biriminin mikro cinsinden satın alma tutarı. Örneğin, satın alma tutarı bir dolarsa snippet.amountMicros özelliği değeri 1000000 olur.
snippet.superStickerDetails.currency string
Satın alma işleminin yapıldığı para birimi. Değer, ISO 4217 para birimi kodudur.
snippet.superStickerDetails.amountDisplayString string
Satın alma tutarını ve para birimini içeren $1.00 gibi bir dize. Dizenin kullanıcıya gösterilmesi amaçlanmıştır.
snippet.superStickerDetails.tier unsigned integer
Ücretli mesajın katmanı. superChatEvent kaynağında snippet.messageType özelliğinin bu değeri içerdiğini unutmayın.

Katman, mesajı satın almak için harcanan para miktarına göre belirlenir. Ayrıca, canlı sohbet kullanıcı arayüzünde mesajı öne çıkarmak için kullanılan rengi, maksimum mesaj uzunluğunu ve mesajın bantta sabitleneceği süreyi belirler.

Süper Etiketler'i de kapsayan Süper Chat katmanları YouTube Yardım Merkezi'nde belgelenmiştir. (Süper Chat satın alma ile ilgili ayrıntılı bilgi için genişletilebilir bölüme bakın.) Bu listede, en düşük satın alma tutarına sahip kademe 1. kademe, sonraki en düşük tutar ise 2. kademe vb. olarak sıralanır.
snippet.pollDetails object
Bu nesne, anket etkinliğiyle ilgili ayrıntıları içerir. Yalnızca mesaj türü pollEvent ise bulunur.
snippet.pollDetails.metadata object
Anket etkinliğiyle ilgili ayrıntılar.
snippet.pollDetails.metadata.options object
Canlı anketteki seçenekler.
snippet.pollDetails.metadata.options.optionText string
Canlı anket seçeneğinin metni.
snippet.pollDetails.metadata.options.tally string
Canlı anket seçeneğinin sonucu. Toplam, yalnızca API isteği kanal sahibi tarafından yetkilendirilirse gösterilir.
snippet.pollDetails.metadata.questionText string
Canlı anket sorusunun metni.
snippet.pollDetails.metadata.status enum
Canlı anket etkinliğinin durumu. Bu özellik için geçerli değerler şunlardır:
  • unknown
  • active
  • closed
snippet.membershipGiftingDetails object
Bu nesne, üyelik hediye etme etkinliğiyle ilgili ayrıntıları içerir. Yalnızca message type membershipGiftingEvent ise gösterilir.
snippet.membershipGiftingDetails.giftMembershipsCount integer
Kullanıcı tarafından satın alınan hediye üyeliklerinin sayısı.
snippet.membershipGiftingDetails.giftMembershipsLevelName string
Kullanıcı tarafından satın alınan hediye üyeliklerin seviyesinin adı. Seviye adları, üyeliği sunan YouTube kanalı tarafından tanımlanır. Bazı durumlarda bu alan doldurulmaz.
snippet.giftMembershipReceivedDetails object
Bu nesne, Hediye Üyelik Alma etkinliğiyle ilgili ayrıntıları içerir. Yalnızca message type giftMembershipReceivedEvent ise gösterilir.
snippet.giftMembershipReceivedDetails.memberLevelName string
İzleyicinin üyesi olduğu seviyenin adı. Bu, ilişkili üyelik hediye etme mesajının snippet.membershipGiftingDetails.giftMembershipsLevelName ile eşleşir. Seviye adları, üyeliği sunan YouTube kanalı tarafından tanımlanır. Bazı durumlarda bu alan doldurulmaz.
snippet.giftMembershipReceivedDetails.gifterChannelId string
Üyelik hediye etme satın alma işlemini gerçekleştiren kullanıcının kimliği. Bu, ilişkili üyelik hediye etme mesajının snippet.authorChannelId ile eşleşir.
snippet.giftMembershipReceivedDetails.associatedMembershipGiftingMessageId string
Bu hediye üyeliğiyle ilişkili üyelik hediye etme mesajının kimliği. Bu kimlik, type değeri membershipGiftingEvent olan bir iletiyi her zaman ifade eder.
authorDetails object
authorDetails nesnesi, bu mesajı yayınlayan kullanıcıyla ilgili ek ayrıntılar içerir.
authorDetails.channelId string
Yazarın YouTube kanal kimliği.
authorDetails.channelUrl string
Yazarın YouTube kanalının URL'si.
authorDetails.displayName string
Yazarın YouTube kanalının görünen adı.
authorDetails.profileImageUrl string
Yazarın YouTube kanalının avatar URL'si.
authorDetails.isVerified boolean
Bu değer, yazarın kimliğinin YouTube tarafından doğrulanıp doğrulanmadığını gösterir.
authorDetails.isChatOwner boolean
Bu değer, yazarın canlı sohbetin sahibi olup olmadığını gösterir.
authorDetails.isChatSponsor boolean
Bu değer, yazarın canlı sohbetin sponsoru olup olmadığını gösterir.
authorDetails.isChatModerator boolean
Bu değer, yazarın canlı sohbet moderatörü olup olmadığını gösterir.