LiveChatMessages: insert

Canlı sohbete mesaj ekler. API şu anda yalnızca kısa mesaj ekleme özelliğini desteklemektedir.

Yaygın kullanım alanları

İstek

HTTP isteği

POST https://www.googleapis.com/youtube/v3/liveChat/messages

Yetkilendirme

Bu istek için aşağıdaki kapsamlardan en az biriyle yetkilendirme gerekir (kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinin).

Kapsam
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parametreler

Aşağıdaki tabloda, bu sorgunun desteklediği parametreler listelenmiştir. Listelenen parametrelerin tümü sorgu parametreleridir.

Parametreler
Gerekli parametreler
part string
part parametresinin iki işlevi vardır. Yazma işleminin ayarlayacağı özelliklerin yanı sıra API yanıtının içereceği özellikleri tanımlar. Parametre değerini snippet olarak ayarlayın.

İstek içeriği

İstek gövdesinde bir liveChatMessage kaynağı sağlayın. Söz konusu kaynak için:

  • Şu özellikler için bir değer belirtmelisiniz:

    • snippet.liveChatId
    • snippet.type: Şu anda desteklenen tek değer textMessageEvent değeridir.
    • snippet.textMessageDetails.messageText

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir liveChatMessage kaynağı döndürür.

Hatalar

Aşağıdaki tabloda, API'nin bu yönteme yapılan çağrıya yanıt olarak döndürebileceği hata mesajları tanımlanmaktadır. Daha fazla bilgi için lütfen hata mesajı dokümanlarına bakın.

Hata türü Hata ayrıntısı Açıklama
forbidden (403) forbidden Belirtilen mesajı oluşturmak için gereken izinlere sahip değilsiniz.
forbidden (403) liveChatDisabled Belirtilen canlı sohbet sahibi tarafından devre dışı bırakıldığı için sohbete mesaj eklenemiyor.
forbidden (403) liveChatEnded Belirtilen canlı sohbet artık yayında değil.
invalidValue (400) messageTextInvalid Mesaj metni (snippet.textMessageDetails.messageText) geçerli değil.
notFound (404) liveChatNotFound API isteğinde tanımlanan canlı sohbet mevcut değil. Bu hata, sohbet sahibi tarafından silindiğinde ortaya çıkar.
rateLimitExceeded rateLimitExceeded Kullanıcı, belirli bir zaman aralığında çok fazla sohbet mesajı gönderdi.
required (400) liveChatIdRequired liveChatMessage kaynağı, snippet.liveChatId özelliği için bir değer içermeli ve belirtmelidir.
required (400) messageTextRequired liveChatMessage kaynağı, snippet.textMessageDetails.messageText özelliği için bir değer içermeli ve belirtmelidir.
required (400) typeRequired liveChatMessage kaynağı, snippet.type özelliği için bir değer içermeli ve belirtmelidir. Parametre değerini text olarak ayarlayın

Deneyin.

Bu API'yi çağırmak ve API isteğini ve yanıtını görmek için APIs Explorer kullanın.