activity रिसॉर्स में, किसी चैनल या उपयोगकर्ता की YouTube पर की गई कार्रवाई के बारे में जानकारी होती है. गतिविधि फ़ीड में, वीडियो को रेटिंग देना, वीडियो शेयर करना, वीडियो को पसंदीदा के तौर पर मार्क करना, वीडियो अपलोड करना वगैरह जैसी कार्रवाइयों की जानकारी दी जाती है. हर activity संसाधन से, कार्रवाई के टाइप, कार्रवाई से जुड़े चैनल, और कार्रवाई से जुड़े संसाधनों की पहचान होती है. जैसे, जिस वीडियो को रेटिंग दी गई है या अपलोड किया गया है.
तरीके
एपीआई, activities संसाधनों के लिए इन तरीकों का इस्तेमाल करता है:
- list
- यह अनुरोध की शर्तों से मेल खाने वाले, चैनल की गतिविधि से जुड़े इवेंट की सूची दिखाता है. उदाहरण के लिए, किसी चैनल या उपयोगकर्ता के चैनल से जुड़े इवेंट वापस लाए जा सकते हैं. इसे अभी आज़माएं.
संसाधन का रेप्रज़ेंटेशन
यहां दिए गए 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इस संसाधन का ETag. |
id |
stringयह वह आईडी है जिसका इस्तेमाल YouTube, गतिविधि की पहचान करने के लिए करता है. |
snippet |
objectsnippet ऑब्जेक्ट में गतिविधि के बारे में बुनियादी जानकारी होती है. जैसे, गतिविधि का टाइप और ग्रुप आईडी. |
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 |
stringThe type of activity that the resource describes. Valid values for this property are:
|
snippet.groupId |
stringगतिविधि से जुड़ा ग्रुप आईडी. ग्रुप आईडी से, ऐसे उपयोगकर्ता इवेंट की पहचान होती है जो एक ही उपयोगकर्ता और संसाधन से जुड़े होते हैं. उदाहरण के लिए, अगर कोई उपयोगकर्ता किसी वीडियो को रेटिंग देता है और उसी वीडियो को पसंदीदा के तौर पर मार्क करता है, तो उन इवेंट की एंट्री में उपयोगकर्ता की गतिविधि फ़ीड में एक ही ग्रुप आईडी होगा. अपने यूज़र इंटरफ़ेस में, एक ही groupId वैल्यू वाले इवेंट को ग्रुप करके, दोहराव से बचा जा सकता है. |
contentDetails |
objectcontentDetails ऑब्जेक्ट में, गतिविधि से जुड़े कॉन्टेंट के बारे में जानकारी होती है. उदाहरण के लिए, अगर snippet.type की वैल्यू videoRated है, तो contentDetails ऑब्जेक्ट का कॉन्टेंट, रेटिंग वाले वीडियो की पहचान करता है. |
contentDetails.upload |
objectupload ऑब्जेक्ट में, अपलोड किए गए वीडियो के बारे में जानकारी होती है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब snippet.type की वैल्यू upload हो. |
contentDetails.upload.videoId |
stringयह वह आईडी है जिसका इस्तेमाल YouTube, अपलोड किए गए वीडियो की पहचान करने के लिए करता है. |
contentDetails.like |
objectlike ऑब्जेक्ट में, उस संसाधन के बारे में जानकारी होती है जिसे पॉज़िटिव (पसंद करें) रेटिंग मिली है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब snippet.type की वैल्यू like हो. |
contentDetails.like.resourceId |
objectresourceId ऑब्जेक्ट में ऐसी जानकारी होती है जिससे रेटिंग वाले संसाधन की पहचान की जा सकती है. |
contentDetails.like.resourceId.kind |
stringएपीआई संसाधन का टाइप. |
contentDetails.like.resourceId.videoId |
stringअगर रेटिंग दिया गया संसाधन कोई वीडियो है, तो यह वह आईडी होता है जिसका इस्तेमाल YouTube वीडियो की खास तौर पर पहचान करने के लिए करता है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब resourceId.kind की वैल्यू youtube#video हो. |
contentDetails.favorite |
objectfavorite ऑब्जेक्ट में, उस वीडियो के बारे में जानकारी होती है जिसे पसंदीदा वीडियो के तौर पर मार्क किया गया था. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब snippet.type की वैल्यू favorite हो. |
contentDetails.favorite.resourceId |
objectresourceId ऑब्जेक्ट में ऐसी जानकारी होती है जिससे उस संसाधन की पहचान होती है जिसे पसंदीदा के तौर पर मार्क किया गया था. |
contentDetails.favorite.resourceId.kind |
stringएपीआई संसाधन का टाइप. |
contentDetails.favorite.resourceId.videoId |
stringयह वह आईडी है जिसका इस्तेमाल YouTube, पसंदीदा वीडियो की पहचान करने के लिए करता है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब resourceId.kind youtube#video हो.ध्यान दें: फ़िलहाल, activities.list तरीके से नई टिप्पणियों के संसाधन नहीं मिलते. |
contentDetails.comment |
objectcomment ऑब्जेक्ट में, उस संसाधन के बारे में जानकारी होती है जिस पर टिप्पणी की गई है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब snippet.type की वैल्यू comment हो. |
contentDetails.comment.resourceId |
objectresourceId ऑब्जेक्ट में ऐसी जानकारी होती है जिससे उस संसाधन की पहचान होती है जो टिप्पणी से जुड़ा है. |
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 |
objectsubscription ऑब्जेक्ट में, उस चैनल के बारे में जानकारी होती है जिसकी सदस्यता उपयोगकर्ता ने ली है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब snippet.type की वैल्यू subscription हो. |
contentDetails.subscription.resourceId |
objectresourceId ऑब्जेक्ट में ऐसी जानकारी होती है जिससे उस संसाधन की पहचान होती है जिसकी सदस्यता उपयोगकर्ता ने ली है. |
contentDetails.subscription.resourceId.kind |
stringएपीआई संसाधन का टाइप. |
contentDetails.subscription.resourceId.channelId |
stringयह वह आईडी है जिसका इस्तेमाल YouTube, उस चैनल की पहचान करने के लिए करता है जिसे उपयोगकर्ता ने सदस्यता ली है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब resourceId.kind की वैल्यू youtube#channel हो. |
contentDetails.playlistItem |
objectplaylistItem ऑब्जेक्ट में, नई प्लेलिस्ट आइटम के बारे में जानकारी होती है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब snippet.type की वैल्यू playlistItem हो. |
contentDetails.playlistItem.resourceId |
objectresourceId ऑब्जेक्ट में, उस संसाधन की पहचान करने वाली जानकारी होती है जिसे प्लेलिस्ट में जोड़ा गया था. |
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 |
objectrecommendation ऑब्जेक्ट में, सुझाए गए संसाधन के बारे में जानकारी होती है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब snippet.type की वैल्यू recommendation हो. |
contentDetails.recommendation.resourceId |
objectresourceId ऑब्जेक्ट में ऐसी जानकारी होती है जिससे सुझाए गए संसाधन की पहचान होती है. |
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 |
objectseedResourceId ऑब्जेक्ट में, उस संसाधन के बारे में जानकारी होती है जिसकी वजह से सुझाव दिया गया है. |
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 |
objectsocial ऑब्जेक्ट में, सोशल नेटवर्क पर की गई पोस्ट के बारे में जानकारी होती है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब snippet.type की वैल्यू social हो. |
contentDetails.social.type |
stringसोशल नेटवर्क का नाम. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.social.resourceId |
objectresourceId ऑब्जेक्ट में ऐसी जानकारी शामिल होती है जिससे सोशल नेटवर्क पोस्ट से जुड़े संसाधन की पहचान होती है. |
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 |
objectchannelItem ऑब्जेक्ट में, चैनल में जोड़े गए संसाधन के बारे में जानकारी होती है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब snippet.type की वैल्यू channelItem हो. |
contentDetails.channelItem.resourceId |
objectresourceId ऑब्जेक्ट में, चैनल में जोड़े गए संसाधन की पहचान करने वाली जानकारी होती है. |