מדווח על סרטון המכיל תוכן פוגעני.
ההשפעה על המכסה: קריאה לשיטה זו כוללת עלות מכסה של 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 מציין שפרטי הכניסה להרשאה של הבקשה מזהים משתמש CMS ב-YouTube שפועל בשם בעלי התוכן שצוין בערך הפרמטר. הפרמטר הזה מיועד לשותפי תוכן של YouTube שבבעלותם ובניהולם של ערוצי YouTube רבים. היא מאפשרת לבעלי התוכן לבצע אימות פעם אחת ולקבל גישה לכל נתוני הסרטונים והערוצים שלהם, ללא צורך לספק פרטי כניסה לאימות עבור כל ערוץ בנפרד. חשבון במערכת ניהול התוכן שהמשתמש מאמת באמצעותו חייב להיות מקושר לבעלי התוכן שצוינו ב-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
(No Content
) של HTTP.
שגיאות
הטבלה בהמשך מזהה הודעות שגיאה שה-API יכול להחזיר בתגובה לקריאה לשיטה הזו. מידע נוסף זמין בתיעוד של הודעת השגיאה.
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
invalidAbuseReason |
הבקשה הכילה ערך לא צפוי במאפיין reasonId או שילוב לא חוקי של נכס reasonId ומאפיין secondaryReasonId . |
badRequest (400) |
rateLimitExceeded |
המשתמש שלח יותר מדי בקשות בפרק זמן נתון. |
forbidden (403) |
forbidden |
|
notFound (404) |
videoNotFound |
הסרטון שלגביו ניסית לדווח על התנהלות פוגעת לא נמצא. |
רוצה לנסות?
אפשר להשתמש ב-APIs Explorer כדי לקרוא ל-API הזה ולראות את בקשת ה-API ואת התשובה.