Comments: setModerationStatus

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

कोटा पर असर: इस तरीके को कॉल करने पर, 50 यूनिट का कोटा खर्च होता है.

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

अनुरोध

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

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

अनुमति देना

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

दायरा
https://www.googleapis.com/auth/youtube.force-ssl

पैरामीटर

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

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

ये वैल्यू डाली जा सकती हैं:
  • heldForReview – इससे किसी टिप्पणी को, मॉडरेटर की समीक्षा के लिए मार्क किया जाता है.
  • published – इससे किसी टिप्पणी को सार्वजनिक तौर पर दिखाने की अनुमति मिलती है. अस्वीकार की गई किसी टिप्पणी की मॉडरेशन स्थिति को published में नहीं बदला जा सकता.
  • rejected – किसी टिप्पणी को अस्वीकार करता है, ताकि उसे दिखाया न जाए. ऐसा करने पर, अस्वीकार की गई टिप्पणी के सभी जवाब भी छिप जाते हैं. अपने चैनल या वीडियो से किसी दूसरे उपयोगकर्ता की टिप्पणी हटाने के लिए, उसके मॉडरेशन स्टेटस को rejected पर सेट करें. comments.delete तरीके का इस्तेमाल, सिर्फ़ टिप्पणी का मूल लेखक कर सकता है.
वैकल्पिक पैरामीटर
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 का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और रिस्पॉन्स देखें.