Canlı sohbete mesaj ekler.
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 bu özelliklerin değerlerini belirtmeniz gerekir
snippet.liveChatId
snippet.type
-textMessageEvent
hesabını kullanınsnippet.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 ayrıntılı bilgi için 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. |
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 |
required (400) |
preconditionCheckFailed |
Sabitlenmiş etkin bir anket zaten var. |
rateLimitExceeded |
rateLimitExceeded |
Kullanıcı, belirli bir zaman aralığında çok fazla sohbet mesajı gönderdi. |
Deneyin.
Bu API'yi çağırmak ve API isteğini ve yanıtını görmek için APIs Explorer kullanın.