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 मान्य मुख्य वैल्यू ये हैं:
|
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 यह सदस्यता, सिर्फ़ अपलोड की गई हर चीज़ के लिए है. इस प्रॉपर्टी की मान्य वैल्यू हैं:
|
subscriberSnippet |
object subscriberSnippet ऑब्जेक्ट में, सदस्य के बारे में बुनियादी जानकारी मौजूद होती है. |
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 इमेज की ऊंचाई. |