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 अनुरोध पूरा नहीं किया जा सकता, क्योंकि आपने अपना कोटा पार कर लिया है.