Videos: reportAbuse

דיווח על סרטון שמכיל תוכן פוגעני.

ההשפעה של המכסה: קריאה לשיטה הזו כוללת עלות מכסה של 50 יחידות.

בקשה

בקשת HTTP

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

אישור

בקשה זו מחייבת הרשאה עם לפחות אחד מההיקפים הבאים (מידע נוסף על אימות והרשאה).

היקף
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtubepartner

פרמטרים

בטבלה הבאה מפורטים הפרמטרים שהשאילתה הזו תומכת בהם. כל הפרמטרים המפורטים הם פרמטרים של שאילתות.

פרמטרים
פרמטרים אופציונליים
onBehalfOfContentOwner string
ניתן להשתמש בפרמטר הזה רק במסגרת בקשה מורשית תקינה. הערה: הפרמטר הזה מיועד אך ורק לשותפי תוכן של YouTube.

הפרמטר onBehalfOfContentOwner מציין שפרטי הכניסה של ההרשאה של הבקשה מזהים משתמש YouTube CMS שפועל בשם בעלי התוכן שצוין בערך הפרמטר. הפרמטר הזה מיועד לשותפי תוכן של YouTube שהם הבעלים והמנהלים של ערוצי YouTube רבים ושונים. היא מאפשרת לבעלי תוכן לבצע אימות פעם אחת ולקבל גישה לכל נתוני הסרטונים והערוץ, בלי שיצטרכו לספק פרטי כניסה לאימות עבור כל ערוץ בנפרד. חשבון ה-CMS שאיתו המשתמש מבצע אימות חייב להיות מקושר לבעלי התוכן שצוינו ב-YouTube.

גוף הבקשה

גוף הבקשה מכיל את מבנה הנתונים הבא:

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

מאפיינים נדרשים

צריך להגדיר ערכים למאפיינים הבאים:

מאפיינים אופציונליים

אפשר להגדיר ערכים למאפיינים הבאים:

תכונות

הטבלה הבאה מגדירה את המאפיינים שיופיעו במשאב הזה:

תכונות
videoId string
מזהה את הסרטון שדיווחת עליו כי הוא מכיל תוכן פוגעני. מגדירים את הערך למזהה הווידאו של הסרטון ב-YouTube.
reasonId object
מציינת את הסיבה שבגללה הסרטון מדווח כי הוא מכיל תוכן פוגעני. צריך להגדיר את הערך ל-unique ID של משאב videoAbuseReportReason המתאים.
secondaryReasonId object
מציינת את הסיבה המשנית לכך שהסרטון מכיל תוכן פוגעני, שדווח באמצעותו. סיבה משנית מספקת תיאור ספציפי יותר של התוכן שמעורר התנגדות, בהשוואה לסיבה העיקרית, שמזהה המאפיין reasonId. צריך להגדיר את הערך ל-unique ID של הסיבה המשנית המתאימה.
comments string
כאן יופיעו כל פרטים שהדיווח רוצה להוסיף.
language object
מזהה שפה שהכתב דובר.

תשובה

אם הפעולה בוצעה בהצלחה, השיטה הזו מחזירה קוד תגובה 204 מסוג HTTP (No Content).

שגיאות

בטבלה הבאה מפורטות הודעות השגיאה שה-API עלול להחזיר בתגובה לקריאה לשיטה הזו. פרטים נוספים זמינים במסמכים בנושא הודעת שגיאה.

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) invalidAbuseReason הבקשה הכילה ערך לא צפוי של הנכס reasonId, או שילוב לא חוקי של הנכסים reasonId ו-secondaryReasonId.
badRequest (400) rateLimitExceeded המשתמש שלח יותר מדי בקשות בפרק זמן נתון.
forbidden (403) forbidden
notFound (404) videoNotFound לא מצאנו את הסרטון שעליו ניסית לדווח על שימוש לרעה.

רוצה לנסות?

משתמשים ב-APIs Explorer כדי לקרוא ל-API הזה ולראות את הבקשה והתגובה של ה-API.