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.