subscription संसाधन में, YouTube का इस्तेमाल करने वाले किसी व्यक्ति की सदस्यता के बारे में जानकारी होती है. किसी चैनल की सदस्यता लेने पर, उपयोगकर्ता को सूचना मिलती है. यह सूचना तब मिलती है, जब चैनल पर नए वीडियो जोड़े जाते हैं या जब कोई दूसरा उपयोगकर्ता YouTube पर कई कार्रवाइयों में से कोई एक कार्रवाई करता है. जैसे, वीडियो अपलोड करना, वीडियो को रेटिंग देना या वीडियो पर टिप्पणी करना.
तरीके
एपीआई, subscriptions संसाधनों के लिए इन तरीकों का इस्तेमाल करता है:
- list
- यह एपीआई अनुरोध की शर्तों से मेल खाने वाले सदस्यता संसाधनों को दिखाता है. इसे अभी आज़माएं.
- insert
- इस कुकी का इस्तेमाल, पुष्टि किए गए उपयोगकर्ता के चैनल की सदस्यता जोड़ने के लिए किया जाता है. इसे अभी आज़माएं.
- मिटाएं
- सदस्यता मिटाता है. इसे अभी आज़माएं.
संसाधन का रेप्रज़ेंटेशन
यहां दिए गए 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इस संसाधन का ETag. |
id |
stringयह वह आईडी है जिसका इस्तेमाल YouTube, सदस्यता की खास तौर पर पहचान करने के लिए करता है. |
snippet |
objectsnippet ऑब्जेक्ट में, सदस्यता के बारे में बुनियादी जानकारी होती है. इसमें सदस्यता का टाइटल और वह चैनल शामिल होता है जिसकी सदस्यता उपयोगकर्ता ने ली है. |
snippet.publishedAt |
datetimeसदस्यता बनाने की तारीख और समय. इसकी वैल्यू ISO 8601 फ़ॉर्मैट में दी जाती है. |
snippet.title |
stringसदस्यता का नाम. |
snippet.description |
stringसदस्यता की जानकारी. |
snippet.resourceId |
objectid ऑब्जेक्ट में, उस चैनल के बारे में जानकारी होती है जिसकी सदस्यता उपयोगकर्ता ने ली है. |
snippet.resourceId.kind |
stringएपीआई संसाधन का टाइप. |
snippet.resourceId.channelId |
stringयह वह वैल्यू है जिसका इस्तेमाल YouTube, उस चैनल की खास तौर पर पहचान करने के लिए करता है जिसे उपयोगकर्ता ने सदस्यता ली है. |
snippet.channelId |
stringयह वह आईडी है जिसका इस्तेमाल YouTube, सदस्य के चैनल की पहचान करने के लिए करता है. resource_id ऑब्जेक्ट, उस चैनल की पहचान करता है जिसकी सदस्यता उपयोगकर्ता ने ली है. |
snippet.thumbnails |
objectसदस्यता से जुड़ी थंबनेल इमेज का मैप. मैप में मौजूद हर ऑब्जेक्ट के लिए, कुंजी थंबनेल इमेज का नाम होती है. साथ ही, वैल्यू एक ऐसा ऑब्जेक्ट होता है जिसमें थंबनेल के बारे में अन्य जानकारी होती है. |
snippet.thumbnails.(key) |
objectकुंजी की मान्य वैल्यू ये हैं:
|
snippet.thumbnails.(key).url |
stringइमेज का यूआरएल. |
snippet.thumbnails.(key).width |
unsigned integerइमेज की चौड़ाई. |
snippet.thumbnails.(key).height |
unsigned integerइमेज की ऊंचाई. |
contentDetails |
objectcontentDetails ऑब्जेक्ट में सदस्यता के बारे में बुनियादी आंकड़े शामिल होते हैं. |
contentDetails.totalItemCount |
unsigned integerउन आइटम की अनुमानित संख्या जिन पर सदस्यता लागू होती है. |
contentDetails.newItemCount |
unsigned integerपिछली बार कॉन्टेंट पढ़े जाने के बाद से, सदस्यता में शामिल किए गए नए आइटम की संख्या. |
contentDetails.activityType |
stringयह सदस्यता किस तरह की गतिविधि के लिए है (सिर्फ़ अपलोड, सभी). इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
subscriberSnippet |
objectsubscriberSnippet ऑब्जेक्ट में, सदस्य के बारे में बुनियादी जानकारी होती है. |
subscriberSnippet.title |
stringसदस्य के चैनल का टाइटल. |
subscriberSnippet.description |
stringसदस्य के चैनल का ब्यौरा. |
subscriberSnippet.channelId |
stringयह वह आईडी है जो YouTube, सदस्य के चैनल की पहचान करने के लिए असाइन करता है. |
subscriberSnippet.thumbnails |
objectसदस्यता लेने वाले व्यक्ति के चैनल के लिए थंबनेल इमेज. |
subscriberSnippet.thumbnails.(key) |
objectकुंजी की मान्य वैल्यू ये हैं:
|
subscriberSnippet.thumbnails.(key).url |
stringइमेज का यूआरएल. |
subscriberSnippet.thumbnails.(key).width |
unsigned integerइमेज की चौड़ाई. |
subscriberSnippet.thumbnails.(key).height |
unsigned integerइमेज की ऊंचाई. |