Videos: reportAbuse

zgłasza film z powodu zawierania treści obraźliwych;

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

Żądanie

Żądanie HTTP

POST https://www.googleapis.com/youtube/v3/videos/reportAbuse

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
https://www.googleapis.com/auth/youtubepartner

Parametry

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

Parametry
Parametry opcjonalne
onBehalfOfContentOwner string
Tego parametru można używać tylko w prawidłowo autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów treści YouTube.

Parametr onBehalfOfContentOwner wskazuje, że dane uwierzytelniające do autoryzacji żądania identyfikują użytkownika systemu CMS YouTube, który działa w imieniu właściciela treści określonego w wartości parametru. Ten parametr jest przeznaczony dla partnerów treści w YouTube, którzy są właścicielami wielu kanałów YouTube i nimi zarządzają. Umożliwia ono właścicielom treści jednorazową weryfikację i uzyskanie dostępu do wszystkich danych o filmach i kanałach bez konieczności podawania danych uwierzytelniających dla każdego kanału. Konto CMS, za pomocą którego użytkownik się uwierzytelnia, musi być powiązane z określonym właścicielem treści w YouTube.

Treść żądania

Treść żądania ma następującą strukturę danych:

{
  "videoId": string,
  "reasonId": string,
  "secondaryReasonId": string,
  "comments": string,
  "language": string
}

Właściwości wymagane

Musisz ustawić wartości tych właściwości:

Właściwości opcjonalne

Możesz ustawiać wartości tych właściwości:

Właściwości

Właściwości występujące w tym zasobie są opisane w tabeli poniżej:

Właściwości
videoId string
Identyfikuje film, który jest zgłaszany ze względu na nieodpowiednie treści. Ustaw wartość na identyfikator filmu w YouTube.
reasonId object
Określa powód, dla którego zgłaszany film zawiera obraźliwe treści. Ustaw wartość na unique ID odpowiedniego zasobu videoAbuseReportReason.
secondaryReasonId object
Określa dodatkowy powód zgłoszenia filmu zawierającego treści obraźliwe. Drugorzędny powód zawiera bardziej szczegółowy opis treści budzących zastrzeżenia niż powód główny, który jest identyfikowany przez właściwość reasonId. Ustaw wartość na odpowiednią wartość unique ID dla drugiego powodu.
comments string
Zawiera dodatkowe informacje, które chce dodać zgłaszający.
language object
Określa język, w którym mówi reporter.

Odpowiedź

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

Błędy

Tabela poniżej zawiera komunikaty o błędach, które interfejs API może zwrócić w odpowiedzi na wywołanie tej metody. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją dotyczącą komunikatów o błędach.

Typ błędu Szczegóły błędu Opis
badRequest (400) invalidAbuseReason Żądanie zawierało nieoczekiwaną wartość właściwości reasonId lub nieprawidłową kombinację właściwości reasonId i secondaryReasonId.
badRequest (400) rateLimitExceeded Użytkownik wysłał zbyt wiele żądań w danym przedziale czasu.
forbidden (403) forbidden
notFound (404) videoNotFound Nie można znaleźć filmu, którego dotyczy nadużycie, które chcesz zgłosić.

Wypróbuj

Użyj adresu APIs Explorer, aby wywołać ten interfejs API i zobaczyć żądanie oraz odpowiedź interfejsu API.