Videos: reportAbuse

Zgłosi film, który zawiera nieodpowiednie treści.

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

Prośba

Żądanie HTTP

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

Upoważnienie

To żądanie wymaga autoryzacji z użyciem co najmniej jednego 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

W tabeli poniżej znajdziesz parametry obsługiwane 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 dostawców treści w YouTube.

Parametr onBehalfOfContentOwner wskazuje, że dane uwierzytelniające żądanie identyfikują użytkownika YouTube CMS działającego w imieniu właściciela treści określonego w wartości parametru. Jest on przeznaczony dla dostawców treści w YouTube, którzy mają wiele różnych kanałów w YouTube i nimi zarządzają. Dzięki niej właściciele treści mogą jednorazowo uwierzytelnić się i uzyskiwać dostęp do wszystkich swoich filmów oraz danych dotyczących kanałów bez konieczności podawania danych uwierzytelniających dla każdego kanału z osobna. Konto CMS, za pomocą którego użytkownik uwierzytelnia się, musi być powiązane z określonym właścicielem treści 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 dla tych właściwości:

Właściwości opcjonalne

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

Właściwości

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

Właściwości
videoId string
Identyfikuje film, który jest zgłoszony ze względu na treści obraźliwe. Jako wartość wpisz identyfikator filmu w YouTube.
reasonId object
Określa przyczynę, dla której film został zgłoszony ze względu na treści obraźliwe. Ustaw wartość na unique ID odpowiedniego zasobu videoAbuseReportReason.
secondaryReasonId object
Określa drugorzędną przyczynę, dla której film został zgłoszony jako zawierający treści obraźliwe. Przyczyna drugorzędna określa bardziej szczegółowy opis kontrowersyjnej treści niż główna przyczyna, którą określa właściwość reasonId. Ustaw wartość na unique ID odpowiedniego powodu dodatkowego.
comments string
Zawiera wszelkie dodatkowe informacje, które chce dodać zgłaszający.
language object
Identyfikuje język używany przez 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 szczegółów 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 można znaleźć filmu, który chcesz zgłosić jako nadużycie.

Wypróbuj

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