Comments: setModerationStatus

Określa stan moderowania co najmniej jednego komentarza. Żądanie API musi być autoryzowane przez właściciela kanału lub filmu powiązanego z komentarzami.

Wpływ na limit: wywołanie tej metody ma koszt limitu wynoszący 50 jednostek.

Typowe przypadki użycia

Prośba

Żądanie HTTP

POST https://www.googleapis.com/youtube/v3/comments/setModerationStatus

Upoważnienie

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

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

Parametry

Poniższa tabela zawiera parametry obsługiwane przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
id string
Parametr id określa rozdzieloną przecinkami listę identyfikatorów identyfikujących komentarze, których stan moderacji chcesz zaktualizować.
moderationStatus string
Wskazuje nowy stan moderowania wybranych komentarzy.

Akceptowane wartości:
  • heldForReview – oznacza komentarz jako oczekujący na sprawdzenie przez moderatora.
  • published – usuwa komentarz, który będzie wyświetlany publicznie.
  • rejected – odrzuca komentarz, który nie nadaje się do wyświetlenia. Dodatkowo spowoduje to ukrycie wszystkich odpowiedzi na odrzucony komentarz.
Parametry opcjonalne
banAuthor boolean
Parametr banAuthor pozwala określić, że chcesz automatycznie odrzucać wszystkie dodatkowe komentarze napisane przez ich autorów. Aby zablokować autora, ustaw wartość tego parametru na true.

Uwaga: ten parametr jest prawidłowy tylko wtedy, gdy parametr moderationStatus ma wartość rejected.

Treść żądania

Nie podawaj treści żądania podczas wywoływania tej metody.

Odpowiedź

Jeśli operacja się uda, metoda zwróci kod odpowiedzi HTTP 204 (No Content).

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
badRequest (400) banWithoutReject Parametru banAuthor można użyć tylko wtedy, gdy wartość parametru moderationStatus wynosi rejected.
badRequest (400) operationNotSupported Komentarze, które nie są oparte na Google+, oferują ograniczoną możliwość moderowania.
badRequest (400) processingFailure Serwerowi interfejsu API nie udało się przetworzyć żądania. Mimo że może to być błąd przejściowy, zwykle oznacza to, że dane wejściowe żądania są nieprawidłowe.
forbidden (403) forbidden Nie można ustawić stanu moderacji co najmniej jednego komentarza z powodu niewystarczających uprawnień. Żądanie może nie być prawidłowo autoryzowane.
notFound (404) commentNotFound Nie można znaleźć co najmniej jednego komentarza, który jest aktualizowany przez żądanie. Sprawdź, czy wartości parametru id żądania są prawidłowe.

Wypróbuj

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