Bu sayfa, Cloud Translation API ile çevrilmiştir.

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, aşağıdaki kapsamlardan en az biriyle yetkilendirme gerektirir (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 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 de 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 özelliklere değer belirtmelisiniz

snippet.liveChatId
snippet.type - şu seçeneklerden birini belirleyin: textMessageEvent veya pollEvent
Tür textMessageEvent ise snippet.textMessageDetails.messageText değerini ekleyin
Tür pollEvent ise aşağıdaki değerleri kullanarak snippet.pollDetails ekleyin:
- snippet.pollDetails.metadata.options.questionText
- snippet.pollDetails.metadata.options.optionText listesi. En az iki, en fazla beş öğe listelemelisiniz. Öğeler, listelendikleri sırada sırayla görüntülenir.

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 hata mesajı dokümanlarını inceleyin.

Hata türü	Hata ayrıntısı	Açıklama
`forbidden (403)`	`forbidden`	Belirtilen iletiyi 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 mesajlar sohbete 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, sohbetin sahibi tarafından silinmesi durumunda oluşur.
`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ği ile yanıtını görmek için APIs Explorer yönergesini kullanın.