LiveChatMessages: insert

Canlı sohbete mesaj veya anket ekler.

Kota etkisi: Bu yönteme yapılan bir çağrının kota maliyeti 20 birimdir.

Yaygın kullanım alanları

İstek

HTTP isteği

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

Yetkilendirme

Bu istek, aşağıdaki kapsamlardan en az biriyle yetkilendirme gerektirir. 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 amaca hizmet eder. 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 metni

İstek gövdesinde bir liveChatMessage kaynağı sağlayın. Bu kaynak için şu özelliklerin değerlerini belirtmeniz gerekir:

  • snippet.liveChatId
  • snippet.type - Aşağıdaki seçeneklerden birini belirleyin: textMessageEvent veya pollEvent
  • Tür textMessageEvent ise snippet.textMessageDetails.messageText değerini ekleyin
  • Tür pollEvent ise aşağıdaki gibi yapılandırılmış snippet.pollDetails nesnesini ekleyin:
    • snippet.pollDetails.metadata.questionText (Dize): Anketin ana sorusu.
    • snippet.pollDetails.metadata.options (Dizi): Seçenek nesnelerinin listesi.
    • Şartlar: En az 2, en fazla 4 öğe eklemeniz gerekir.
    • Sıralama: Öğeler, listelendikleri sırayla gösterilir.
    • Dizideki her nesne şunları içermelidir:
      • optionText (Dize): Belirli bir anket seçeneği için gösterilen metin.

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 (YouTube Canlı Akış API'si - Hatalar) 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, sahibi tarafından devre dışı bırakıldı. Bu nedenle, sohbete mesaj eklenemez.
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 belirtilen canlı sohbet mevcut değil. Bu hata, sohbet sahibi tarafından silindiyse ortaya çıkar.
required (400) liveChatIdRequired liveChatMessage kaynağı, snippet.liveChatId mülkünü içermeli ve bu mülk için bir değer belirtmelidir.
required (400) messageTextRequired liveChatMessage kaynağı, snippet.textMessageDetails.messageText özelliğini içermeli ve bu özellik için bir değer belirtmelidir.
required (400) typeRequired liveChatMessage kaynağı, snippet.type özelliğini içermeli ve bu özellik için bir değer belirtmelidir. Parametre değerini text olarak ayarlayın.
required (400) preconditionCheckFailed Sabitlenmiş etkin bir anket zaten mevcut.
rateLimitExceeded rateLimitExceeded Kullanıcı, belirli bir zaman diliminde ç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.