video संसाधन, YouTube वीडियो को दिखाता है.
तरीके
एपीआई में, videos संसाधनों के लिए ये तरीके इस्तेमाल किए जा सकते हैं:
- getRating
- यह अनुमति वाले उपयोगकर्ता की ओर से, चुनिंदा वीडियो की सूची को दी गई रेटिंग को वापस लाता है. इसे अभी आज़माएं.
- list
- एपीआई अनुरोध के पैरामीटर से मैच करने वाले वीडियो की सूची दिखाता है. इसे अभी आज़माएं.
- batchGetStats
- एपीआई अनुरोध के पैरामीटर से मैच करने वाले वीडियो के आंकड़ों की सूची दिखाता है. इसे अभी आज़माएं.
- शामिल करें
- 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वीडियो का ब्यौरा. प्रॉपर्टी वैल्यू की ज़्यादा से ज़्यादा लंबाई 5,000 बाइट होती है. इसमें < और > को छोड़कर, सभी मान्य 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लक्ज़मबर्ग की Commission de surveillance de la classification des films (CSCF) ने वीडियो को यह रेटिंग दी है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
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यह हांगकांग के Office for Film, Newspaper and Article Administration से मिली वीडियो की रेटिंग है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
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वीडियो के लिए, कोरिया मीडिया रेटिंग बोर्ड (영상물등급위원회) की रेटिंग. KMRB, दक्षिण कोरिया में वीडियो को रेटिंग देता है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.lsfRating |
stringइंडोनेशिया के Lembaga Sensor Film से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mccaaRating |
stringमाल्टा के फ़िल्म एज-क्लासिफ़िकेशन बोर्ड से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mccypRating |
stringयह डेनिश फ़िल्म इंस्टिट्यूट (Det Danske Filminstitut) की मीडिया काउंसिल फ़ॉर चिल्ड्रन ऐंड यंग पीपल से मिली वीडियो की रेटिंग है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mcstRating |
stringवियतनाम के लिए वीडियो की रेटिंग सिस्टम - MCST इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
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वीडियो के लिए, Ministerio de Cultura (कोलंबिया) की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.moctwRating |
stringताइवान के संस्कृति मंत्रालय (文化部) से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mpaaRating |
stringवीडियो को मोशन पिक्चर असोसिएशन ऑफ़ अमेरिका (एमपीएए) से मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mpaatRating |
stringMotion Picture Association of America ने मूवी के ट्रेलर और झलक के लिए यह रेटिंग दी है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mtrcbRating |
stringफ़िलिपींस के Movie and Television Review and Classification Board से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.nbcRating |
stringमालदीव के नैशनल ब्यूरो ऑफ़ क्लासिफ़िकेशन के हिसाब से वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.nfrcRating |
stringBulgarian National Film Center से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.nfvcbRating |
stringनाइजीरिया के National Film and Video Censors Board से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.nkclvRating |
stringNacionãlais Kino centrs (नैशनल फ़िल्म सेंटर ऑफ़ लातविया) की ओर से वीडियो को दी गई रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.oflcRating |
stringयह वीडियो को न्यूज़ीलैंड के ऑफ़िस ऑफ़ फ़िल्म ऐंड लिटरेचर क्लासिफ़िकेशन (ओएफ़एलसी) से मिली रेटिंग है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
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वीडियो को पब्लिश करने के लिए शेड्यूल की गई तारीख और समय. इसे सिर्फ़ तब सेट किया जा सकता है, जब वीडियो की निजता स्थिति 'निजी' के तौर पर सेट हो. यह वैल्यू आईएसओ 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वह संख्या जितनी बार वीडियो देखा गया. 24 अगस्त, 2026 से, किसी चैनल पर मौजूद सभी वीडियो फ़ॉर्मैट (लंबी अवधि के वीडियो, लाइव स्ट्रीम, और शॉर्ट वीडियो) के लिए, |
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 |
longएम्बेड किए गए प्लेयर की चौड़ाई, player.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वीडियो रिकॉर्ड करने की तारीख और समय. वैल्यू, आईएसओ 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 की प्रोग्रेस के बारे में जानकारी होती है. ऑब्जेक्ट में मौजूद प्रॉपर्टी से, वीडियो प्रोसेस होने की मौजूदा स्थिति और 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स्थानीय भाषा में वीडियो का ब्यौरा. |