Subscriptions

subscription संसाधन में YouTube उपयोगकर्ता की सदस्यता के बारे में जानकारी होती है. किसी चैनल में नया वीडियो जोड़े जाने पर या कोई दूसरा उपयोगकर्ता जब YouTube पर कोई वीडियो अपलोड करता है, वीडियो को रेटिंग देता है या किसी वीडियो पर टिप्पणी करता है, तो सदस्यता उपयोगकर्ता को इसकी सूचना देती है.

तरीके

एपीआई subscriptions रिसॉर्स के लिए, इन तरीकों का इस्तेमाल करता है:

list

एपीआई अनुरोध की शर्तें पूरी करने वाले सदस्यता संसाधन दिखाता है इसे अभी आज़माएं.

शामिल करें

पुष्टि किए गए उपयोगकर्ता के चैनल की सदस्यता जोड़ता है. इसे अभी आज़माएं.

मिटाएं

सदस्यता मिटाता है. इसे अभी आज़माएं.

संसाधन का प्रतिनिधित्व

JSON के इस फ़ॉर्मैट में subscriptions संसाधन का फ़ॉर्मैट दिखता है:

{
  "kind": "youtube#subscription",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelTitle": string,
    "title": string,
    "description": string,
    "resourceId": {
      "kind": string,
      "channelId": string,
    },
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  },
  "contentDetails": {
    "totalItemCount": unsigned integer,
    "newItemCount": unsigned integer,
    "activityType": string
  },
  "subscriberSnippet": {
    "title": string,
    "description": string,
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  }
}

प्रॉपर्टी

इस टेबल में उन प्रॉपर्टी के बारे में बताया गया है जो इस रिसॉर्स में मौजूद हैं:

