LiveChatMessages: transition

YouTube canlı sohbet mesajının durumunu değiştirir ve yeni durumla ilişkili tüm süreçleri başlatır. Örneğin, canlı anketin durumunu closed olarak değiştirdiğinizde YouTube, ilgili mesajın anketini sonlandırır. Bu yöntemi çağırmadan önce canlı anket mesajının status özelliğinin değerinin active olduğunu doğrulamanız gerekir.

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

İstek

HTTP isteği

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

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
id string
id parametresi, başka bir duruma geçiş yapan mesajın benzersiz kimliğini belirtir.
status enum
status parametresi, mesajın değiştiği durumu tanımlar. Bir mesajın closed durumuna geçmesi için status, mesajın bağlı olduğu anket için active olmalıdır.

Yalnızca closed durumuna geçiş yapabilirsiniz. Bu, anketin kapalı olduğu anlamına gelir.
İsteğe bağlı parametreler
part string
part parametresi, API yanıtının içereceği liveChatMessage kaynak parçalarını belirtir. Desteklenen değerler id, snippet ve authorDetails'dir.

Yanıt gövdesinde nihai anket sonucunu almak için parametre değerini snippet olarak ayarlayın.

İstek metni

Bu yöntemi çağırırken istek gövdesi sağlamayın.

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir liveChatMessages 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ı belirtilmektedir. Daha fazla bilgi için lütfen hata mesajı belgelerine bakın.

Hata türü Hata ayrıntısı Açıklama
forbidden (403) forbidden Belirtilen mesajın durumunu değiştirmek için gerekli izinlere sahip değilsiniz.
required (400) idRequired Gerekli id parametresi, durumunu değiştirmek istediğiniz mesajı tanımlamalıdır.
required (400) statusRequired API isteği, status parametresi için bir değer belirtmelidir.
notFound (404) liveChatMessagesNotFound id parametresiyle belirtilen mesaj mevcut değil.
forbidden (403) modificationNotAllowed Belirtilen liveChatMessage kaynağının durumu değiştirilemez. id parametresi, durumu değiştirilemeyen bir iletiyi tanımlayabilir.

Deneyin.

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