LiveChatMessages: transition

Zmienia stan wiadomości na czacie na żywo w YouTube na żywo i inicjuje procesy powiązane z nowym stanem. Gdy na przykład zmienisz stan ankiety na żywo na closed, YouTube zakończy ankietę w tej wiadomości. Zanim wywołasz tę metodę, sprawdź, czy wartość właściwości status wiadomości z ankietą na żywo to active.

Wpływ na limit: wywołanie tej metody kosztuje 20 jednostek limitu.

Żądanie

Żądanie HTTP

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

Autoryzacja

To żądanie wymaga autoryzacji z co najmniej jednym z tych zakresów (więcej informacji o uwierzytelnianiu i autoryzacji).

Zakres
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parametry

W tabeli poniżej znajdziesz listę parametrów obsługiwanych przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
id string
Parametr id określa unikalny identyfikator wiadomości, której stan się zmienia.
status enum
Parametr status określa stan, na który ma się zmienić wiadomość. Aby zmienić stan wiadomości na closed, parametr status musi mieć wartość active w przypadku ankiety, z którą jest powiązana wiadomość.

Możesz zmienić stan tylko na closed, co oznacza, że ankieta jest zamknięta.
Parametry opcjonalne
part string
Parametr part określa części zasobu liveChatMessage, które będą uwzględnione w odpowiedzi interfejsu API. Obsługiwane wartości to id, snippet i authorDetails.

Ustaw wartość parametru na snippet, aby w treści odpowiedzi otrzymać ostateczny wynik ankiety.

Treść żądania

Podczas wywoływania tej metody nie podawaj treści żądania.

Odpowiedź

Jeśli operacja się uda, ta metoda zwróci w treści odpowiedzi zasób liveChatMessages.

Błędy

W tabeli poniżej znajdziesz komunikaty o błędach, które interfejs API może zwrócić w odpowiedzi na wywołanie tej metody. Więcej informacji znajdziesz w dokumentacji komunikatów o błędach.

Typ błędu Szczegóły błędu Opis
forbidden (403) forbidden Nie masz uprawnień wymaganych do zmiany stanu określonej wiadomości.
required (400) idRequired Wymagany parametr id musi identyfikować wiadomość, której stan chcesz zmienić.
required (400) statusRequired Żądanie do interfejsu API musi zawierać wartość parametru status.
notFound (404) liveChatMessagesNotFound Wiadomość określona przez parametr id nie istnieje.
forbidden (403) modificationNotAllowed Nie można zmienić stanu określonego zasobu liveChatMessage. Parametr id może identyfikować wiadomość, której stanu nie można zmienić.

Wypróbuj

Aby wywołać ten interfejs API i zobaczyć żądanie do interfejsu API oraz odpowiedź, użyj APIs Explorer.