आपत्तिजनक कॉन्टेंट वाले वीडियो की शिकायत की जाती है.
कोटा पर असर: इस तरीके का इस्तेमाल करने पर 50 यूनिट का कोटा शुल्क होगा.
अनुरोध
एचटीटीपी अनुरोध
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 सीएमएस के किसी ऐसे उपयोगकर्ता की पहचान करते हैं जो पैरामीटर वैल्यू में बताए गए कॉन्टेंट के मालिक की ओर से काम कर रहा है. यह पैरामीटर उन YouTube कॉन्टेंट पार्टनर के लिए है जिनके पास कई अलग-अलग YouTube चैनलों का मालिकाना हक होता है और उन्हें मैनेज करने का अधिकार होता है. इससे कॉन्टेंट के मालिकों को एक बार पुष्टि करने के साथ-साथ, अपने वीडियो और चैनल के पूरे डेटा का ऐक्सेस मिल जाता है. इसके लिए, उन्हें हर चैनल के लिए पुष्टि करने वाले क्रेडेंशियल देने की ज़रूरत नहीं पड़ती. उपयोगकर्ता जिस कॉन्टेंट मैनेजमेंट सिस्टम से पुष्टि करता है वह खाता, 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रिपोर्टर की बोली गई भाषा की पहचान करता है. |
जवाब
अगर यह तरीका काम करता है, तो यह एचटीटीपी 204 रिस्पॉन्स कोड (No Content) दिखाता है.
गड़बड़ियां
नीचे दी गई टेबल में गड़बड़ी के ऐसे मैसेज दिखाए गए हैं जिन्हें एपीआई इस तरीके को कॉल करने पर दिखा सकता है. ज़्यादा जानकारी के लिए, कृपया गड़बड़ी के मैसेज का दस्तावेज़ देखें.
| गड़बड़ी का टाइप | गड़बड़ी की जानकारी | ब्यौरा |
|---|---|---|
badRequest (400) |
invalidAbuseReason |
इस अनुरोध में reasonId प्रॉपर्टी के लिए ऐसी वैल्यू मौजूद है जिसकी उम्मीद नहीं थी या reasonId और secondaryReasonId प्रॉपर्टी का कॉम्बिनेशन अमान्य है. |
badRequest (400) |
rateLimitExceeded |
उपयोगकर्ता ने दी गई समयावधि में बहुत ज़्यादा अनुरोध भेजे हैं. |
forbidden (403) |
forbidden |
|
notFound (404) |
videoNotFound |
वह वीडियो नहीं मिला जिसके लिए आप दुरुपयोग की रिपोर्ट करने का प्रयास कर रहे हैं. |
इसे आज़माएं!
इस एपीआई को कॉल करने के लिए, APIs Explorer का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और रिस्पॉन्स देखें.