LiveChatMessages: transition

Przenosi stan wiadomości na czacie na żywo w YouTube i rozpoczyna wszystkie procesy związane z nowym stanem. Jeśli 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 w przypadku wiadomości z ankiety na żywo wynosi active.

Żądanie

Żądanie HTTP

POST https://www.googleapis.com/youtube/v3/liveChatMessages/transition

Autoryzacja

To żądanie wymaga autoryzacji przy użyciu co najmniej 1 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

Tabela poniżej zawiera 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óra zmienia stan.
status enum
Parametr status określa stan, na jaki zmienia się wiadomość. Aby można było przenieść wiadomość do stanu closed, w ankiecie, z którą jest ona powiązana, pole status musi mieć wartość active.

Możesz przejść tylko do wersji closed, co oznacza, że ankieta zostanie zamknięta.
Parametry opcjonalne
part string
Parametr part określa części zasobów liveChatMessage, które będzie uwzględniać odpowiedź interfejsu API. Obsługiwane wartości to id, snippet oraz authorDetails.

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

Treść żądania

Nie podawaj treści żądania przy wywoływaniu tej metody.

Odpowiedź

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

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 komunikatu o błędzie.

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

Wypróbuj

Użyj interfejsu APIs Explorer, aby wywołać ten interfejs API i wyświetlić żądanie i odpowiedź interfejsu API.