Activities: insert

YouTube ने चैनल बुलेटिन की सुविधा बंद कर दी है. इसलिए, अब इस तरीके का इस्तेमाल नहीं किया जा सकता.

ज़्यादा जानकारी के लिए, कृपया YouTube सहायता केंद्र पर जाएं.

यह कुकी, किसी चैनल के लिए बुलेटिन पोस्ट करती है. (अनुरोध सबमिट करने वाले व्यक्ति के पास, चैनल की ओर से कार्रवाई करने की अनुमति होनी चाहिए.)

ध्यान दें: भले ही, activity रिसॉर्स में ऐसी कार्रवाइयों के बारे में जानकारी शामिल हो सकती है जैसे कि किसी उपयोगकर्ता ने वीडियो को रेटिंग दी है या उसे पसंदीदा के तौर पर मार्क किया है. हालांकि, आपको उन activity रिसॉर्स को जनरेट करने के लिए, अन्य एपीआई तरीकों का इस्तेमाल करना होगा. उदाहरण के लिए, किसी वीडियो को रेटिंग देने के लिए एपीआई के videos.rate() तरीके का इस्तेमाल किया जाता है. वहीं, किसी वीडियो को पसंदीदा के तौर पर मार्क करने के लिए playlistItems.insert() तरीके का इस्तेमाल किया जाता है.

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

अनुरोध

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

POST https://www.googleapis.com/youtube/v3/activities

अनुमति देना

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

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

पैरामीटर

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

पैरामीटर
ज़रूरी पैरामीटर
part string
इस ऑपरेशन में, part पैरामीटर दो काम करता है. इससे उन प्रॉपर्टी का पता चलता है जिन्हें राइट ऑपरेशन सेट करेगा. साथ ही, उन प्रॉपर्टी का भी पता चलता है जिन्हें एपीआई रिस्पॉन्स में शामिल किया जाएगा.

यहां दी गई सूची में, part नाम दिए गए हैं जिन्हें पैरामीटर वैल्यू में शामिल किया जा सकता है:
  • contentDetails
  • id
  • snippet

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

अनुरोध के मुख्य हिस्से में, गतिविधि का संसाधन उपलब्ध कराएं. उस संसाधन के लिए:

  • इन प्रॉपर्टी के लिए वैल्यू तय करना ज़रूरी है:

    • snippet.description
  • इन प्रॉपर्टी के लिए वैल्यू सेट की जा सकती हैं:

    • snippet.description
    • contentDetails.bulletin.resourceId

जवाब

अगर यह तरीका काम करता है, तो जवाब के मुख्य हिस्से में गतिविधि संसाधन दिखता है.

गड़बड़ियां

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

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
badRequest (400) bulletinTextRequired अनुरोध में, बुलेटिन पोस्ट के लिए टेक्स्ट देने के लिए, snippet ऑब्जेक्ट की description प्रॉपर्टी का इस्तेमाल करना ज़रूरी है.
badRequest (400) invalidMetadata kind प्रॉपर्टी, दिए गए आईडी के टाइप से मेल नहीं खाती.
forbidden (403) forbidden अनुरोध को सही तरीके से अनुमति नहीं दी गई है.
notFound (404) playlistNotFound YouTube को वह वीडियो नहीं मिल रहा है जिसे आपको बुलेटिन पोस्ट से जोड़ना है. contentDetails.bulletinPosted.playlistId प्रॉपर्टी की वैल्यू देखें.
notFound (404) videoNotFound YouTube को वह वीडियो नहीं मिल रहा है जिसे आपको बुलेटिन पोस्ट से जोड़ना है. contentDetails.bulletinPosted.videoId प्रॉपर्टी की वैल्यू देखें.
userRateLimitExceeded (403) rateLimitExceeded आपका अनुरोध पूरा नहीं किया जा सकता, क्योंकि आपने कोटा पार कर लिया है.