Videos: reportAbuse

Zgłasza film zawierający nieodpowiednie treści.

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

Żądanie

Żądanie HTTP

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

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
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
Ten parametr może być używany tylko w poprawnie autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów w sieci reklamowej YouTube.

Parametr onBehalfOfContentOwner wskazuje, że dane logowania żądania autoryzacji to użytkownik 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 w sieci reklamowej YouTube, którzy mają wiele kanałów YouTube i zarządzają nimi. Umożliwia właścicielom treści uwierzytelnianie tylko raz oraz dostęp do wszystkich filmów i kanałów bez konieczności podawania danych uwierzytelniających dla każdego kanału z osobna. Konto CMS, za pomocą którego użytkownik się uwierzytelni, musi być połączone z określonym właścicielem treści w YouTube.

Treść żądania

Treść żądania ma taką 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 ustawić wartości tych właściwości:

Usługi

Poniższa tabela określa właściwości, które pojawiają się w tym zasobie:

Usługi
videoId string
Wskazuje film, który został zgłoszony z powodu treści naruszających zasady. Ustaw wartość identyfikatora filmu w YouTube.
reasonId object
Określa powód, dla którego film jest zgłaszany jako naruszający zasady. Ustaw wartość na odpowiednie videoAbuseReportReason zasobu unique ID.
secondaryReasonId object
Określa dodatkowy powód, dla którego film jest zgłaszany jako zawierający nieodpowiednie treści. Przyczyna drugorzędna zawiera bardziej szczegółowy opis kontrowersyjnych treści niż powód podstawowy, podany we właściwości reasonId. Ustaw wartość unique ID odpowiedniego powodu dodatkowego.
comments string
Podaje wszelkie dodatkowe informacje, które chce dodać zgłaszający.
language object
Identyfikuje język reportera.

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) invalidAbuseReason Żądanie zawiera 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 okresie.
forbidden (403) forbidden
notFound (404) videoNotFound Nie udało się znaleźć filmu, którego dotyczy zgłoszenie nadużycia.

Wypróbuj

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