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ğertextMessageEvent
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.