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
},
"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वीडियो की अवधि. प्रॉपर्टी की वैल्यू, आईएसओ 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 - 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 (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यह वीडियो की रेटिंग है, जो Nacionãlais Kino centrs (लातविया का राष्ट्रीय फ़िल्म सेंटर) ने दी है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.oflcRating |
stringयह वीडियो के लिए, Office of Film and Literature Classification (OFLC - New Zealand) की रेटिंग है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
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 अनुरोध में, इस
प्रॉपर्टी की मदद से चैनल का मालिक यह बता सकता है कि वीडियो में बदलाव करके बनाया गया या अप्राकृतिक (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 |
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 फ़ॉर्मैट में तय किया जाता है. फ़िलहाल, आईएसओ 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इस वीडियो से जुड़ी, फ़िलहाल चालू लाइव चैट का आईडी. यह फ़ील्ड सिर्फ़ तब भरा जाता है, जब वीडियो लाइव ब्रॉडकास्ट हो और उसमें लाइव चैट की सुविधा चालू हो. ब्रॉडकास्ट के पूरा होने के बाद, यह फ़ील्ड हटा दिया जाएगा और लाइव चैट बंद हो जाएगी. लगातार ब्रॉडकास्ट होने वाले वीडियो के लिए, लाइव चैट आईडी अब इस वीडियो से नहीं, बल्कि लगातार ब्रॉडकास्ट होने वाले पेज पर दिखाए जा रहे नए वीडियो से लिंक होगा. |
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वीडियो के बारे में स्थानीय भाषा में दी गई जानकारी. |