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.