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 ऑब्जेक्ट में ऐसी जानकारी होती है जिससे उस संसाधन की पहचान होती है जिसे चैनल में जोड़ा गया था.