activities.list
तरीका यह करता है अब भी चैनल बुलेटिन नहीं दिखाते और activities.insert
तरीका नहीं है लंबे समय तक काम करता है. ज़्यादा जानकारी के लिए, कृपया यह देखें YouTube सहायता केंद्र.activity
संसाधन में, YouTube पर किसी खास चैनल या उपयोगकर्ता की कार्रवाई के बारे में जानकारी मौजूद होती है. गतिविधि फ़ीड में, वीडियो को रेटिंग देना, वीडियो शेयर करना, वीडियो को पसंदीदा के तौर पर मार्क करना, वीडियो अपलोड करना वगैरह शामिल हैं. हर activity
संसाधन, कार्रवाई के टाइप, कार्रवाई से जुड़े चैनल, और कार्रवाई से जुड़े संसाधनों की पहचान करता है, जैसे कि वह वीडियो जिसे रेटिंग दी गई या अपलोड किया गया था.
तरीके
एपीआई, activities
संसाधनों के लिए इन तरीकों के साथ काम करता है:
- list
- अनुरोध की शर्तों से मेल खाने वाली चैनल गतिविधि के इवेंट की सूची दिखाता है. उदाहरण के लिए, किसी चैनल या उपयोगकर्ता के चैनल से जुड़े इवेंट फिर से हासिल किए जा सकते हैं. इसे अभी आज़माएं.
activities.insert
तरीका अब काम नहीं करता.
संसाधन दिखाने का तरीका
यहां दिए गए JSON फ़ॉर्मैट में, activities
संसाधन का फ़ॉर्मैट दिखाया गया है:
{ "kind": "youtube#activity", "etag": etag, "id": string, "snippet": { "publishedAt": datetime, "channelId": string, "title": string, "description": string, "thumbnails": { (key): { "url": string, "width": unsigned integer, "height": unsigned integer } }, "channelTitle": string, "type": string, "groupId": string }, "contentDetails": { "upload": { "videoId": string }, "like": { "resourceId": { "kind": string, "videoId": string, } }, "favorite": { "resourceId": { "kind": string, "videoId": string, } }, "comment": { "resourceId": { "kind": string, "videoId": string, "channelId": string, } }, "subscription": { "resourceId": { "kind": string, "channelId": string, } }, "playlistItem": { "resourceId": { "kind": string, "videoId": string, }, "playlistId": string, "playlistItemId": string }, "recommendation": { "resourceId": { "kind": string, "videoId": string, "channelId": string, }, "reason": string, "seedResourceId": { "kind": string, "videoId": string, "channelId": string, "playlistId": string } }, "social": { "type": string, "resourceId": { "kind": string, "videoId": string, "channelId": string, "playlistId": string }, "author": string, "referenceUrl": string, "imageUrl": string }, "channelItem": { "resourceId": { } }, } }
प्रॉपर्टी
नीचे दी गई टेबल में, इस संसाधन में मौजूद प्रॉपर्टी के बारे में बताया गया है:
प्रॉपर्टी | |
---|---|
kind | string यह एपीआई संसाधन के टाइप की पहचान करता है. वैल्यू youtube#activity होगी. |
etag | etag इस संसाधन का इटैग. |
id | string वह आईडी जिसका इस्तेमाल YouTube किसी गतिविधि की खास तरह से पहचान करने के लिए करता है. |
snippet | object snippet ऑब्जेक्ट में, गतिविधि के बारे में बुनियादी जानकारी होती है. इसमें गतिविधि का टाइप और ग्रुप आईडी शामिल है. |
snippet.publishedAt | datetime गतिविधि की तारीख और समय. वैल्यू, ISO 8601 फ़ॉर्मैट में होती है. |
snippet.channelId | string वह आईडी जिसका इस्तेमाल YouTube, गतिविधि से जुड़े चैनल की खास पहचान करने के लिए करता है. |
snippet.title | string गतिविधि से जुड़े संसाधन का टाइटल. |
snippet.description | string गतिविधि से जुड़े संसाधन की जानकारी. |
snippet.thumbnails | object किसी गतिविधि से जुड़ी मुख्य गतिविधि की थंबनेल इमेज का मैप. मैप में हर ऑब्जेक्ट के लिए, थंबनेल इमेज का नाम ही कुंजी होता है. वैल्यू एक ऑब्जेक्ट होता है, जिसमें थंबनेल के बारे में अन्य जानकारी होती है. |
snippet.thumbnails.(key) | object मान्य मुख्य वैल्यू ये हैं:
|
snippet.thumbnails.(key).url | string इमेज का यूआरएल. |
snippet.thumbnails.(key).width | unsigned integer इमेज की चौड़ाई. |
snippet.thumbnails.(key).height | unsigned integer इमेज की ऊंचाई. |
snippet.channelTitle | string इस गतिविधि के लिए ज़िम्मेदार चैनल के टाइटल |
snippet.type | string ऐसी गतिविधि का टाइप जिसके बारे में संसाधन में बताया गया है.इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
snippet.groupId | string गतिविधि से जुड़ा ग्रुप आईडी. ग्रुप आईडी, एक ही उपयोगकर्ता और संसाधन से जुड़े उपयोगकर्ता इवेंट की पहचान करता है. उदाहरण के लिए, अगर कोई उपयोगकर्ता किसी वीडियो को रेटिंग देता है और उसी वीडियो को पसंदीदा के तौर पर मार्क करता है, तो उन इवेंट के लिए उपयोगकर्ता के गतिविधि फ़ीड में मौजूद एंट्री का ग्रुप आईडी एक ही होगा. आपके यूज़र इंटरफ़ेस में, groupId की एक ही वैल्यू वाले इवेंट को ग्रुप करके, दोहराव से बचा जा सकता है. |
contentDetails | object contentDetails ऑब्जेक्ट में, गतिविधि से जुड़े कॉन्टेंट की जानकारी होती है. उदाहरण के लिए, अगर snippet.type की वैल्यू videoRated है, तो contentDetails ऑब्जेक्ट के कॉन्टेंट से रेट किए गए वीडियो की पहचान होती है. |
contentDetails.upload | object upload ऑब्जेक्ट में, अपलोड किए गए वीडियो की जानकारी होती है. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब snippet.type की वैल्यू upload हो. |
contentDetails.upload.videoId | string वह आईडी जिसका इस्तेमाल YouTube, अपलोड किए गए वीडियो की खास तरह से पहचान करने के लिए करता है. |
contentDetails.like | object like ऑब्जेक्ट में, उस संसाधन के बारे में जानकारी होती है जिसे अच्छी (लाइक) रेटिंग मिली है. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब snippet.type की वैल्यू like हो. |
contentDetails.like.resourceId | object resourceId ऑब्जेक्ट में ऐसी जानकारी होती है जो रेट किए गए संसाधन की पहचान करती है. |
contentDetails.like.resourceId.kind | string एपीआई रिसॉर्स का टाइप. |
contentDetails.like.resourceId.videoId | string वह आईडी जिसका इस्तेमाल YouTube, वीडियो की खास पहचान करने के लिए करता है. हालांकि, ऐसा तब ही किया जाएगा, जब रेट किया गया संसाधन कोई वीडियो हो. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब resourceId.kind की वैल्यू youtube#video हो. |
contentDetails.favorite | object favorite ऑब्जेक्ट में, पसंदीदा वीडियो के तौर पर मार्क किए गए वीडियो की जानकारी है. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब snippet.type की वैल्यू favorite हो. |
contentDetails.favorite.resourceId | object resourceId ऑब्जेक्ट में ऐसी जानकारी है जो पसंदीदा के तौर पर मार्क किए गए संसाधन की पहचान करती है. |
contentDetails.favorite.resourceId.kind | string एपीआई रिसॉर्स का टाइप. |
contentDetails.favorite.resourceId.videoId | string वह आईडी जिसका इस्तेमाल YouTube, पसंदीदा वीडियो की खास तरह से पहचान करने के लिए करता है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब resourceId.kind youtube#video हो.ध्यान दें: activities.list वाला तरीका फ़िलहाल नई टिप्पणियों के लिए संसाधन नहीं दिखाता है. |
contentDetails.comment | object comment ऑब्जेक्ट में, उस संसाधन की जानकारी होती है जिस पर टिप्पणी की गई है. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब snippet.type की वैल्यू comment हो. |
contentDetails.comment.resourceId | object resourceId ऑब्जेक्ट में ऐसी जानकारी होती है जो टिप्पणी से जुड़े संसाधन की पहचान करती है. |
contentDetails.comment.resourceId.kind | string एपीआई रिसॉर्स का टाइप. |
contentDetails.comment.resourceId.videoId | string वह आईडी जिसका इस्तेमाल YouTube किसी टिप्पणी से जुड़े वीडियो की खास तरह से पहचान करने के लिए करता है. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब resourceId.kind की वैल्यू youtube#video हो. |
contentDetails.comment.resourceId.channelId | string वह आईडी जिसका इस्तेमाल YouTube किसी टिप्पणी से जुड़े चैनल की खास तरह से पहचान करने के लिए करता है. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब resourceId.kind की वैल्यू youtube#channel हो. |
contentDetails.subscription | object subscription ऑब्जेक्ट में उस चैनल की जानकारी होती है जिसकी उपयोगकर्ता ने सदस्यता ली है. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब snippet.type की वैल्यू subscription हो. |
contentDetails.subscription.resourceId | object resourceId ऑब्जेक्ट में ऐसी जानकारी होती है जो उस संसाधन की पहचान करती है जिसकी उपयोगकर्ता ने सदस्यता ली है. |
contentDetails.subscription.resourceId.kind | string एपीआई रिसॉर्स का टाइप. |
contentDetails.subscription.resourceId.channelId | string वह आईडी जिसका इस्तेमाल YouTube, उस चैनल की खास पहचान करने के लिए करता है जिसकी सदस्यता उपयोगकर्ता ने ली है. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब resourceId.kind की वैल्यू youtube#channel हो. |
contentDetails.playlistItem | object playlistItem ऑब्जेक्ट में, प्लेलिस्ट के नए आइटम के बारे में जानकारी होती है. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब snippet.type की वैल्यू playlistItem हो. |
contentDetails.playlistItem.resourceId | object resourceId ऑब्जेक्ट में ऐसी जानकारी होती है जो प्लेलिस्ट में जोड़े गए संसाधन की पहचान करती है. |
contentDetails.playlistItem.resourceId.kind | string एपीआई रिसॉर्स का टाइप. |
contentDetails.playlistItem.resourceId.videoId | string वह आईडी जिसका इस्तेमाल YouTube, प्लेलिस्ट में जोड़े गए वीडियो की खास तरह से पहचान करने के लिए करता है. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब resourceId.kind की वैल्यू youtube#video हो. |
contentDetails.playlistItem.playlistId | string वह वैल्यू जिसका इस्तेमाल YouTube, प्लेलिस्ट की खास तरह से पहचान करने के लिए करता है. |
contentDetails.playlistItem.playlistItemId | string वह वैल्यू जिसे YouTube, प्लेलिस्ट में मौजूद किसी आइटम की खास तरह से पहचान करने के लिए इस्तेमाल करता है. |
contentDetails.recommendation | object recommendation ऑब्जेक्ट में, सुझाए गए संसाधन के बारे में जानकारी मौजूद है. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब snippet.type की वैल्यू recommendation हो. |
contentDetails.recommendation.resourceId | object resourceId ऑब्जेक्ट में ऐसी जानकारी है जो सुझाए गए संसाधन की पहचान करती है. |
contentDetails.recommendation.resourceId.kind | string एपीआई रिसॉर्स का टाइप. |
contentDetails.recommendation.resourceId.videoId | string वह आईडी जिसे YouTube किसी वीडियो की पहचान करने के लिए इस्तेमाल करता है. हालांकि, ऐसा तभी किया जाएगा, जब सुझाया गया संसाधन कोई वीडियो हो. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब resourceId.kind की वैल्यू youtube#video हो. |
contentDetails.recommendation.resourceId.channelId | string वह आईडी जिसे YouTube, किसी चैनल की खास तरह से पहचान करने के लिए इस्तेमाल करता है. हालांकि, ऐसा तभी किया जाएगा, जब सुझाया गया संसाधन कोई चैनल हो. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब resourceId.kind की वैल्यू youtube#channel हो. |
contentDetails.recommendation.reason | string उपयोगकर्ता को संसाधन के सुझाव देने की वजह.इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.recommendation.seedResourceId | object seedResourceId ऑब्जेक्ट में, सुझाव देने वाले संसाधन के बारे में जानकारी होती है. |
contentDetails.recommendation.seedResourceId.kind | string एपीआई रिसॉर्स का टाइप. |
contentDetails.recommendation.seedResourceId.videoId | string वह आईडी जिसे YouTube किसी वीडियो की पहचान करने के लिए इस्तेमाल करता है. ऐसा तब होता है, जब वीडियो के लिए सुझाव दिया गया हो. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब seedResourceId.kind की वैल्यू youtube#video हो. |
contentDetails.recommendation.seedResourceId.channelId | string वह आईडी जिसे YouTube किसी चैनल की खास पहचान के लिए इस्तेमाल करता है. ऐसा तब होता है, जब सुझाव किसी खास चैनल से मिला हो. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब seedResourceId.kind की वैल्यू youtube#channel हो. |
contentDetails.recommendation.seedResourceId.playlistId | string वह आईडी जिसका इस्तेमाल YouTube किसी प्लेलिस्ट की खास तरह से पहचान करने के लिए करता है. ऐसा तब होता है, जब सुझाव के तौर पर किसी प्लेलिस्ट का सुझाव दिया गया हो. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब seedResourceId.kind की वैल्यू youtube#playlist हो. |
contentDetails.social | object social ऑब्जेक्ट में सोशल नेटवर्क की पोस्ट की जानकारी शामिल है. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब snippet.type की वैल्यू social हो. |
contentDetails.social.type | string सोशल नेटवर्क का नाम.इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.social.resourceId | object resourceId ऑब्जेक्ट, वह जानकारी इकट्ठा करता है जो किसी सोशल नेटवर्क पोस्ट से जुड़े संसाधन की पहचान करती है. |
contentDetails.social.resourceId.kind | string एपीआई रिसॉर्स का टाइप. |
contentDetails.social.resourceId.videoId | string वह आईडी जिसका इस्तेमाल YouTube किसी सोशल नेटवर्क की पोस्ट में दिखाए गए वीडियो की पहचान करने के लिए करता है. ऐसा तब होता है, जब वह पोस्ट किसी वीडियो के बारे में हो. यह प्रॉपर्टी सिर्फ़ तब दिखेगी, जब social.resourceId.kind प्रॉपर्टी की वैल्यू youtube#video हो. |
contentDetails.social.resourceId.channelId | string वह आईडी जिसे YouTube किसी सोशल नेटवर्क की पोस्ट में दिखाए गए चैनल की खास पहचान के लिए इस्तेमाल करता है. ऐसा तब होता है, जब वह पोस्ट किसी चैनल के बारे में हो. यह प्रॉपर्टी सिर्फ़ तब दिखेगी, जब social.resourceId.kind प्रॉपर्टी की वैल्यू youtube#channel हो. |
contentDetails.social.resourceId.playlistId | string वह आईडी जिसका इस्तेमाल YouTube किसी सोशल नेटवर्क की पोस्ट में दिखाई गई प्लेलिस्ट की खास तरह से पहचान करने के लिए करता है. ऐसा तब होता है, जब वह पोस्ट किसी प्लेलिस्ट के बारे में हो. यह प्रॉपर्टी सिर्फ़ तब दिखेगी, जब social.resourceId.kind प्रॉपर्टी की वैल्यू youtube#playlist हो. |
contentDetails.social.author | string सोशल नेटवर्क पर पोस्ट लिखने वाला व्यक्ति. |
contentDetails.social.referenceUrl | string सोशल नेटवर्क की पोस्ट का यूआरएल. |
contentDetails.social.imageUrl | string पोस्ट के लेखक की इमेज. |
contentDetails.channelItem | object channelItem ऑब्जेक्ट में, चैनल में जोड़े गए संसाधन की जानकारी मौजूद है. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब snippet.type की वैल्यू channelItem हो. |
contentDetails.channelItem.resourceId | object resourceId ऑब्जेक्ट में ऐसी जानकारी है जो चैनल में जोड़े गए संसाधन की पहचान करती है. |