LiveChatMessages: insert

Canlı sohbete mesaj veya anket ekler.

Yaygın kullanım örnekleri

İstek

HTTP isteği

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

Yetkilendirme

Bu istek için aşağıdaki kapsamlardan en az biri ile yetkilendirme gerekir. Kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinmek için OAuth 2.0 kimlik doğrulamasını uygulama başlıklı makaleyi inceleyin.

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 tüm parametreler sorgu parametreleridir.

Parametreler
Gerekli parametreler
part string
part parametresi iki amaç için kullanılı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övdesine bir liveChatMessage kaynağı ekleyin. Bu kaynak için bu özelliklerle ilgili değerleri belirtmeniz gerekir.

  • snippet.liveChatId
  • snippet.type: Aşağıdaki seçeneklerden birini belirleyin: textMessageEvent veya pollEvent
  • Tür textMessageEvent ise snippet.textMessageDetails.messageText ekleyin
  • Tür pollEvent ise snippet.pollDetails öğesini aşağıdaki değerlerle ekleyin:
    • snippet.pollDetails.metadata.options.questionText
    • snippet.pollDetails.metadata.options.optionText listesi. En az iki, en fazla beş öğe listelemeniz gerekir. Öğeler listelendikleri sırada sırayla gösterilir.

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 bir çağrıya yanıt olarak döndürebileceği hata mesajları tanımlanmaktadır. Daha fazla bilgi için YouTube Live Streaming API - Errors başlıklı makaleyi inceleyin.

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, sahip tarafından devre dışı bırakılmıştır. Bu nedenle sohbete mesaj eklenemez.
forbidden (403) liveChatEnded Belirtilen canlı sohbet artık yayında değil.
invalidValue (400) messageTextInvalid İleti 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 silinmişse ortaya çıkar.
required (400) liveChatIdRequired liveChatMessage kaynağı, snippet.liveChatId mülkü için bir değer içermeli ve belirtmelidir.
required (400) messageTextRequired liveChatMessage kaynağı, snippet.textMessageDetails.messageText mülkü için bir değer içermeli ve belirtmelidir.
required (400) typeRequired liveChatMessage kaynağı, snippet.type mülkü için bir değer içermeli ve belirtmelidir. Parametre değerini text olarak ayarlayın
required (400) preconditionCheckFailed Sabitlenmiş etkin bir anket zaten mevcut.
rateLimitExceeded rateLimitExceeded Kullanıcı belirli bir zaman aralığında çok fazla sohbet mesajı yayınladı.

Deneyin!

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