LiveChatMessages: transition

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

İstek

HTTP isteği

POST https://www.googleapis.com/youtube/v3/liveChatMessages/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şmekte olduğu durumu tanımlar. Bir iletinin closed durumuna geçirilmesi için status, iletinin bağlı olduğu ankette active olmalıdır.

Yalnızca closed aboneliğine geçebilirsiniz. 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 bölümlerini belirtir. id, snippet ve authorDetails değerleri desteklenir.

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

İstek içeriği

Bu yöntemi çağırırken istek gövdesini belirtmeyin.

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ı tanımlanmaktadır. Daha fazla bilgi için lütfen hata mesajı ile ilgili dokümanları inceleyin.

Hata türü Hata ayrıntısı Açıklama
forbidden (403) forbidden Belirtilen iletinin durumunun geçişini yapmak için gereken izinlere sahip değilsiniz.
required (400) idRequired Zorunlu id parametresi, durumunu geçirmek 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 için geçiş yapılamıyor. id parametresi, durumu için geçiş yapılamayan bir mesajı tanımlayabilir.

Deneyin!

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