Videos: reportAbuse

बुरे बर्ताव वाली सामग्री होने के बारे में वीडियो की रिपोर्ट करता है.

कोटा असर: इस तरीके को कॉल करने पर कोटा लागत 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 का इस्तेमाल करें.