प्रॉपर्टी
kind	string इससे यह पता चलता है कि एपीआई संसाधन किस तरह का है. वैल्यू youtube#subscription होगी.
etag	etag इस संसाधन का ऐट.
id	string वह आईडी जिसका इस्तेमाल YouTube, सदस्यता की पहचान करने के लिए करता है.
snippet	object snippet ऑब्जेक्ट में सदस्यता के बारे में बुनियादी जानकारी मौजूद होती है. इसमें, चैनल का शीर्षक और वह चैनल शामिल है जिसकी सदस्यता उपयोगकर्ता ने ली है.
snippet.publishedAt	datetime सदस्यता लेने की तारीख और समय. वैल्यू ISO 8601 फ़ॉर्मैट में दी जाती है.
snippet.channelTitle	string उस चैनल का शीर्षक जिसकी सदस्यता ली गई है.
snippet.title	string सदस्यता का शीर्षक.
snippet.description	string सदस्यता की जानकारी.
snippet.resourceId	object id ऑब्जेक्ट में उस चैनल के बारे में जानकारी होती है जिसकी सदस्यता उपयोगकर्ता ने ली है.
snippet.resourceId.kind	string एपीआई संसाधन का टाइप.
snippet.resourceId.channelId	string वह वैल्यू जिसका इस्तेमाल YouTube, उपयोगकर्ता की सदस्यता लेने वाले चैनल को पहचानने के लिए करता है.
snippet.channelId	string वह आईडी जिसका इस्तेमाल YouTube, सदस्य के चैनल की खास तौर पर पहचान करने के लिए करता है. resource_id ऑब्जेक्ट, उस चैनल की पहचान करता है जिसकी सदस्यता उपयोगकर्ता ने ली है.
snippet.thumbnails	object सदस्यता से जुड़ी थंबनेल इमेज का मैप. मैप पर मौजूद हर ऑब्जेक्ट के लिए, थंबनेल इमेज का नाम बटन होता है. वैल्यू में एक ऐसा ऑब्जेक्ट होता है जिसमें थंबनेल के बारे में दूसरी जानकारी होती है.
snippet.thumbnails.(key)	object मान्य मुख्य वैल्यू ये हैं: default – इस संसाधन के लिए डिफ़ॉल्ट थंबनेल इमेज. आम तौर पर, वीडियो का डिफ़ॉल्ट थंबनेल, 120 पिक्सल चौड़ा और 90 पिक्सल लंबा होता है. आम तौर पर, वीडियो का रेफ़रंस, जैसे कि प्लेलिस्ट आइटम या खोज के नतीजे के तौर पर इस्तेमाल किया जाता है. चैनल के लिए डिफ़ॉल्ट थंबनेल 88px चौड़ा और 88px लंबा होता है. medium – थंबनेल इमेज का ज़्यादा रिज़ॉल्यूशन वाला वर्शन होता है. वीडियो (या किसी वीडियो का संदर्भ देने वाले संसाधन) के लिए, यह इमेज 320 पिक्सल चौड़ी और 180 पिक्सल लंबी है. चैनल के लिए, यह इमेज 240 पिक्सल चौड़ी और 240 पिक्सल लंबी है. high – थंबनेल इमेज का हाई रिज़ॉल्यूशन वाला वर्शन होता है. वीडियो (या संसाधन को बताने वाला संसाधन) के लिए, यह इमेज 480 पिक्सल चौड़ी और 360 पिक्सल लंबी है. चैनल के लिए, यह इमेज 800 पिक्सल चौड़ी और 800 पिक्सल लंबी है.
snippet.thumbnails.(key).url	string इमेज का यूआरएल.
snippet.thumbnails.(key).width	unsigned integer इमेज की चौड़ाई.
snippet.thumbnails.(key).height	unsigned integer इमेज की ऊंचाई.
contentDetails	object contentDetails ऑब्जेक्ट में, सदस्यता से जुड़े बुनियादी आंकड़े शामिल होते हैं.
contentDetails.totalItemCount	unsigned integer उन आइटम की अनुमानित संख्या जिन पर सदस्यता ले जाती है.
contentDetails.newItemCount	unsigned integer सदस्यता में नए आइटम की संख्या, क्योंकि इसे पिछली बार पढ़ा गया था.
contentDetails.activityType	string यह सदस्यता, सिर्फ़ अपलोड की गई हर चीज़ के लिए है. इस प्रॉपर्टी की मान्य वैल्यू हैं: all uploads
subscriberSnippet	object subscriberSnippet ऑब्जेक्ट में, सदस्य के बारे में बुनियादी जानकारी मौजूद होती है.
subscriberSnippet.title	string सदस्य के चैनल का शीर्षक.
subscriberSnippet.description	string सदस्य के चैनल का ब्यौरा.
subscriberSnippet.channelId	string वह आईडी जो YouTube असाइन करता है, ताकि सदस्य के चैनल की पहचान खास तरीके से की जा सके.
subscriberSnippet.thumbnails	object सदस्य के चैनल के लिए थंबनेल इमेज.
subscriberSnippet.thumbnails.(key)	object मान्य मुख्य वैल्यू ये हैं: default – इस संसाधन के लिए डिफ़ॉल्ट थंबनेल इमेज. आम तौर पर, वीडियो का डिफ़ॉल्ट थंबनेल, 120 पिक्सल चौड़ा और 90 पिक्सल लंबा होता है. आम तौर पर, वीडियो का रेफ़रंस, जैसे कि प्लेलिस्ट आइटम या खोज के नतीजे के तौर पर इस्तेमाल किया जाता है. चैनल के लिए डिफ़ॉल्ट थंबनेल 88px चौड़ा और 88px लंबा होता है. medium – थंबनेल इमेज का ज़्यादा रिज़ॉल्यूशन वाला वर्शन होता है. वीडियो (या किसी वीडियो का संदर्भ देने वाले संसाधन) के लिए, यह इमेज 320 पिक्सल चौड़ी और 180 पिक्सल लंबी है. चैनल के लिए, यह इमेज 240 पिक्सल चौड़ी और 240 पिक्सल लंबी है. high – थंबनेल इमेज का हाई रिज़ॉल्यूशन वाला वर्शन होता है. वीडियो (या संसाधन को बताने वाला संसाधन) के लिए, यह इमेज 480 पिक्सल चौड़ी और 360 पिक्सल लंबी है. चैनल के लिए, यह इमेज 800 पिक्सल चौड़ी और 800 पिक्सल लंबी है.
subscriberSnippet.thumbnails.(key).url	string इमेज का यूआरएल.
subscriberSnippet.thumbnails.(key).width	unsigned integer इमेज की चौड़ाई.
subscriberSnippet.thumbnails.(key).height	unsigned integer इमेज की ऊंचाई.