video संसाधन, YouTube वीडियो को दिखाता है.
तरीके
एपीआई, videos संसाधनों के लिए इन तरीकों का इस्तेमाल करता है:
- getRating
- यह अनुमति वाले उपयोगकर्ता की ओर से, चुनिंदा वीडियो की सूची को दी गई रेटिंग को वापस लाता है. इसे अभी आज़माएं.
- list
- इससे उन वीडियो की सूची मिलती है जो एपीआई अनुरोध के पैरामीटर से मैच करते हैं. इसे अभी आज़माएं.
- batchGetStats
- एपीआई अनुरोध के पैरामीटर से मैच करने वाले वीडियो के आंकड़ों की सूची दिखाता है. इसे अभी आज़माएं.
- insert
- YouTube पर वीडियो अपलोड करता है और वीडियो का मेटाडेटा सेट करता है. हालांकि, मेटाडेटा सेट करना ज़रूरी नहीं है.
- अपडेट
- वीडियो के मेटाडेटा को अपडेट करता है. इसे अभी आज़माएं.
- मिटाएं
- YouTube वीडियो मिटाता है. इसे अभी आज़माएं.
- rate
- किसी वीडियो को पसंद या नापसंद करना या किसी वीडियो से रेटिंग हटाना. इसे अभी आज़माएं.
- reportAbuse
- किसी वीडियो में आपत्तिजनक कॉन्टेंट होने की शिकायत करना. इसे अभी आज़माएं.
संसाधन का रेप्रज़ेंटेशन
यहां दिए गए JSON स्ट्रक्चर में, videos रिसॉर्स का फ़ॉर्मैट दिखाया गया है:
{
"kind": "youtube#video",
"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,
"tags": [
string
],
"categoryId": string,
"liveBroadcastContent": string,
"defaultLanguage": string,
"localized": {
"title": string,
"description": string
},
"defaultAudioLanguage": string
},
"contentDetails": {
"duration": string,
"dimension": string,
"definition": string,
"caption": string,
"licensedContent": boolean,
"regionRestriction": {
"allowed": [
string
],
"blocked": [
string
]
},
"contentRating": {
"acbRating": string,
"agcomRating": string,
"anatelRating": string,
"bbfcRating": string,
"bfvcRating": string,
"bmukkRating": string,
"catvRating": string,
"catvfrRating": string,
"cbfcRating": string,
"cccRating": string,
"cceRating": string,
"chfilmRating": string,
"chvrsRating": string,
"cicfRating": string,
"cnaRating": string,
"cncRating": string,
"csaRating": string,
"cscfRating": string,
"czfilmRating": string,
"djctqRating": string,
"djctqRatingReasons": [,
string
],
"ecbmctRating": string,
"eefilmRating": string,
"egfilmRating": string,
"eirinRating": string,
"fcbmRating": string,
"fcoRating": string,
"fmocRating": string,
"fpbRating": string,
"fpbRatingReasons": [,
string
],
"fskRating": string,
"grfilmRating": string,
"icaaRating": string,
"ifcoRating": string,
"ilfilmRating": string,
"incaaRating": string,
"kfcbRating": string,
"kijkwijzerRating": string,
"kmrbRating": string,
"lsfRating": string,
"mccaaRating": string,
"mccypRating": string,
"mcstRating": string,
"mdaRating": string,
"medietilsynetRating": string,
"mekuRating": string,
"mibacRating": string,
"mocRating": string,
"moctwRating": string,
"mpaaRating": string,
"mpaatRating": string,
"mtrcbRating": string,
"nbcRating": string,
"nbcplRating": string,
"nfrcRating": string,
"nfvcbRating": string,
"nkclvRating": string,
"oflcRating": string,
"pefilmRating": string,
"rcnofRating": string,
"resorteviolenciaRating": string,
"rtcRating": string,
"rteRating": string,
"russiaRating": string,
"skfilmRating": string,
"smaisRating": string,
"smsaRating": string,
"tvpgRating": string,
"ytRating": string
},
"projection": string,
"hasCustomThumbnail": boolean
},
"status": {
"uploadStatus": string,
"failureReason": string,
"rejectionReason": string,
"privacyStatus": string,
"publishAt": datetime,
"license": string,
"embeddable": boolean,
"publicStatsViewable": boolean,
"madeForKids": boolean,
"selfDeclaredMadeForKids": boolean,
"containsSyntheticMedia": boolean
},
"statistics": {
"viewCount": string,
"likeCount": string,
"dislikeCount": string,
"favoriteCount": string,
"commentCount": string
},
"paidProductPlacementDetails": {
"hasPaidProductPlacement": boolean
},
"player": {
"embedHtml": string,
"embedHeight": long,
"embedWidth": long
},
"topicDetails": {
"topicIds": [
string
],
"relevantTopicIds": [
string
],
"topicCategories": [
string
]
},
"recordingDetails": {
"recordingDate": datetime
},
"fileDetails": {
"fileName": string,
"fileSize": unsigned long,
"fileType": string,
"container": string,
"videoStreams": [
{
"widthPixels": unsigned integer,
"heightPixels": unsigned integer,
"frameRateFps": double,
"aspectRatio": double,
"codec": string,
"bitrateBps": unsigned long,
"rotation": string,
"vendor": string
}
],
"audioStreams": [
{
"channelCount": unsigned integer,
"codec": string,
"bitrateBps": unsigned long,
"vendor": string
}
],
"durationMs": unsigned long,
"bitrateBps": unsigned long,
"creationTime": string
},
"processingDetails": {
"processingStatus": string,
"processingProgress": {
"partsTotal": unsigned long,
"partsProcessed": unsigned long,
"timeLeftMs": unsigned long
},
"processingFailureReason": string,
"fileDetailsAvailability": string,
"processingIssuesAvailability": string,
"tagSuggestionsAvailability": string,
"editorSuggestionsAvailability": string,
"thumbnailsAvailability": string
},
"suggestions": {
"processingErrors": [
string
],
"processingWarnings": [
string
],
"processingHints": [
string
],
"tagSuggestions": [
{
"tag": string,
"categoryRestricts": [
string
]
}
],
"editorSuggestions": [
string
]
},
"liveStreamingDetails": {
"actualStartTime": datetime,
"actualEndTime": datetime,
"scheduledStartTime": datetime,
"scheduledEndTime": datetime,
"concurrentViewers": unsigned long,
"activeLiveChatId": string
},
"brandPartner": {
"channelId": string,
"channelHandle": string
},
"localizations": {
(key): {
"title": string,
"description": string
}
}
}प्रॉपर्टी
यहां दी गई टेबल में, इस संसाधन में दिखने वाली प्रॉपर्टी के बारे में बताया गया है:
| प्रॉपर्टी | |
|---|---|
kind |
stringइससे एपीआई रिसॉर्स के टाइप की पहचान होती है. वैल्यू youtube#video होगी. |
etag |
etagइस संसाधन का Etag. |
id |
stringवह आईडी जिसका इस्तेमाल YouTube, वीडियो की खास तौर पर पहचान करने के लिए करता है. |
snippet |
objectsnippet ऑब्जेक्ट में वीडियो के बारे में बुनियादी जानकारी होती है. जैसे, उसका टाइटल, ब्यौरा, और कैटगरी. |
snippet.publishedAt |
datetimeवीडियो पब्लिश होने की तारीख और समय. यह समय, वीडियो अपलोड किए जाने के समय से अलग हो सकता है. उदाहरण के लिए, अगर किसी वीडियो को निजी वीडियो के तौर पर अपलोड किया जाता है और बाद में उसे सार्वजनिक कर दिया जाता है, तो यह प्रॉपर्टी उस समय की जानकारी देगी जब वीडियो को सार्वजनिक किया गया था. कुछ खास मामले हैं:
|
snippet.channelId |
stringवह आईडी जिसका इस्तेमाल YouTube, उस चैनल की पहचान करने के लिए करता है जिस पर वीडियो अपलोड किया गया था. यह वैल्यू समय के साथ बदल सकती है. जैसे, जब किसी वीडियो को किसी दूसरे चैनल पर फिर से असाइन किया जाता है. उदाहरण के लिए, किसी विषय से जुड़े चैनल या कलाकार चैनल पर. |
snippet.title |
stringवीडियो का टाइटल. प्रॉपर्टी की वैल्यू में ज़्यादा से ज़्यादा 100 वर्ण हो सकते हैं. इसमें < और > को छोड़कर, UTF-8 फ़ॉर्मैट वाले सभी मान्य वर्ण शामिल हो सकते हैं. अगर videos.update तरीके को कॉल किया जाता है और video संसाधन के snippet हिस्से को अपडेट किया जाता है, तो आपको इस प्रॉपर्टी के लिए कोई वैल्यू सेट करनी होगी. |
snippet.description |
stringवीडियो का ब्यौरा. प्रॉपर्टी की वैल्यू ज़्यादा से ज़्यादा 5000 बाइट की हो सकती है. इसमें < और > को छोड़कर, UTF-8 के सभी मान्य वर्ण शामिल हो सकते हैं. वीडियो के ब्यौरे में फ़ॉर्मैट किए गए टाइमस्टैंप (उदाहरण के लिए, 00:00) शामिल करके, वीडियो चैप्टर बनाए जा सकते हैं. |
snippet.thumbnails |
objectवीडियो से जुड़ी थंबनेल इमेज का मैप. मैप में मौजूद हर ऑब्जेक्ट के लिए, कुंजी थंबनेल इमेज का नाम होती है. साथ ही, वैल्यू एक ऐसा ऑब्जेक्ट होती है जिसमें थंबनेल के बारे में अन्य जानकारी होती है. |
snippet.thumbnails.(key) |
objectमान्य मुख्य वैल्यू ये हैं:
|
snippet.thumbnails.(key).url |
stringइमेज का यूआरएल. |
snippet.thumbnails.(key).width |
unsigned integerइमेज की चौड़ाई. |
snippet.thumbnails.(key).height |
unsigned integerइमेज की ऊंचाई. |
snippet.channelTitle |
stringउस चैनल का टाइटल जिससे वीडियो जुड़ा है. |
snippet.tags[] |
listवीडियो से जुड़े कीवर्ड टैग की सूची. टैग में स्पेस हो सकते हैं. प्रॉपर्टी की वैल्यू में ज़्यादा से ज़्यादा 500 वर्ण हो सकते हैं. वर्ण सीमा का हिसाब लगाने के तरीके के बारे में यहां दिए गए नियमों का ध्यान रखें:
|
snippet.categoryId |
stringवीडियो से जुड़ी YouTube वीडियो कैटगरी. अगर videos.update तरीके को कॉल किया जाता है और video संसाधन के snippet हिस्से को अपडेट किया जाता है, तो आपको इस प्रॉपर्टी के लिए कोई वैल्यू सेट करनी होगी. |
snippet.liveBroadcastContent |
stringइससे पता चलता है कि वीडियो, आने वाला/चालू लाइव ब्रॉडकास्ट है या नहीं. अगर वीडियो, आने वाले समय में होने वाला या चालू लाइव ब्रॉडकास्ट नहीं है, तो इसकी वैल्यू इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
snippet.defaultLanguage |
stringvideo रिसॉर्स की snippet.title और snippet.description प्रॉपर्टी में मौजूद टेक्स्ट की भाषा. |
snippet.localized |
objectsnippet.localized ऑब्जेक्ट में, वीडियो के लिए स्थानीय भाषा में टाइटल और ब्यौरा या वीडियो के मेटाडेटा के लिए डिफ़ॉल्ट भाषा में टाइटल शामिल होता है.
localizations ऑब्जेक्ट का इस्तेमाल करें. |
snippet.localized.title |
stringस्थानीय भाषा में वीडियो का टाइटल. |
snippet.localized.description |
stringस्थानीय भाषा में वीडियो का ब्यौरा. |
snippet.defaultAudioLanguage |
stringdefault_audio_language प्रॉपर्टी से, वीडियो के डिफ़ॉल्ट ऑडियो ट्रैक में बोली जाने वाली भाषा के बारे में पता चलता है. |
contentDetails |
objectcontentDetails ऑब्जेक्ट में वीडियो कॉन्टेंट के बारे में जानकारी होती है. इसमें वीडियो की अवधि और यह जानकारी शामिल होती है कि वीडियो के लिए कैप्शन उपलब्ध हैं या नहीं. |
contentDetails.duration |
stringवीडियो की अवधि. प्रॉपर्टी की वैल्यू, ISO 8601 फ़ॉर्मैट में होनी चाहिए. उदाहरण के लिए, एक मिनट से ज़्यादा और एक घंटे से कम अवधि वाले वीडियो के लिए, अवधि PT#M#S फ़ॉर्मैट में होती है. इसमें अक्षर PT से पता चलता है कि वैल्यू, समयावधि के बारे में बताती है. साथ ही, अक्षर M और S से वीडियो की अवधि का पता चलता है. यह अवधि, मिनट और सेकंड में होती है. M और S अक्षरों से पहले आने वाले # वर्ण, दोनों ही पूर्णांक होते हैं. इनसे वीडियो के मिनट (या सेकंड) की संख्या का पता चलता है. उदाहरण के लिए, PT15M33S वैल्यू से पता चलता है कि वीडियो 15 मिनट और 33 सेकंड लंबा है.अगर वीडियो कम से कम एक घंटे का है, तो उसकी अवधि PT#H#M#S फ़ॉर्मैट में होती है. इसमें H अक्षर से पहले मौजूद #, वीडियो की अवधि को घंटों में बताता है. साथ ही, अन्य सभी जानकारी ऊपर बताई गई जानकारी जैसी ही होती है. अगर वीडियो कम से कम एक दिन लंबा है, तो P और T अक्षरों को अलग-अलग किया जाता है. साथ ही, वैल्यू का फ़ॉर्मैट P#DT#H#M#S होता है. पूरी जानकारी के लिए, कृपया आईएसओ 8601 स्पेसिफ़िकेशन देखें. |
contentDetails.dimension |
stringइससे पता चलता है कि वीडियो 3D में उपलब्ध है या 2D में. |
contentDetails.definition |
stringइससे पता चलता है कि वीडियो, हाई डेफ़िनिशन ( HD) में उपलब्ध है या सिर्फ़ स्टैंडर्ड डेफ़िनिशन में.इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.caption |
stringइससे पता चलता है कि वीडियो के लिए कैप्शन उपलब्ध हैं या नहीं. इस प्रॉपर्टी के लिए ये वैल्यू मान्य हैं:
|
contentDetails.licensedContent |
booleanइससे पता चलता है कि वीडियो में लाइसेंस वाला कॉन्टेंट है या नहीं. इसका मतलब है कि कॉन्टेंट को YouTube के कॉन्टेंट पार्टनर से जुड़े चैनल पर अपलोड किया गया था और फिर उस पार्टनर ने उस पर दावा किया था. |
contentDetails.regionRestriction |
objectregionRestriction ऑब्जेक्ट में उन देशों की जानकारी होती है जहां वीडियो देखा जा सकता है या नहीं. ऑब्जेक्ट में contentDetails.regionRestriction.allowed प्रॉपर्टी या contentDetails.regionRestriction.blocked प्रॉपर्टी शामिल होगी. |
contentDetails.regionRestriction.allowed[] |
listक्षेत्र के कोड की सूची, जिससे उन देशों की पहचान होती है जहां वीडियो देखा जा सकता है. अगर यह प्रॉपर्टी मौजूद है और इसकी वैल्यू में किसी देश का नाम नहीं है, तो उस देश में वीडियो को दिखने से ब्लॉक कर दिया जाता है. अगर यह प्रॉपर्टी मौजूद है और इसमें कोई सूची नहीं है, तो वीडियो को सभी देशों में ब्लॉक कर दिया जाता है. |
contentDetails.regionRestriction.blocked[] |
listउन देशों के कोड की सूची जहां वीडियो पर रोक लगा दी गई है. अगर यह प्रॉपर्टी मौजूद है और इसकी वैल्यू में किसी देश का नाम नहीं है, तो उस देश में वीडियो देखा जा सकता है. अगर यह प्रॉपर्टी मौजूद है और इसमें कोई सूची नहीं है, तो वीडियो को सभी देशों में देखा जा सकता है. |
contentDetails.contentRating |
objectइससे पता चलता है कि वीडियो को अलग-अलग रेटिंग स्कीम के तहत कौनसी रेटिंग मिली हैं. |
contentDetails.contentRating.acbRating |
stringवीडियो की ऑस्ट्रेलियन क्लासिफ़िकेशन बोर्ड (एसीबी) या ऑस्ट्रेलियन कम्यूनिकेशंस ऐंड मीडिया अथॉरिटी (एसीएमए) रेटिंग. एसीएमए रेटिंग का इस्तेमाल, बच्चों के लिए बनाए गए टेलीविज़न प्रोग्राम को अलग-अलग कैटगरी में बांटने के लिए किया जाता है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.agcomRating |
stringइटली की Autorità per le Garanzie nelle Comunicazioni (AGCOM) ने वीडियो को जो रेटिंग दी है. इस प्रॉपर्टी के लिए ये वैल्यू मान्य हैं:
|
contentDetails.contentRating.anatelRating |
stringचिली के टेलीविज़न के लिए, वीडियो की Anatel (Asociación Nacional de Televisión) रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.bbfcRating |
stringवीडियो को ब्रिटिश बोर्ड ऑफ़ फ़िल्म क्लासिफ़िकेशन (बीबीएफ़सी) से मिली रेटिंग. इस प्रॉपर्टी के लिए ये वैल्यू मान्य हैं:
|
contentDetails.contentRating.bfvcRating |
stringथाईलैंड के बोर्ड ऑफ़ फ़िल्म ऐंड वीडियो सेंसर्स की ओर से वीडियो को दी गई रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.bmukkRating |
stringऑस्ट्रियन बोर्ड ऑफ़ मीडिया क्लासिफ़िकेशन (Bundesministerium für Unterricht, Kunst und Kultur) से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.catvRating |
stringकनाडा के टीवी के लिए रेटिंग सिस्टम - कनाडा के टीवी क्लासिफ़िकेशन सिस्टम के तहत, कनाडा में अंग्रेज़ी भाषा के ब्रॉडकास्ट के लिए, कैनेडियन रेडियो-टेलीविज़न ऐंड टेलिकम्यूनिकेशंस कमीशन (सीआरटीसी) से मिली वीडियो की रेटिंग. ज़्यादा जानकारी के लिए, कैनेडियन ब्रॉडकास्ट स्टैंडर्ड्स काउंसिल की वेबसाइट पर जाएं. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.catvfrRating |
stringकनाडा में फ़्रेंच भाषा में ब्रॉडकास्ट होने वाले वीडियो के लिए, कैनेडियन रेडियो-टेलीविज़न ऐंड टेलिकम्यूनिकेशंस कमीशन (सीआरटीसी) की रेटिंग. ज़्यादा जानकारी के लिए, कैनेडियन ब्रॉडकास्ट स्टैंडर्ड्स काउंसिल की वेबसाइट पर जाएं. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.cbfcRating |
stringवीडियो के लिए, सेंट्रल बोर्ड ऑफ़ फ़िल्म सर्टिफ़िकेशन (सीबीएफ़सी - भारत) की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.cccRating |
stringवीडियो की Consejo de Calificación Cinematográfica (चिली) रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.cceRating |
stringपुर्तगाल के Comissão de Classificação de Espect´culos के मुताबिक वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.chfilmRating |
stringस्विट्ज़रलैंड में वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.chvrsRating |
stringवीडियो की कैनेडियन होम वीडियो रेटिंग सिस्टम (सीएचवीआरएस) रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.cicfRating |
stringबेल्जियम के कमीशन डी कंट्रोल डेस फ़िल्म्स की ओर से वीडियो को दी गई रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.cnaRating |
stringरोमानिया के CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.cncRating |
stringफ़्रांस में रेटिंग सिस्टम - Commission de classification cinematographique इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.csaRating |
stringफ़्रांस की Conseil supérieur de l'audiovisuel की ओर से दी गई वीडियो की रेटिंग. यह संस्था, ब्रॉडकास्ट किए जाने वाले कॉन्टेंट को रेटिंग देती है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.cscfRating |
stringलक्ज़मबर्ग के कमीशन डी सर्विलांस डी ला क्लासिफ़िकेशन डेस फ़िल्म्स (सीएससीएफ़) के मुताबिक, वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.czfilmRating |
stringचेक गणराज्य में वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.djctqRating |
stringवीडियो की Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - Brazil) रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.djctqRatingReasons[] |
listवीडियो को DJCQT (ब्राज़ील) रेटिंग मिलने की वजहें. |
contentDetails.contentRating.ecbmctRating |
stringतुर्किये में रेटिंग सिस्टम - संस्कृति और पर्यटन मंत्रालय का इवैलुएशन ऐंड क्लासिफ़िकेशन बोर्ड इस प्रॉपर्टी के लिए मान्य वैल्यू:
|
contentDetails.contentRating.eefilmRating |
stringएस्टोनिया में वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.egfilmRating |
stringमिस्र में वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.eirinRating |
stringवीडियो की Eirin (映倫) रेटिंग. Eirin, जापान का रेटिंग सिस्टम है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.fcbmRating |
stringमलेशिया के फ़िल्म सेंसरशिप बोर्ड से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए ये वैल्यू मान्य हैं:
|
contentDetails.contentRating.fcoRating |
stringहॉन्ग कॉन्ग के ऑफ़िस फ़ॉर फ़िल्म, न्यूज़पेपर, ऐंड आर्टिकल एडमिनिस्ट्रेशन की ओर से वीडियो को दी गई रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.fmocRating |
stringयह प्रॉपर्टी 2 नवंबर, 2015 से काम नहीं करती. इसके बजाय, contentDetails.contentRating.cncRating प्रॉपर्टी का इस्तेमाल करें.वीडियो के लिए, Centre national du cinéma et de l'image animé (फ़्रेंच मिनिस्ट्री ऑफ़ कल्चर) की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.fpbRating |
stringसाउथ अफ़्रीका के फ़िल्म ऐंड पब्लिकेशन बोर्ड से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.fpbRatingReasons[] |
listवे वजहें जिनसे पता चलता है कि वीडियो को FPB (दक्षिण अफ़्रीका) रेटिंग क्यों मिली. |
contentDetails.contentRating.fskRating |
stringवीडियो की Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - जर्मनी) रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.grfilmRating |
stringग्रीस में वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.icaaRating |
stringवीडियो की Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - स्पेन) रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.ifcoRating |
stringवीडियो की आयरिश फ़िल्म क्लासिफ़िकेशन ऑफ़िस (आईएफ़सीओ - आयरलैंड) रेटिंग. ज़्यादा जानकारी के लिए, IFCO की वेबसाइट पर जाएं. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.ilfilmRating |
stringइज़रायल में वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.incaaRating |
stringवीडियो की INCAA (Instituto Nacional de Cine y Artes Audiovisuales - Argentina) रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.kfcbRating |
stringकेन्या फ़िल्म क्लासिफ़िकेशन बोर्ड से वीडियो को मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.kijkwijzerRating |
stringvoor de Classificatie van Audiovisuele Media (नीदरलैंड्स). इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.kmrbRating |
stringवीडियो के लिए, कोरिया मीडिया रेटिंग बोर्ड (영상물등급위원회) की रेटिंग. केएमआरबी, दक्षिण कोरिया में वीडियो को रेटिंग देता है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.lsfRating |
stringइंडोनेशिया के Lembaga Sensor Film से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mccaaRating |
stringमाल्टा के फ़िल्म एज-क्लासिफ़िकेशन बोर्ड से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू:
|
contentDetails.contentRating.mccypRating |
stringडेनिश फ़िल्म इंस्टिट्यूट (Det Danske Filminstitut) की मीडिया काउंसिल फ़ॉर चिल्ड्रन ऐंड यंग पीपल की ओर से वीडियो को दी गई रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mcstRating |
stringवियतनाम के लिए वीडियो का रेटिंग सिस्टम - एमसीएसटी इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mdaRating |
stringसिंगापुर की मीडिया डेवलपमेंट अथॉरिटी (एमडीए) और खास तौर पर, इसके बोर्ड ऑफ़ फ़िल्म सेंसर्स (बीएफ़सी) से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.medietilsynetRating |
stringनॉर्वे की मीडिया अथॉरिटी, Medietilsynet से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mekuRating |
stringफ़िनलैंड के नैशनल ऑडियोविज़ुअल इंस्टिट्यूट (Kansallinen Audiovisuaalinen Instituutti) से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mibacRating |
stringइटली के संस्कृति और पर्यटन मंत्रालय (Ministero dei Beni e delle Attività Culturali e del Turismo) की ओर से वीडियो को दी गई रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mocRating |
stringवीडियो के लिए, कोलंबिया के संस्कृति मंत्रालय की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.moctwRating |
stringताइवान के संस्कृति मंत्रालय (文化部) से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mpaaRating |
stringवीडियो की मोशन पिक्चर असोसिएशन ऑफ़ अमेरिका (एमपीएए) रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mpaatRating |
stringफ़िल्म के ट्रेलर और झलक के लिए, मोशन पिक्चर असोसिएशन ऑफ़ अमेरिका की रेटिंग. इस प्रॉपर्टी के लिए ये वैल्यू मान्य हैं:
|
contentDetails.contentRating.mtrcbRating |
stringमूवी ऐंड टेलीविज़न रिव्यू ऐंड क्लासिफ़िकेशन बोर्ड (फ़िलिपींस) से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.nbcRating |
stringमालदीव नैशनल ब्यूरो ऑफ़ क्लासिफ़िकेशन के हिसाब से वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.nfrcRating |
stringबल्गेरियन नैशनल फ़िल्म सेंटर से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.nfvcbRating |
stringनाइजीरिया के नैशनल फ़िल्म ऐंड वीडियो सेंसर्स बोर्ड की ओर से वीडियो को दी गई रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.nkclvRating |
stringNacionãlais Kino centrs (नैशनल फ़िल्म सेंटर ऑफ़ लातविया) से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.oflcRating |
stringवीडियो के लिए, Office of Film and Literature Classification (OFLC - न्यूज़ीलैंड) की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.pefilmRating |
stringपेरू में वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.resorteviolenciaRating |
stringवेनेज़ुएला में वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.rtcRating |
stringवीडियो को मेक्सिको के जनरल डायरेक्टरेट ऑफ़ रेडियो, टेलीविज़न, ऐंड सिनमैटोग्राफ़ी से मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.rteRating |
stringआयरलैंड के रेडियो टेलिफ़ीस एरन के हिसाब से वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.russiaRating |
stringवीडियो की नैशनल फ़िल्म रजिस्ट्री ऑफ़ द रशियन फ़ेडरेशन (एमकेआरएफ़ - रूस) रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.skfilmRating |
stringस्लोवाकिया में वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.smaisRating |
stringआइसलैंड में वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.smsaRating |
stringStatens medieråd (स्वीडन की नैशनल मीडिया काउंसिल) से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.tvpgRating |
stringवीडियो के लिए, टीवी पैरेंटल गाइडलाइंस (टीवीपीजी) रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.ytRating |
stringयह एक ऐसी रेटिंग है जिसका इस्तेमाल YouTube, उम्र की पाबंदी वाले वीडियो की पहचान करने के लिए करता है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.projection |
stringइससे वीडियो के प्रोजेक्शन फ़ॉर्मैट के बारे में पता चलता है. इस प्रॉपर्टी के लिए ये वैल्यू मान्य हैं:
|
contentDetails.hasCustomThumbnail |
booleanइससे पता चलता है कि वीडियो अपलोड करने वाले व्यक्ति ने वीडियो के लिए कस्टम थंबनेल इमेज दी है या नहीं. यह प्रॉपर्टी, सिर्फ़ वीडियो अपलोड करने वाले व्यक्ति को दिखती है. |
status |
objectstatus ऑब्जेक्ट में वीडियो के अपलोड होने, प्रोसेस होने, और निजता की स्थितियों के बारे में जानकारी होती है. |
status.uploadStatus |
stringअपलोड किए गए वीडियो का स्टेटस. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
status.failureReason |
stringइस वैल्यू से पता चलता है कि वीडियो अपलोड क्यों नहीं हो सका. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब uploadStatus प्रॉपर्टी से पता चलता है कि अपलोड नहीं हो सका.इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
status.rejectionReason |
stringइस वैल्यू से पता चलता है कि YouTube ने अपलोड किए गए वीडियो को क्यों अस्वीकार किया. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब uploadStatus प्रॉपर्टी से पता चलता है कि अपलोड को अस्वीकार कर दिया गया था.इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
status.privacyStatus |
stringवीडियो की निजता की स्थिति. videos.insert अनुरोध में, अगर इस प्रॉपर्टी के लिए कोई वैल्यू नहीं दी जाती है, तो अपलोड किए गए वीडियो की निजता स्थिति डिफ़ॉल्ट रूप से public पर सेट हो जाती है. क्रिएटर के खाते की सेटिंग के आधार पर, कुछ वीडियो डिफ़ॉल्ट रूप से private के तौर पर सेट हो सकते हैं. इस बारे में YouTube सहायता केंद्र पर बताया गया है. बिना पुष्टि वाले एपीआई प्रोजेक्ट से अपलोड किए गए वीडियो, निजी व्यूइंग मोड तक सीमित नहीं हैं.इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
status.publishAt |
datetimeवीडियो को पब्लिश करने के लिए शेड्यूल की गई तारीख और समय. इसे सिर्फ़ तब सेट किया जा सकता है, जब वीडियो की निजता स्थिति 'निजी' पर सेट हो. वैल्यू को ISO 8601 फ़ॉर्मैट में बताया गया है. इस प्रॉपर्टी के व्यवहार के बारे में, यहां दी गई दो अतिरिक्त बातों का ध्यान रखें:
|
status.license |
stringवीडियो का लाइसेंस. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
status.embeddable |
booleanइस वैल्यू से पता चलता है कि वीडियो को किसी दूसरी वेबसाइट पर एम्बेड किया जा सकता है या नहीं. |
status.publicStatsViewable |
booleanइस वैल्यू से पता चलता है कि वीडियो के वॉच पेज पर, वीडियो के ज़्यादा आंकड़े सार्वजनिक तौर पर दिख रहे हैं या नहीं. डिफ़ॉल्ट रूप से, ये आंकड़े देखे जा सकते हैं. साथ ही, वीडियो को मिले व्यू की संख्या और रेटिंग जैसे आंकड़े अब भी सार्वजनिक तौर पर दिखेंगे. भले ही, इस प्रॉपर्टी की वैल्यू false पर सेट हो. |
status.madeForKids |
booleanइस वैल्यू से पता चलता है कि वीडियो को बच्चों के लिए बनाया गया है या नहीं. इसमें वीडियो की मौजूदा स्थिति "बच्चों के लिए बना" के तौर पर शामिल होती है. उदाहरण के लिए, selfDeclaredMadeForKids प्रॉपर्टी की वैल्यू के आधार पर, स्थिति तय की जा सकती है. अपने चैनल, वीडियो या ब्रॉडकास्ट के लिए दर्शक तय करने के बारे में ज़्यादा जानने के लिए, YouTube सहायता केंद्र पर जाएं.
|
status.selfDeclaredMadeForKids |
booleanvideos.insert या
videos.update अनुरोध में, इस
प्रॉपर्टी की मदद से, चैनल का मालिक वीडियो को बच्चों के लिए बने वीडियो के तौर पर सेट कर सकता है. videos.list अनुरोध में, प्रॉपर्टी की वैल्यू सिर्फ़ तब दिखती है, जब चैनल के मालिक ने एपीआई अनुरोध को अनुमति दी हो. |
status.containsSyntheticMedia |
booleanvideos.insert या
videos.update अनुरोध में, इस
प्रॉपर्टी की मदद से चैनल का मालिक यह बता सकता है कि वीडियो में, असल लगने वाला बदलाव करके बनाया गया या
अप्राकृतिक (A/S) कॉन्टेंट शामिल है. उम्र की पाबंदी वाले कॉन्टेंट से जुड़ी YouTube की नीतियों के बारे में ज़्यादा जानें.उम्र की पाबंदी वाले कॉन्टेंट के उदाहरणों में ऐसे वीडियो शामिल हैं जिनमें:
|
statistics |
objectstatistics ऑब्जेक्ट में वीडियो के आंकड़े होते हैं. |
statistics.viewCount |
unsigned longवह संख्या जितनी बार वीडियो देखा गया. सभी वीडियो फ़ॉर्मैट (लंबी अवधि के वीडियो, लाइव स्ट्रीम, और शॉर्ट वीडियो) के लिए, सभी वीडियो फ़ॉर्मैट (लंबी अवधि के वीडियो, लाइव स्ट्रीम, और शॉर्ट वीडियो) के लिए, |
statistics.likeCount |
unsigned longउन उपयोगकर्ताओं की संख्या जिन्होंने वीडियो को पसंद किया है. |
statistics.dislikeCount |
unsigned longध्यान दें:
statistics.dislikeCount प्रॉपर्टी को 13 दिसंबर, 2021 से निजी बना दिया गया है. इसका मतलब है कि प्रॉपर्टी को एपीआई से मिली जानकारी में सिर्फ़ तब शामिल किया जाता है, जब एपीआई अनुरोध की पुष्टि वीडियो के मालिक ने की हो. ज़्यादा जानकारी के लिए, बदलावों का इतिहास देखें.उन उपयोगकर्ताओं की संख्या जिन्होंने वीडियो को नापसंद किया है. |
statistics.favoriteCount |
unsigned longध्यान दें: यह प्रॉपर्टी अब काम नहीं करती. यह सुविधा 28 अगस्त, 2015 से बंद है. प्रॉपर्टी की वैल्यू अब हमेशा 0 पर सेट रहती है. |
statistics.commentCount |
unsigned longवीडियो पर की गई टिप्पणियों की संख्या. |
paidProductPlacementDetails |
objectpaidProductPlacementDetails ऑब्जेक्ट में, वीडियो में मौजूद पेड प्रॉडक्ट प्लेसमेंट के बारे में जानकारी होती है. |
paidProductPlacementDetails.hasPaidProductPlacement |
booleanअगर कॉन्टेंट में पेड प्रॉडक्ट प्लेसमेंट का इस्तेमाल किया गया है, तो इसे true पर सेट करें. अगर कॉन्टेंट में पेड प्रॉडक्ट प्लेसमेंट का इस्तेमाल नहीं किया गया है, तो इसे false पर सेट करें. |
player |
objectplayer ऑब्जेक्ट में वह जानकारी होती है जिसका इस्तेमाल करके, एम्बेड किए गए प्लेयर में वीडियो चलाया जा सकता है. |
player.embedHtml |
string<iframe> टैग, जो वीडियो चलाने वाले प्लेयर को एंबेड करता है.
|
player.embedHeight |
longplayer.embedHtml प्रॉपर्टी में, एम्बेड किए गए प्लेयर की ऊंचाई की जानकारी दी जाती है. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब अनुरोध में maxHeight और/या maxWidth पैरामीटर के लिए कोई वैल्यू दी गई हो और वीडियो का आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) पता हो. |
player.embedWidth |
longplayer.embedHtml प्रॉपर्टी में, एम्बेड किए गए प्लेयर की चौड़ाई दिखाई जाती है. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब अनुरोध में maxHeight और/या maxWidth पैरामीटर के लिए कोई वैल्यू दी गई हो और वीडियो का आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) पता हो. |
topicDetails |
objecttopicDetails ऑब्जेक्ट में, वीडियो से जुड़े विषयों की जानकारी होती है.अहम जानकारी: विषय के आईडी से जुड़े आने वाले बदलावों के बारे में ज़्यादा जानने के लिए, topicDetails.relevantTopicIds[] और topicDetails.topicIds[] प्रॉपर्टी की परिभाषाएं और बदलावों का इतिहास देखें. |
topicDetails.topicIds[] |
listअहम जानकारी: इस प्रॉपर्टी को 10 नवंबर, 2016 से बंद कर दिया गया है. एपीआई अब इस प्रॉपर्टी के लिए वैल्यू नहीं दिखाता है. साथ ही, किसी वीडियो से जुड़े विषय अब topicDetails.relevantTopicIds[] प्रॉपर्टी की वैल्यू से दिखाए जाते हैं. |
topicDetails.relevantTopicIds[] |
listवीडियो से जुड़े विषय के आईडी की सूची. इस प्रॉपर्टी को 10 नवंबर, 2016 से बंद कर दिया गया है. यह 10 नवंबर, 2017 तक काम करेगा. अहम जानकारी: Freebase और Freebase API के बंद होने की वजह से, 27 फ़रवरी, 2017 से विषय के आईडी अलग तरीके से काम करने लगे हैं. उस समय, YouTube ने चुने गए विषय के आईडी का एक छोटा सेट दिखाना शुरू किया था. |
topicDetails.topicCategories[] |
listWikipedia के यूआरएल की सूची, जिसमें वीडियो के कॉन्टेंट के बारे में ज़्यादा जानकारी दी गई हो. |
recordingDetails |
objectrecordingDetails ऑब्जेक्ट में, वीडियो रिकॉर्ड करने की जगह, तारीख, और पते की जानकारी होती है. |
recordingDetails.locationDescription |
stringयह प्रॉपर्टी 1 जून, 2017 से काम नहीं करती है. ज़्यादा जानकारी के लिए, कृपया हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना देखें. उस जगह की जानकारी जहां वीडियो रिकॉर्ड किया गया था. |
recordingDetails.location |
objectयह प्रॉपर्टी अब काम नहीं करती है. इसकी सभी चाइल्ड प्रॉपर्टी (अक्षांश, देशांतर, ऊंचाई) अब काम नहीं करतीं. वीडियो से जुड़ी जगह की जानकारी. चाइल्ड प्रॉपर्टी की वैल्यू से उस जगह की जानकारी मिलती है जिसे वीडियो का मालिक, वीडियो से जोड़ना चाहता है. इस वैल्यू में बदलाव किया जा सकता है. साथ ही, सार्वजनिक वीडियो पर इसे खोजा जा सकता है. इसके अलावा, सार्वजनिक वीडियो के लिए इसे उपयोगकर्ताओं को दिखाया जा सकता है. |
recordingDetails.location.latitude |
doubleयह प्रॉपर्टी 1 जून, 2017 से काम नहीं करती है. ज़्यादा जानकारी के लिए, कृपया हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना देखें. डिग्री में अक्षांश. |
recordingDetails.location.longitude |
doubleयह प्रॉपर्टी 1 जून, 2017 से काम नहीं करती है. ज़्यादा जानकारी के लिए, कृपया हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना देखें. डिग्री में देशांतर. |
recordingDetails.location.altitude |
doubleयह प्रॉपर्टी 9 जुलाई, 2018 से काम नहीं करती. ज़्यादा जानकारी के लिए, कृपया हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना देखें. रेफ़रंस एलिप्सॉइड से ऊपर की ऊंचाई, मीटर में. |
recordingDetails.recordingDate |
datetimeवीडियो रिकॉर्ड करने की तारीख और समय. वैल्यू को ISO 8601 ( YYYY-MM-DDThh:mm:ss.sssZ) फ़ॉर्मैट में बताया जाता है. |
fileDetails |
objectfileDetails ऑब्जेक्ट में, YouTube पर अपलोड की गई वीडियो फ़ाइल की जानकारी होती है. इसमें फ़ाइल का रिज़ॉल्यूशन, अवधि, ऑडियो और वीडियो कोडेक, स्ट्रीम बिटरेट वगैरह शामिल हैं. इस डेटा को सिर्फ़ वीडियो का मालिक वापस पा सकता है.fileDetails ऑब्जेक्ट सिर्फ़ तब दिखाया जाएगा, जब processingDetails.fileAvailability प्रॉपर्टी की वैल्यू available होगी. |
fileDetails.fileName |
stringअपलोड की गई फ़ाइल का नाम. यह फ़ील्ड तब मौजूद होता है, जब कोई वीडियो फ़ाइल या किसी अन्य तरह की फ़ाइल अपलोड की गई हो. |
fileDetails.fileSize |
unsigned longअपलोड की गई फ़ाइल का साइज़, बाइट में. यह फ़ील्ड तब मौजूद होता है, जब कोई वीडियो फ़ाइल या किसी अन्य तरह की फ़ाइल अपलोड की गई हो. |
fileDetails.fileType |
stringअपलोड की गई फ़ाइल का टाइप, जैसा कि YouTube के वीडियो प्रोसेसिंग इंजन ने पता लगाया है. फ़िलहाल, YouTube सिर्फ़ वीडियो फ़ाइलों को प्रोसेस करता है. हालांकि, यह फ़ील्ड तब भी मौजूद होता है, जब कोई वीडियो फ़ाइल या किसी अन्य तरह की फ़ाइल अपलोड की गई हो. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
fileDetails.container |
stringअपलोड की गई वीडियो फ़ाइल का कंटेनर फ़ॉर्मैट. |
fileDetails.videoStreams[] |
listअपलोड की गई वीडियो फ़ाइल में मौजूद वीडियो स्ट्रीम की सूची. सूची में मौजूद हर आइटम में, वीडियो स्ट्रीम के बारे में ज़्यादा जानकारी देने वाला मेटाडेटा होता है. |
fileDetails.videoStreams[].widthPixels |
unsigned integerकोड में बदले गए वीडियो वाले कॉन्टेंट की चौड़ाई, पिक्सल में. वीडियो की एन्कोडिंग के आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) का हिसाब, width_pixels / height_pixels के तौर पर लगाया जा सकता है. |
fileDetails.videoStreams[].heightPixels |
unsigned integerकोड में बदले गए वीडियो वाले कॉन्टेंट की लंबाई, पिक्सल में. |
fileDetails.videoStreams[].frameRateFps |
doubleवीडियो स्ट्रीम का फ़्रेम रेट, फ़्रेम प्रति सेकंड में. |
fileDetails.videoStreams[].aspectRatio |
doubleवीडियो वाले कॉन्टेंट का डिसप्ले आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात). इससे पता चलता है कि वीडियो को किस आसपेक्ट रेशियो में दिखाया जाना चाहिए. |
fileDetails.videoStreams[].codec |
stringस्ट्रीम में इस्तेमाल किया जाने वाला वीडियो कोडेक. |
fileDetails.videoStreams[].bitrateBps |
unsigned longबिट प्रति सेकंड में वीडियो स्ट्रीम का बिटरेट. |
fileDetails.videoStreams[].rotation |
stringवीडियो को सही तरीके से दिखाने के लिए, YouTube को ओरिजनल सोर्स कॉन्टेंट को कितना घुमाना होगा. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
fileDetails.videoStreams[].vendor |
stringयह वैल्यू, वीडियो वेंडर की खास तौर पर पहचान करती है. आम तौर पर, यह वैल्यू चार अक्षरों वाला वेंडर कोड होती है. |
fileDetails.audioStreams[] |
listअपलोड की गई वीडियो फ़ाइल में मौजूद ऑडियो स्ट्रीम की सूची. सूची में मौजूद हर आइटम में, ऑडियो स्ट्रीम के बारे में ज़्यादा जानकारी वाला मेटाडेटा होता है. |
fileDetails.audioStreams[].channelCount |
unsigned integerस्ट्रीम में मौजूद ऑडियो चैनलों की संख्या. |
fileDetails.audioStreams[].codec |
stringस्ट्रीम में इस्तेमाल किया जाने वाला ऑडियो कोडेक. |
fileDetails.audioStreams[].bitrateBps |
unsigned longऑडियो स्ट्रीम का बिटरेट, बिट प्रति सेकंड में. |
fileDetails.audioStreams[].vendor |
stringयह वैल्यू, वीडियो वेंडर की खास तौर पर पहचान करती है. आम तौर पर, यह वैल्यू चार अक्षरों वाला वेंडर कोड होती है. |
fileDetails.durationMs |
unsigned longअपलोड किए गए वीडियो की अवधि, मिलीसेकंड में. |
fileDetails.bitrateBps |
unsigned longअपलोड की गई वीडियो फ़ाइल का बिटरेट (वीडियो और ऑडियो), बिट प्रति सेकंड में. |
fileDetails.creationTime |
stringअपलोड की गई वीडियो फ़ाइल को बनाने की तारीख और समय. वैल्यू को ISO 8601 फ़ॉर्मैट में बताया गया है. फ़िलहाल, ISO 8601 के ये फ़ॉर्मैट इस्तेमाल किए जा सकते हैं:
|
processingDetails |
objectprocessingDetails ऑब्जेक्ट में, अपलोड की गई वीडियो फ़ाइल को प्रोसेस करने में YouTube की प्रोग्रेस के बारे में जानकारी होती है. ऑब्जेक्ट में मौजूद प्रॉपर्टी से, वीडियो प्रोसेस होने की मौजूदा स्थिति और वीडियो प्रोसेस होने में लगने वाले अनुमानित समय का पता चलता है. इस हिस्से से यह भी पता चलता है कि वीडियो के लिए अलग-अलग तरह का डेटा या कॉन्टेंट उपलब्ध है या नहीं. जैसे, फ़ाइल की जानकारी या थंबनेल इमेज.processingProgress ऑब्जेक्ट को पोल करने के लिए डिज़ाइन किया गया है, ताकि अपलोड किया गया वीडियो, अपलोड की गई वीडियो फ़ाइल को प्रोसेस करने में YouTube की प्रोग्रेस को ट्रैक कर सके. इस डेटा को सिर्फ़ वीडियो का मालिक वापस पा सकता है. |
processingDetails.processingStatus |
stringवीडियो के प्रोसेस होने की स्थिति. इस वैल्यू से पता चलता है कि YouTube ने वीडियो को प्रोसेस कर लिया है या वीडियो अब भी प्रोसेस हो रहा है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
processingDetails.processingProgress |
objectprocessingProgress ऑब्जेक्ट में, वीडियो को प्रोसेस करने में YouTube की प्रोग्रेस के बारे में जानकारी होती है. ये वैल्यू सिर्फ़ तब काम की होती हैं, जब वीडियो की प्रोसेसिंग की स्थिति processing हो. |
processingDetails.processingProgress.partsTotal |
unsigned longवीडियो के लिए प्रोसेस किए जाने वाले हिस्सों की कुल संख्या का अनुमान. YouTube पर वीडियो प्रोसेस होने के दौरान, इस संख्या को ज़्यादा सटीक अनुमानों के साथ अपडेट किया जा सकता है. |
processingDetails.processingProgress.partsProcessed |
unsigned longवीडियो के उन हिस्सों की संख्या जिन्हें YouTube पहले ही प्रोसेस कर चुका है. YouTube ने वीडियो का कितना प्रतिशत प्रोसेस कर लिया है, इसका अनुमान लगाने के लिए यह तरीका अपनाएं: 100 * parts_processed / parts_totalध्यान दें कि वीडियो के हिस्सों की अनुमानित संख्या बढ़ सकती है. हालांकि, ऐसा ज़रूरी नहीं है कि प्रोसेस किए जा चुके हिस्सों की संख्या भी बढ़े. इसलिए, ऐसा हो सकता है कि वीडियो प्रोसेस करने के दौरान, YouTube पर वीडियो की प्रोग्रेस समय-समय पर कम हो जाए. |
processingDetails.processingProgress.timeLeftMs |
unsigned longवीडियो को प्रोसेस करने में YouTube को लगने वाले समय का अनुमान, मिलीसेकंड में. |
processingDetails.processingFailureReason |
stringवह वजह जिसकी वजह से YouTube, वीडियो को प्रोसेस नहीं कर सका. इस प्रॉपर्टी की वैल्यू सिर्फ़ तब होगी, जब processingStatus प्रॉपर्टी की वैल्यू failed होगी.इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
processingDetails.fileDetailsAvailability |
stringइस वैल्यू से पता चलता है कि अपलोड किए गए वीडियो के लिए, फ़ाइल की जानकारी उपलब्ध है या नहीं. videos.list() अनुरोध में fileDetails पार्ट का अनुरोध करके, वीडियो की फ़ाइल की जानकारी हासिल की जा सकती है. |
processingDetails.processingIssuesAvailability |
stringइस वैल्यू से पता चलता है कि वीडियो प्रोसेसिंग इंजन ने ऐसे सुझाव जनरेट किए हैं या नहीं जिनसे YouTube की वीडियो प्रोसेस करने की क्षमता बेहतर हो सकती है. साथ ही, इससे यह भी पता चलता है कि वीडियो प्रोसेसिंग से जुड़ी समस्याओं के बारे में बताने वाली चेतावनियां या वीडियो प्रोसेसिंग से जुड़ी समस्याओं की वजह से होने वाली गड़बड़ियां जनरेट हुई हैं या नहीं. इन सुझावों को पाने के लिए, अपने videos.list() अनुरोध में suggestions पार्ट का अनुरोध करें. |
processingDetails.tagSuggestionsAvailability |
stringइस वैल्यू से पता चलता है कि वीडियो के लिए कीवर्ड (टैग) के सुझाव उपलब्ध हैं या नहीं. वीडियो के मेटाडेटा में टैग जोड़े जा सकते हैं, ताकि अन्य उपयोगकर्ता वीडियो को आसानी से ढूंढ सकें. इन सुझावों को पाने के लिए, अपने videos.list() अनुरोध में suggestions पार्ट का अनुरोध करें. |
processingDetails.editorSuggestionsAvailability |
stringइस वैल्यू से पता चलता है कि वीडियो में बदलाव करने के सुझाव उपलब्ध हैं या नहीं. इन सुझावों से, वीडियो की क्वालिटी या उसे चलाने के अनुभव को बेहतर बनाया जा सकता है. इन सुझावों को पाने के लिए, अपने videos.list() अनुरोध में suggestions पार्ट का अनुरोध करें. |
processingDetails.thumbnailsAvailability |
stringइस वैल्यू से पता चलता है कि वीडियो के लिए थंबनेल इमेज जनरेट की गई हैं या नहीं. |
suggestions |
objectsuggestions ऑब्जेक्ट में ऐसे सुझाव शामिल होते हैं जिनसे अपलोड किए गए वीडियो की क्वालिटी या मेटाडेटा को बेहतर बनाने के अवसरों की पहचान की जा सकती है. इस डेटा को सिर्फ़ वीडियो का मालिक वापस पा सकता है. suggestions ऑब्जेक्ट सिर्फ़ तब दिखाया जाएगा, जब processingDetails.tagSuggestionsAvailability प्रॉपर्टी या processingDetails.editorSuggestionsAvailability प्रॉपर्टी की वैल्यू available पर सेट हो. |
suggestions.processingErrors[] |
listउन गड़बड़ियों की सूची जिनकी वजह से YouTube, अपलोड किए गए वीडियो को प्रोसेस नहीं कर पाएगा. इन गड़बड़ियों से पता चलता है कि वीडियो की मौजूदा प्रोसेसिंग स्थिति चाहे जो भी हो, आखिर में वह स्थिति failed ही होगी.इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
suggestions.processingWarnings[] |
listउन वजहों की सूची जिनकी वजह से, YouTube को अपलोड किए गए वीडियो को ट्रांसकोड करने में समस्या आ सकती है या ट्रांसकोडिंग में गड़बड़ी हो सकती है. ये चेतावनियां, YouTube पर अपलोड की गई वीडियो फ़ाइल को प्रोसेस करने से पहले जनरेट होती हैं. इसके अलावा, ये ऐसी समस्याओं की पहचान करते हैं जिनसे यह ज़रूरी नहीं है कि वीडियो प्रोसेस न हो पाए. हालांकि, इनसे सिंक करने से जुड़ी समस्याएं, वीडियो आर्टफ़ैक्ट या ऑडियो ट्रैक न होने जैसी समस्याएं हो सकती हैं. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
suggestions.processingHints[] |
listसुझावों की सूची, जिससे YouTube पर वीडियो को प्रोसेस करने की क्षमता को बेहतर बनाया जा सकता है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
suggestions.tagSuggestions[] |
listकीवर्ड टैग की ऐसी सूची जिसे वीडियो के मेटाडेटा में जोड़ा जा सकता है. इससे, YouTube पर खोज या ब्राउज़ करते समय, उपयोगकर्ताओं को आपका वीडियो मिलने की संभावना बढ़ जाती है. |
suggestions.tagSuggestions[].tag |
stringवीडियो के लिए सुझाया गया कीवर्ड टैग. |
suggestions.tagSuggestions[].categoryRestricts[] |
listवीडियो की कैटगरी का एक सेट, जिसके लिए टैग काम का है. इस जानकारी का इस्तेमाल करके, वीडियो अपलोड करने वाले व्यक्ति की चुनी गई वीडियो कैटगरी के आधार पर, टैग के सही सुझाव दिखाए जा सकते हैं. डिफ़ॉल्ट रूप से, टैग के सुझाव सभी कैटगरी के लिए काम के होते हैं. हालांकि, ऐसा तब होता है, जब कीवर्ड के लिए कोई पाबंदी तय न की गई हो. |
suggestions.editorSuggestions[] |
listवीडियो में बदलाव करने के लिए उपलब्ध कार्रवाइयों की सूची. इनकी मदद से, अपलोड किए गए वीडियो की क्वालिटी या उसे चलाने के अनुभव को बेहतर बनाया जा सकता है. इस प्रॉपर्टी के लिए ये वैल्यू मान्य हैं:
|
liveStreamingDetails |
objectliveStreamingDetails ऑब्जेक्ट में, लाइव वीडियो ब्रॉडकास्ट का मेटाडेटा होता है. ऑब्जेक्ट सिर्फ़ video रिसॉर्स में मौजूद होगा. ऐसा तब होगा, जब वीडियो आने वाला, लाइव या पूरा हो चुका लाइव ब्रॉडकास्ट हो. |
liveStreamingDetails.actualStartTime |
datetimeब्रॉडकास्ट शुरू होने का असल समय. वैल्यू को ISO 8601 फ़ॉर्मैट में बताया गया है. यह वैल्यू, ब्रॉडकास्ट शुरू होने तक उपलब्ध नहीं होगी. |
liveStreamingDetails.actualEndTime |
datetimeब्रॉडकास्ट खत्म होने का असल समय. वैल्यू को ISO 8601 फ़ॉर्मैट में बताया गया है. यह वैल्यू, ब्रॉडकास्ट खत्म होने के बाद ही उपलब्ध होगी. |
liveStreamingDetails.scheduledStartTime |
datetimeब्रॉडकास्ट शुरू होने का शेड्यूल किया गया समय. वैल्यू को ISO 8601 फ़ॉर्मैट में बताया गया है. |
liveStreamingDetails.scheduledEndTime |
datetimeब्रॉडकास्ट खत्म होने का शेड्यूल किया गया समय. वैल्यू को ISO 8601 फ़ॉर्मैट में बताया गया है. अगर वैल्यू खाली है या प्रॉपर्टी मौजूद नहीं है, तो ब्रॉडकास्ट को अनिश्चित समय तक जारी रखने के लिए शेड्यूल किया जाता है. |
liveStreamingDetails.concurrentViewers |
unsigned longअनुरोध के समय ब्रॉडकास्ट देख रहे दर्शकों की संख्या. इस संख्या में, साथ मिलकर देखने वाले लोग भी शामिल होते हैं. ऐसा तब होता है, जब कई लोग एक साथ टीवी स्क्रीन पर कॉन्टेंट देखते हैं. प्रॉपर्टी और उसकी वैल्यू तब मौजूद होगी, जब ब्रॉडकास्ट को मौजूदा दर्शक देख रहे हों और ब्रॉडकास्ट के मालिक ने वीडियो के लिए व्यू की संख्या को छिपाया न हो. ध्यान दें कि ब्रॉडकास्ट खत्म होने के बाद, YouTube उस ब्रॉडकास्ट को एक साथ देखने वाले दर्शकों की संख्या को ट्रैक करना बंद कर देता है. इसलिए, इस प्रॉपर्टी से यह पता नहीं चलेगा कि खत्म हो चुके लाइव ब्रॉडकास्ट के संग्रहित वीडियो को कितने दर्शक देख रहे हैं. YouTube Data API से मिलने वाली, एक साथ वीडियो देखने वाले दर्शकों की संख्या, YouTube Analytics से मिलने वाली, एक साथ वीडियो देखने वाले दर्शकों की संख्या से अलग हो सकती है. YouTube Analytics में, स्पैम हटाकर प्रोसेस की गई संख्या दिखाई जाती है. लाइव स्ट्रीम की मेट्रिक के बारे में ज़्यादा जानने के लिए, YouTube सहायता केंद्र पर जाएं.
|
liveStreamingDetails.activeLiveChatId |
stringइस वीडियो से जुड़ी लाइव चैट का आईडी, जो फ़िलहाल चालू है. यह फ़ील्ड सिर्फ़ तब भरा जाता है, जब वीडियो लाइव ब्रॉडकास्ट हो और उसमें लाइव चैट की सुविधा हो. ब्रॉडकास्ट खत्म होने के बाद, यह फ़ील्ड हटा दिया जाएगा और लाइव चैट बंद हो जाएगी. लगातार होने वाले ब्रॉडकास्ट के लिए, लाइव चैट आईडी अब इस वीडियो से नहीं जुड़ा होगा. इसके बजाय, यह उस नए वीडियो से जुड़ा होगा जो लगातार दिखने वाले पेज पर दिखाया जा रहा है. |
brandPartner |
objectbrandPartner ऑब्जेक्ट में, वीडियो से लिंक किए गए ब्रैंड पार्टनर की जानकारी होती है. यह जानकारी, क्रिएटर की ओर से शुरू किए गए ब्रैंड पार्टनर ऐक्सेस (सीआई बीपीए) के लिए होती है. |
brandPartner.channelId |
stringब्रैंड पार्टनर का बाहरी चैनल आईडी. यह फ़ील्ड "UC" से शुरू होना चाहिए. ऐक्सेस सेट अप करते समय, channelId या channelHandle में से किसी एक को सेट करना ज़रूरी है. हालांकि, जवाब में सिर्फ़ channelId दिखता है. |
brandPartner.channelHandle |
stringब्रैंड पार्टनर के चैनल का हैंडल. यह फ़ील्ड "@" से शुरू होना चाहिए. ऐक्सेस सेट अप करते समय, channelId या channelHandle में से किसी एक को सेट करना ज़रूरी है. हालांकि, जवाब में सिर्फ़ channelId दिखता है. |
localizations |
objectlocalizations ऑब्जेक्ट में, वीडियो के मेटाडेटा के अनुवाद शामिल होते हैं. |
localizations.(key) |
objectकुंजी की वैल्यू से जुड़े स्थानीय भाषा में लिखे गए टेक्स्ट की भाषा. वैल्यू एक स्ट्रिंग होती है, जिसमें BCP-47 भाषा कोड शामिल होता है. |
localizations.(key).title |
stringस्थानीय भाषा में वीडियो का टाइटल. |
localizations.(key).description |
stringस्थानीय भाषा में वीडियो का ब्यौरा. |