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 पिक्सल लंबा होता है. किसी चैनल के लिए डिफ़ॉल्ट थंबनेल 88 पिक्सल चौड़ा और 88 पिक्सल लंबा होता है.
  • 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 पिक्सल लंबा होता है. किसी चैनल के लिए डिफ़ॉल्ट थंबनेल 88 पिक्सल चौड़ा और 88 पिक्सल लंबा होता है.
  • 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
इमेज की ऊंचाई.