অপমানজনক বিষয়বস্তু থাকার জন্য একটি ভিডিও প্রতিবেদন করে৷
কোটা প্রভাব: এই পদ্ধতিতে একটি কলের কোটা খরচ 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 যে ভিডিওটিতে অপমানজনক বিষয়বস্তু থাকার জন্য প্রতিবেদন করা হচ্ছে তার কারণ উল্লেখ করে৷ উপযুক্ত videoAbuseReportReason রিসোর্সের unique ID মান সেট করুন। |
secondaryReasonId | object সেকেন্ডারি কারণ উল্লেখ করে যে ভিডিওটিতে অপমানজনক বিষয়বস্তু থাকার জন্য রিপোর্ট করা হচ্ছে। একটি গৌণ কারণ প্রাথমিক কারণের চেয়ে আপত্তিকর বিষয়বস্তুর আরও সুনির্দিষ্ট বিবরণ প্রদান করে, যা reasonId বৈশিষ্ট্য সনাক্ত করে। মানটি উপযুক্ত গৌণ কারণের unique ID সেট করুন। |
comments | string রিপোর্টার যোগ করতে চায় এমন কোনো অতিরিক্ত তথ্য প্রদান করে। |
language | object প্রতিবেদকের দ্বারা কথ্য একটি ভাষা সনাক্ত করে। |
প্রতিক্রিয়া
সফল হলে, এই পদ্ধতিটি একটি HTTP 204
প্রতিক্রিয়া কোড প্রদান করে ( No Content
)।
ত্রুটি
নীচের সারণী ত্রুটি বার্তাগুলি সনাক্ত করে যেগুলি API এই পদ্ধতিতে একটি কলের প্রতিক্রিয়া হিসাবে ফিরে আসতে পারে৷ আরো বিস্তারিত জানার জন্য ত্রুটি বার্তা ডকুমেন্টেশন দেখুন.
ত্রুটির ধরন | ত্রুটি বিস্তারিত | বর্ণনা |
---|---|---|
badRequest (400) | invalidAbuseReason | অনুরোধটিতে reasonId প্রপার্টির জন্য একটি অপ্রত্যাশিত মান বা reasonId এবং secondaryReasonId বৈশিষ্ট্যের একটি অবৈধ সমন্বয় রয়েছে৷ |
badRequest (400) | rateLimitExceeded | ব্যবহারকারী একটি নির্দিষ্ট সময়সীমার মধ্যে অনেক বেশি অনুরোধ পাঠিয়েছেন। |
forbidden (403) | forbidden | |
notFound (404) | videoNotFound | আপনি যে ভিডিওটির জন্য অপব্যবহারের প্রতিবেদন করার চেষ্টা করছেন সেটি খুঁজে পাওয়া যাবে না৷ |
এটা চেষ্টা করুন!
এই API কল করতে APIs Explorer ব্যবহার করুন এবং API অনুরোধ এবং প্রতিক্রিয়া দেখুন।