Comments: setModerationStatus

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

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

Częste zastosowania

Żądanie

Żądanie HTTP

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

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.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 rozdzieloną przecinkami listę maksymalnie 50 identyfikatorów komentarzy, których stan moderowania chcesz zaktualizować.
moderationStatus string
Określa nowy stan moderowania wybranych komentarzy.

Dopuszczalne wartości:
  • heldForReview – oznacza komentarz jako oczekujący na sprawdzenie przez moderatora.
  • published – usuwa komentarz z moderacji, aby był widoczny publicznie. Nie możesz zmienić stanu moderowania odrzuconego komentarza na published.
  • rejected – odrzuca komentarz jako nieodpowiedni do wyświetlania. To działanie powoduje też ukrycie wszystkich odpowiedzi na odrzucony komentarz. Aby usunąć komentarz napisany przez innego użytkownika z Twojego kanału lub filmu, ustaw jego stan moderowania na rejected. Metody comments.delete może używać tylko pierwotny autor komentarza.
Parametry opcjonalne
banAuthor boolean
Parametr banAuthor pozwala wskazać, że chcesz automatycznie odrzucać wszystkie dodatkowe komentarze napisane przez autora komentarza. Aby zablokować autora, ustaw wartość parametru na true.

Ten parametr jest prawidłowy tylko wtedy, gdy parametr moderationStatus jest ustawiony na rejected.

Treść żądania

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

Odpowiedź

Jeśli operacja się powiedzie, ta metoda zwraca 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żywać tylko wtedy, gdy wartość parametru moderationStatus to rejected.
badRequest (400) operationNotSupported Komentarze, które nie są oparte na Google+, mają tylko ograniczoną funkcjonalność moderowania.
badRequest (400) processingFailure Serwer interfejsu API nie przetworzył żądania. Może to być błąd przejściowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe. Ten błąd jest też zwracany, gdy próbujesz moderować komentarz, który został już usunięty przez pierwotnego komentującego.
forbidden (403) forbidden Nie można ustawić stanu moderowania co najmniej 1 komentarza z powodu niewystarczających uprawnień. Żądanie może nie być autoryzowane. Ten błąd jest też zwracany, gdy próbujesz moderować usunięty lub nieprawidłowy identyfikator komentarza.
notFound (404) commentNotFound Nie można znaleźć co najmniej 1 komentarza, który ma zostać zaktualizowany przez żądanie. Sprawdź wartości parametru id w żądaniu, aby upewnić się, że są prawidłowe.

Wypróbuj

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