Comments: setModerationStatus

एक या उससे ज़्यादा टिप्पणियों के लिए मॉडरेशन की स्थिति सेट करता है. एपीआई अनुरोध के लिए, टिप्पणियों से जुड़े चैनल या वीडियो के मालिक से अनुमति मिलनी चाहिए.

कोटा पर असर: इस तरीके का इस्तेमाल करने पर 50 यूनिट की कोटे की लागत तय होती है.

इस्तेमाल के सामान्य उदाहरण

अनुरोध

एचटीटीपी अनुरोध

POST https://www.googleapis.com/youtube/v3/comments/setModerationStatus

अनुमति

इस अनुरोध के लिए, अनुमति देने के लिए इनमें से कम से कम एक दायरे की ज़रूरत होती है (पुष्टि करने और अनुमति देने के बारे में ज़्यादा पढ़ें).

स्कोप
https://www.googleapis.com/auth/youtube.force-ssl

पैरामीटर

इस टेबल में वे पैरामीटर दिए गए हैं जो इस क्वेरी पर काम करते हैं. सूची में दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.

पैरामीटर
ज़रूरी पैरामीटर
id string
id पैरामीटर, आईडी की कॉमा-सेपरेटेड लिस्ट के बारे में बताता है. यह उन टिप्पणियों की पहचान करता है जिनके लिए आपको मॉडरेशन स्टेटस अपडेट करना है.
moderationStatus string
इससे तय की गई टिप्पणियों के नए मॉडरेशन स्टेटस की पहचान होती है.

स्वीकार की जाने वाली वैल्यू ये हैं:
  • heldForReview – टिप्पणी को 'मॉडरेटर की समीक्षा का इंतज़ार है' के तौर पर मार्क करता है.
  • published – सार्वजनिक तौर पर दिखने के लिए किसी टिप्पणी को हटाता है.
  • rejected – किसी टिप्पणी को, 'दिखाए नहीं जा सकते' के तौर पर अस्वीकार करता है. यह कार्रवाई अस्वीकार की गई टिप्पणी के सभी जवाबों को भी छिपा देती है.
ज़रूरी नहीं पैरामीटर
banAuthor boolean
banAuthor पैरामीटर की मदद से, टिप्पणी करने वाले व्यक्ति की अन्य टिप्पणियों को अपने-आप अस्वीकार किया जा सकता है. लेखक को प्रतिबंधित करने के लिए, पैरामीटर वैल्यू को true पर सेट करें.

ध्यान दें: यह पैरामीटर सिर्फ़ तब मान्य होता है, जब moderationStatus पैरामीटर भी rejected पर सेट हो.

अनुरोध का मुख्य भाग

इस तरीके को लागू करते समय, अनुरोध का मुख्य हिस्सा न दें.

जवाब

कामयाब होने पर, यह तरीका एक एचटीटीपी 204 रिस्पॉन्स कोड (No Content) दिखाता है.

गड़बड़ियां

नीचे दी गई टेबल, गड़बड़ी के उन मैसेज की पहचान करती है जो एपीआई इस तरीके का इस्तेमाल करने पर कॉल करने पर दिखा सकता है. ज़्यादा जानकारी के लिए, कृपया गड़बड़ी के मैसेज का दस्तावेज़ देखें.

गड़बड़ी का टाइप गड़बड़ी का ब्यौरा ब्यौरा
badRequest (400) banWithoutReject banAuthor पैरामीटर का इस्तेमाल सिर्फ़ तब किया जा सकता है, जब moderationStatus पैरामीटर की वैल्यू rejected हो.
badRequest (400) operationNotSupported ऐसी टिप्पणियां जो Google+ पर आधारित नहीं हैं, सिर्फ़ मॉडरेशन की सीमित सुविधा देती हैं.
badRequest (400) processingFailure एपीआई सर्वर आपके अनुरोध को प्रोसेस नहीं कर सका. यह गड़बड़ी कुछ समय के लिए हो सकती है, लेकिन आम तौर पर इससे पता चलता है कि अनुरोध का इनपुट अमान्य है.
forbidden (403) forbidden ज़रूरत के मुताबिक अनुमतियां न होने की वजह से, एक या उससे ज़्यादा टिप्पणियों को मॉडरेट करने की स्थिति सेट नहीं की जा सकती. हो सकता है कि अनुरोध को सही तरीके से अनुमति न मिली हो.
notFound (404) commentNotFound अनुरोध की गई एक या इससे ज़्यादा टिप्पणियां नहीं मिली जिन्हें अपडेट करने की कोशिश की जा रही है. अनुरोध के id पैरामीटर की वैल्यू की जांच करके पक्का करें कि वे सही हैं.

इसे आज़माएं!

इस एपीआई को कॉल करने के लिए, APIs Explorer का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और उसका जवाब देखें.