videos.insert
एंडपॉइंट के ज़रिए अपलोड किए गए हैं. इस पाबंदी को हटाने के लिए, हर एपीआई प्रोजेक्ट को ऑडिट कराना होगा. इससे यह पुष्टि की जा सकेगी कि वह सेवा की शर्तों का पालन करता है. ज़्यादा जानकारी के लिए, कृपया एपीआई के बदलावों का इतिहास देखें.
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
},
"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 फ़ॉर्मैट वाले सभी मान्य वर्ण शामिल किए जा सकते हैं. |
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वीडियो को ऑस्ट्रेलियन क्लासिफ़िकेशन बोर्ड (एसीबी) या ऑस्ट्रेलियन कम्यूनिकेशंस ऐंड मीडिया अथॉरिटी (एसीएमए) से मिली रेटिंग. ACMA रेटिंग का इस्तेमाल, बच्चों के लिए बनाए गए टीवी प्रोग्राम को कैटगरी में बांटने के लिए किया जाता है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
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कनाडा में टीवी के लिए रेटिंग सिस्टम - कनाडियन टीवी क्लासिफ़िकेशन सिस्टम. यह रेटिंग, कनाडियन रेडियो-टेलीविज़न ऐंड टेलीकम्यूनिकेशंस कमीशन (सीआरटीसी) ने कनाडा में अंग्रेज़ी भाषा में ब्रॉडकास्ट होने वाले कॉन्टेंट के लिए दी है. ज़्यादा जानकारी के लिए, Canadian Broadcast Standards Council की वेबसाइट पर जाएं. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.catvfrRating |
stringकनाडा में फ़्रेंच भाषा में ब्रॉडकास्ट किए जाने वाले वीडियो के लिए, कैनेडियन रेडियो-टेलीविज़न ऐंड टेलीकम्यूनिकेशंस कमीशन (सीआरटीसी) की रेटिंग. ज़्यादा जानकारी के लिए, Canadian Broadcast Standards Council की वेबसाइट पर जाएं. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
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यह वीडियो को Commission de Contrôle des Films (बेल्जियम) से मिली रेटिंग है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
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) ने जो रेटिंग दी है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
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 (Netherlands). इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.kmrbRating |
stringवीडियो को कोरिया मीडिया रेटिंग बोर्ड (영상물등급위원회) से मिली रेटिंग. KMRB, दक्षिण कोरिया में वीडियो को रेटिंग देता है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.lsfRating |
stringइंडोनेशिया के Lembaga Sensor Film ने वीडियो को यह रेटिंग दी है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mccaaRating |
stringमाल्टा के फ़िल्म एज-क्लासिफ़िकेशन बोर्ड से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mccypRating |
stringयह डेनिश फ़िल्म इंस्टिट्यूट (डेट डैंस्क फ़िल्मइंस्टिट्यूट) की मीडिया काउंसिल फ़ॉर चिल्ड्रन ऐंड यंग पीपल से मिली वीडियो की रेटिंग है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
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वीडियो को कोलंबिया के संस्कृति मंत्रालय से मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.moctwRating |
stringताइवान के संस्कृति मंत्रालय (文化部) से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mpaaRating |
stringवीडियो को मोशन पिक्चर असोसिएशन ऑफ़ अमेरिका (एमपीएए) से मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mpaatRating |
stringमोशन पिक्चर एसोसिएशन ऑफ़ अमेरिका ने फ़िल्म के ट्रेलर और झलक के लिए यह रेटिंग दी है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
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नाइजीरिया के नेशनल फ़िल्म ऐंड वीडियो सेंसर बोर्ड ने वीडियो को यह रेटिंग दी है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.nkclvRating |
stringलातविया के नैशनल फ़िल्म सेंटर (नैशनल किनॉ सेंटर) के हिसाब से वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.oflcRating |
stringयह वीडियो के लिए, न्यूज़ीलैंड के ऑफ़िस ऑफ़ फ़िल्म ऐंड लिटरेचर क्लासिफ़िकेशन (ओएफ़एलसी) की रेटिंग है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.pefilmRating |
stringपेरू में वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.resorteviolenciaRating |
stringवेनेज़ुएला में वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.rtcRating |
stringवीडियो को मेक्सिको के रेडियो, टेलीविज़न, और सिनेमैटोग्राफ़ी के महानिदेशालय से मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.rteRating |
stringआयरलैंड के Raidió Teilifís Éireann ने वीडियो को यह रेटिंग दी है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.russiaRating |
stringयह वीडियो की, रशियन फ़ेडरेशन के नेशनल फ़िल्म रजिस्ट्री (MKRF - रूस) की रेटिंग होती है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.skfilmRating |
stringस्लोवाकिया में वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.smaisRating |
stringआइसलैंड में वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.smsaRating |
stringStatens medieråd (स्वीडन की राष्ट्रीय मीडिया परिषद) से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.tvpgRating |
stringवीडियो के लिए, TV Parental Guidelines (TVPG) रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
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वीडियो की निजता की स्थिति. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
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 अनुरोध में, यह प्रॉपर्टी चैनल के मालिक को यह जानकारी देने की अनुमति देती है कि किसी वीडियो में, बदलाव करके बनाया गया या सिंथेटिक (ए/एस) कॉन्टेंट शामिल है. ए/एस कॉन्टेंट से जुड़ी YouTube की नीतियों के बारे में ज़्यादा जानें.ए/एस कॉन्टेंट के उदाहरणों में ऐसे वीडियो शामिल हैं जिनमें:
|
statistics |
objectstatistics ऑब्जेक्ट में वीडियो के बारे में आंकड़े होते हैं. |
statistics.viewCount |
unsigned longवह संख्या जितनी बार वीडियो देखा गया. 31 मार्च, 2025 से, शॉर्ट वीडियो के लिए viewCount, इस आधार पर तय होगा कि कोई शॉर्ट वीडियो कुल कितनी बार देखा गया. इसमें किसी वीडियो को फिर से देखने पर मिले व्यू को भी गिना जाएगा. वीडियो देखने के कम से कम समय से जुड़ी कोई शर्त लागू नहीं होगी. |
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 |
longयह player.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वीडियो रिकॉर्ड करने की तारीख और समय. वैल्यू को 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 की प्रोग्रेस के बारे में जानकारी होती है. ऑब्जेक्ट में मौजूद प्रॉपर्टी से, प्रोसेसिंग की मौजूदा स्थिति और 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 सहायता केंद्र पर जाएं.
|
liveStreamingDetails.activeLiveChatId |
stringइस वीडियो से जुड़ी, फ़िलहाल चालू लाइव चैट का आईडी. यह फ़ील्ड सिर्फ़ तब भरा जाता है, जब वीडियो लाइव ब्रॉडकास्ट हो और उसमें लाइव चैट की सुविधा चालू हो. ब्रॉडकास्ट के पूरा होने के बाद, यह फ़ील्ड हटा दिया जाएगा और लाइव चैट बंद हो जाएगी. लगातार चलने वाले ब्रॉडकास्ट के लिए, लाइव चैट आईडी अब इस वीडियो से नहीं, बल्कि लगातार दिखने वाले पेज पर दिखाए जा रहे नए वीडियो से जुड़ा होगा. |
localizations |
objectlocalizations ऑब्जेक्ट में, वीडियो के मेटाडेटा के अनुवाद शामिल होते हैं. |
localizations.(key) |
objectयह कुंजी की वैल्यू से जुड़े स्थानीय भाषा में लिखे गए टेक्स्ट की भाषा है. वैल्यू एक स्ट्रिंग होती है, जिसमें BCP-47 भाषा कोड होता है. |
localizations.(key).title |
stringस्थानीय भाषा में वीडियो का टाइटल. |
localizations.(key).description |
stringवीडियो के बारे में स्थानीय भाषा में दी गई जानकारी. |