Activities

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
    },
    "comment": {
      "resourceId": {
        "kind": string,
        "videoId": 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	object snippet ऑब्जेक्ट में गतिविधि के बारे में बुनियादी जानकारी होती है. जैसे, गतिविधि का टाइप और ग्रुप आईडी.
snippet.publishedAt	datetime गतिविधि होने की तारीख और समय. वैल्यू को ISO 8601 फ़ॉर्मैट में तय किया जाता है.
snippet.channelId	string यह वह आईडी है जिसका इस्तेमाल YouTube, गतिविधि से जुड़े चैनल की पहचान करने के लिए करता है.
snippet.title	string गतिविधि से मुख्य रूप से जुड़ा संसाधन का टाइटल.
snippet.description	string गतिविधि से जुड़े मुख्य संसाधन का ब्यौरा.
snippet.thumbnails	object यह उस संसाधन से जुड़ी थंबनेल इमेज का मैप है जो गतिविधि से जुड़ा है. मैप में मौजूद हर ऑब्जेक्ट के लिए, कुंजी थंबनेल इमेज का नाम होती है. साथ ही, वैल्यू एक ऐसा ऑब्जेक्ट होता है जिसमें थंबनेल के बारे में अन्य जानकारी होती है.
snippet.thumbnails.(key)	object कुंजी की मान्य वैल्यू ये हैं: default – डिफ़ॉल्ट थंबनेल इमेज. किसी वीडियो या वीडियो से जुड़े संसाधन (जैसे कि प्लेलिस्ट आइटम या खोज नतीजा) के लिए डिफ़ॉल्ट थंबनेल, 120 पिक्सल चौड़ा और 90 पिक्सल लंबा होता है. किसी चैनल के लिए डिफ़ॉल्ट थंबनेल 88 पिक्सल चौड़ा और 88 पिक्सल लंबा होता है. medium – थंबनेल इमेज का ज़्यादा रिज़ॉल्यूशन वाला वर्शन. किसी वीडियो (या वीडियो का रेफ़रंस देने वाले संसाधन) के लिए, इस इमेज की चौड़ाई 320 पिक्सल और लंबाई 180 पिक्सल होती है. किसी चैनल के लिए, यह इमेज 240 पिक्सल चौड़ी और 240 पिक्सल लंबी होती है. high – थंबनेल इमेज का हाई रिज़ॉल्यूशन वर्शन. किसी वीडियो (या वीडियो का रेफ़रंस देने वाले संसाधन) के लिए, इस इमेज की चौड़ाई 480 पिक्सल और ऊंचाई 360 पिक्सल होती है. किसी चैनल के लिए, यह इमेज 800 पिक्सल चौड़ी और 800 पिक्सल लंबी होती है. standard – थंबनेल इमेज का ऐसा वर्शन जिसका रिज़ॉल्यूशन, high रिज़ॉल्यूशन वाली इमेज से भी ज़्यादा हो. यह इमेज, कुछ वीडियो और वीडियो से जुड़े अन्य संसाधनों के लिए उपलब्ध होती है. जैसे, प्लेलिस्ट के आइटम या खोज के नतीजे. इस इमेज की चौड़ाई 640 पिक्सल और ऊंचाई 480 पिक्सल है. maxres – थंबनेल इमेज का सबसे ज़्यादा रिज़ॉल्यूशन वाला वर्शन. यह इमेज का साइज़, कुछ वीडियो और वीडियो से जुड़े अन्य संसाधनों के लिए उपलब्ध है. जैसे, प्लेलिस्ट के आइटम या खोज के नतीजे. यह इमेज 1280 पिक्सल चौड़ी और 720 पिक्सल लंबी है.
snippet.thumbnails.(key).url	string इमेज का यूआरएल.
snippet.thumbnails.(key).width	unsigned integer इमेज की चौड़ाई.
snippet.thumbnails.(key).height	unsigned integer इमेज की ऊंचाई.
snippet.channelTitle	string इस गतिविधि के लिए ज़िम्मेदार चैनल का टाइटल
snippet.type	string यह उस गतिविधि का टाइप है जिसके बारे में संसाधन बताता है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं: channelItem comment – (फ़िलहाल वापस नहीं किया गया) playlistItem promotedItem recommendation social upload
snippet.groupId	string गतिविधि से जुड़ा ग्रुप आईडी. ग्रुप आईडी से, एक ही उपयोगकर्ता और संसाधन से जुड़े उपयोगकर्ता इवेंट की पहचान होती है. उदाहरण के लिए, अगर कोई उपयोगकर्ता कोई वीडियो अपलोड करता है और उसे देखता है, तो उन इवेंट की एंट्री में उपयोगकर्ता की गतिविधि फ़ीड में एक ही ग्रुप आईडी होगा. अपने यूज़र इंटरफ़ेस में, एक ही groupId वैल्यू वाले इवेंट को ग्रुप करके, दोहराव से बचा जा सकता है.
contentDetails	object contentDetails ऑब्जेक्ट में, गतिविधि से जुड़े कॉन्टेंट के बारे में जानकारी होती है. उदाहरण के लिए, अगर snippet.type की वैल्यू videoRated है, तो contentDetails ऑब्जेक्ट का कॉन्टेंट, रेटिंग वाले वीडियो की पहचान करता है.
contentDetails.upload	object upload ऑब्जेक्ट में, अपलोड किए गए वीडियो के बारे में जानकारी होती है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब snippet.type की वैल्यू upload हो.
contentDetails.upload.videoId	string यह वह आईडी है जिसका इस्तेमाल YouTube, अपलोड किए गए वीडियो की पहचान करने के लिए करता है.
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.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 इस वजह से, संसाधन को उपयोगकर्ता के लिए सुझाया गया है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं: videoWatched
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 सोशल नेटवर्क का नाम. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं: facebook googlePlus twitter unspecified
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 ऑब्जेक्ट में ऐसी जानकारी होती है जिससे उस संसाधन की पहचान होती है जिसे चैनल में जोड़ा गया था.