videos.insert
एंडपॉइंट से अपलोड किए गए सभी वीडियो, निजी तौर पर देखने के लिए उपलब्ध होंगे. इस पाबंदी को हटाने के लिए, हर एपीआई प्रोजेक्ट को ऑडिट कराना होगा, ताकि यह पुष्टि की जा सके कि वह सेवा की शर्तों का पालन करता है. ज़्यादा जानकारी के लिए, कृपया एपीआई के बदलाव का इतिहास देखें.
video रिसॉर्स, YouTube वीडियो को दिखाता है.
तरीके
एपीआई, videos संसाधनों के लिए इन तरीकों का इस्तेमाल करता है:
- getRating
- इससे, उन वीडियो की रेटिंग मिलती हैं जिन्हें अनुमति वाले उपयोगकर्ता ने चुना है. इसे अभी आज़माएं.
- list
- एपीआई के अनुरोध पैरामीटर से मैच करने वाले वीडियो की सूची दिखाता है. इसे अभी आज़माएं.
- शामिल करें
- 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इससे पता चलता है कि वीडियो, आने वाला/मौजूदा लाइव ब्रॉडकास्ट है या नहीं. अगर वीडियो कोई लाइव स्ट्रीम नहीं है, तो इसकी वैल्यू "none" होगी. इस प्रॉपर्टी की मान्य वैल्यू ये हैं:
|
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 होता है. पूरी जानकारी के लिए, कृपया ISO 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वीडियो को ऑस्ट्रेलियन क्लासिफ़िकेशन बोर्ड (ACB) या ऑस्ट्रेलियन कम्यूनिकेशंस ऐंड मीडिया अथॉरिटी (ACMA) से मिली रेटिंग. 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वीडियो को कनाडा के होम वीडियो रेटिंग सिस्टम (CHVRS) की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.cicfRating |
stringCommission 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वीडियो को हॉन्ग कॉन्ग के ऑफ़िस फ़ॉर फ़िल्म, न्यूज़पेपर, ऐंड आर्टिकल एडमिनिस्ट्रेशन से मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
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 |
stringInstituto 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वीडियो को Korea Media Rating Board (영상물등급위원회) से मिली रेटिंग. KMRB, दक्षिण कोरिया में वीडियो को रेटिंग देता है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.lsfRating |
stringइंडोनेशिया के Lembaga Sensor Film की ओर से वीडियो को मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mccaaRating |
stringमाल्टा के फ़िल्म ऐज-क्लासिफ़िकेशन बोर्ड से मिली वीडियो की रेटिंग. इस प्रॉपर्टी की मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mccypRating |
stringडेनिश फ़िल्म इंस्टिट्यूट (Det Danske Filminstitut) की मीडिया काउंसिल फ़ॉर चिल्ड्रन ऐंड यंग पीपल से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mcstRating |
stringवियतनाम के लिए वीडियो की रेटिंग सिस्टम - एमसीएसटी इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mdaRating |
stringसिंगापुर के मीडिया डेवलपमेंट अथॉरिटी (एमडीए) और खास तौर पर, इसके बोर्ड ऑफ़ फ़िल्म सेंसर (बीएफ़सी) से मिली वीडियो की रेटिंग. इस प्रॉपर्टी की मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.medietilsynetRating |
stringनॉर्वे की मीडिया अथॉरिटी, Medietilsynet की ओर से वीडियो को मिली रेटिंग. इस प्रॉपर्टी की मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mekuRating |
stringफ़िनलैंड के Kansallinen Audiovisuaalinen Instituutti (नेशनल ऑडियोविज़ुअल इंस्टिट्यूट) से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mibacRating |
stringMinistero 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 |
stringफ़िल्म के ट्रेलर और झलक के लिए, मोशन पिक्चर एसोसिएशन ऑफ़ अमेरिका की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mtrcbRating |
stringमूवी और टेलीविज़न रिव्यू ऐंड क्लासिफ़िकेशन बोर्ड (फ़िलिपींस) की ओर से वीडियो को मिली रेटिंग. इस प्रॉपर्टी की मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.nbcRating |
stringमालदीव नेशनल ब्यूरो ऑफ़ क्लासिफ़िकेशन से मिली, वीडियो की रेटिंग. इस प्रॉपर्टी के लिए ये वैल्यू मान्य हैं:
|
contentDetails.contentRating.nfrcRating |
stringBulgarian National Film Center से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.nfvcbRating |
stringनाइजीरिया के नेशनल फ़िल्म ऐंड वीडियो सेंसर बोर्ड की ओर से वीडियो को मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.nkclvRating |
stringNacionã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वीडियो को General Directorate of Radio, Television and Cinematography (मेक्सिको) से मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
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वीडियो की टीवी के लिए बने माता-पिता के दिशा-निर्देशों (टीवीपीजी) की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
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 |
booleanइस प्रॉपर्टी की मदद से, चैनल के मालिक videos.insert या
videos.update अनुरोध में, वीडियो को बच्चों के लिए बने वीडियो के तौर पर मार्क कर सकते हैं. videos.list अनुरोध में, प्रॉपर्टी की वैल्यू सिर्फ़ तब दी जाती है, जब चैनल के मालिक ने एपीआई अनुरोध को अनुमति दी हो. |
status.containsSyntheticMedia |
booleanकिसी videos.insert या
videos.update अनुरोध में, इस
प्रॉपर्टी की मदद से चैनल के मालिक को यह जानकारी देने की अनुमति मिलती है कि वीडियो में बदलाव करके बनाया गया या
अप्राकृतिक (A/S) कॉन्टेंट शामिल है. A/S कॉन्टेंट से जुड़ी YouTube की नीतियों के बारे में ज़्यादा जानें.ए/एस कॉन्टेंट के उदाहरणों में ऐसे वीडियो शामिल हैं जिनमें:
|
statistics |
objectstatistics ऑब्जेक्ट में वीडियो के आंकड़े होते हैं. |
statistics.viewCount |
unsigned longवह संख्या जितनी बार वीडियो देखा गया. 31 मार्च, 2025 से, शॉर्ट वीडियो के व्यू की गिनती इस आधार पर की जाएगी कि कोई शॉर्ट वीडियो कुल कितनी बार देखा गया. इसमें किसी वीडियो को फिर से देखने पर मिले व्यू को भी गिना जाएगा. वीडियो देखने के कम से कम समय से जुड़ी कोई शर्त लागू नहीं होगी. |
statistics.likeCount |
unsigned longउन उपयोगकर्ताओं की संख्या जिन्होंने वीडियो को पसंद किए जाने के संकेत दिए हैं. |
statistics.dislikeCount |
unsigned longध्यान दें:
statistics.dislikeCount प्रॉपर्टी को 13 दिसंबर, 2021 से 'निजी' के तौर पर सेट कर दिया गया है. इसका मतलब है कि प्रॉपर्टी को एपीआई रिस्पॉन्स में सिर्फ़ तब शामिल किया जाता है, जब एपीआई अनुरोध की पुष्टि वीडियो के मालिक ने की हो. ज़्यादा जानकारी के लिए,
बदलाव का इतिहास देखें.ऐसे उपयोगकर्ताओं की संख्या जिन्होंने वीडियो को नापसंद करने का संकेत दिया है. |
statistics.favoriteCount |
unsigned longध्यान दें: इस प्रॉपर्टी का इस्तेमाल नहीं किया जा सकता. यह बदलाव 28 अगस्त, 2015 से लागू होगा. प्रॉपर्टी की वैल्यू अब हमेशा 0 पर सेट रहती है. |
statistics.commentCount |
unsigned longवीडियो पर की गई टिप्पणियों की संख्या. |
paidProductPlacementDetails |
objectpaidProductPlacementDetails ऑब्जेक्ट में, वीडियो में मौजूद पेड प्रॉडक्ट प्लेसमेंट के बारे में जानकारी होती है. |
paidProductPlacementDetails.hasPaidProductPlacement |
booleanअगर वीडियो में पेड प्रॉडक्ट प्लेसमेंट का इस्तेमाल किया गया है, तो इसे true पर सेट करें. डिफ़ॉल्ट रूप से, यह false पर सेट होती है. |
player |
objectplayer ऑब्जेक्ट में वह जानकारी होती है जिसका इस्तेमाल, एम्बेड किए गए प्लेयर में वीडियो चलाने के लिए किया जाता है. |
player.embedHtml |
string<iframe> टैग, वीडियो चलाने वाला प्लेयर एम्बेड करता है.
|
player.embedHeight |
longplayer.embedHtml प्रॉपर्टी में एम्बेड किए गए प्लेयर की ऊंचाई. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब अनुरोध में maxHeight और/या maxWidth पैरामीटर के लिए कोई वैल्यू दी गई हो और वीडियो का आसपेक्ट रेशियो पता हो. |
player.embedWidth |
longplayer.embedHtml प्रॉपर्टी में एम्बेड किए गए प्लेयर की चौड़ाई. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब अनुरोध में maxHeight और/या maxWidth पैरामीटर के लिए कोई वैल्यू दी गई हो और वीडियो का आसपेक्ट रेशियो पता हो. |
topicDetails |
objecttopicDetails ऑब्जेक्ट में, वीडियो से जुड़े विषयों के बारे में जानकारी होती है.अहम जानकारी: विषय आईडी से जुड़े आने वाले बदलावों के बारे में ज़्यादा जानकारी के लिए, topicDetails.relevantTopicIds[] और topicDetails.topicIds[] प्रॉपर्टी की परिभाषाएं देखें. साथ ही, बदलाव के इतिहास को भी देखें. |
topicDetails.topicIds[] |
listअहम जानकारी: इस प्रॉपर्टी का इस्तेमाल 10 नवंबर, 2016 से नहीं किया जा सकता. एपीआई अब इस प्रॉपर्टी के लिए वैल्यू नहीं दिखाता. साथ ही, किसी वीडियो से जुड़े सभी विषयों की जानकारी अब topicDetails.relevantTopicIds[] प्रॉपर्टी की वैल्यू से मिलती है. |
topicDetails.relevantTopicIds[] |
listवीडियो से जुड़े विषय के आईडी की सूची. इस प्रॉपर्टी का इस्तेमाल 10 नवंबर, 2016 से बंद कर दिया गया है. यह सुविधा 10 नवंबर, 2017 तक काम करेगी. अहम जानकारी: Freebase और Freebase API के बंद होने की वजह से, विषय आईडी 27 फ़रवरी, 2017 से अलग तरीके से काम करने लगे हैं. उस समय, YouTube ने चुने गए विषय के आईडी का एक छोटा सेट दिखाना शुरू किया था. |
topicDetails.topicCategories[] |
listWikipedia के उन यूआरएल की सूची जिन पर वीडियो के कॉन्टेंट के बारे में ज़्यादा जानकारी दी गई है. |
recordingDetails |
objectrecordingDetails ऑब्जेक्ट में, वीडियो रिकॉर्ड करने की जगह, तारीख, और पते की जानकारी शामिल होती है. |
recordingDetails.locationDescription |
stringयह प्रॉपर्टी 1 जून, 2017 से काम नहीं करती. ज़्यादा जानकारी के लिए, कृपया हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना देखें. वीडियो रिकॉर्ड करने की जगह की टेक्स्ट जानकारी. |
recordingDetails.location |
objectवीडियो से जुड़ी जगह की जानकारी. ध्यान दें कि चाइल्ड प्रॉपर्टी की वैल्यू से उस जगह की पहचान होती है जिसे वीडियो का मालिक वीडियो से जोड़ना चाहता है. इस वैल्यू में बदलाव किया जा सकता है. साथ ही, सार्वजनिक वीडियो में इसे खोजा जा सकता है. ऐसा हो सकता है कि सार्वजनिक वीडियो के लिए, यह वैल्यू उपयोगकर्ताओं को दिखे. |
recordingDetails.location.latitude |
doubleयह प्रॉपर्टी 1 जून, 2017 से काम नहीं करती. ज़्यादा जानकारी के लिए, कृपया हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना देखें. अक्षांश, डिग्री में. |
recordingDetails.location.longitude |
doubleयह प्रॉपर्टी 1 जून, 2017 से काम नहीं करती. ज़्यादा जानकारी के लिए, कृपया हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना देखें. डिग्री में देशांतर. |
recordingDetails.location.altitude |
doubleयह प्रॉपर्टी 9 जुलाई, 2018 से काम नहीं करती. ज़्यादा जानकारी के लिए, कृपया हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना देखें. रेफ़रंस एलिप्सोइड से ऊपर की ऊंचाई, मीटर में. |
recordingDetails.recordingDate |
datetimeवीडियो रिकॉर्ड करने की तारीख और समय. वैल्यू को ISO 8601 ( YYYY-MM-DDThh:mm:ss.sssZ) फ़ॉर्मैट में बताया गया है. |
fileDetails |
objectfileDetails ऑब्जेक्ट, YouTube पर अपलोड की गई वीडियो फ़ाइल के बारे में जानकारी देता है. इसमें फ़ाइल का रिज़ॉल्यूशन, अवधि, ऑडियो और वीडियो कोडेक, स्ट्रीम बिटरेट वगैरह शामिल हैं. यह डेटा सिर्फ़ वीडियो का मालिक ही ऐक्सेस कर सकता है.fileDetails ऑब्जेक्ट सिर्फ़ तब दिखाया जाएगा, जब processingDetails.fileAvailability प्रॉपर्टी की वैल्यू available हो. |
fileDetails.fileName |
stringअपलोड की गई फ़ाइल का नाम. वीडियो फ़ाइल या किसी दूसरी तरह की फ़ाइल अपलोड करने पर भी, यह फ़ील्ड दिखता है. |
fileDetails.fileSize |
unsigned longअपलोड की गई फ़ाइल का साइज़, बाइट में. वीडियो फ़ाइल या किसी दूसरी तरह की फ़ाइल अपलोड करने पर भी, यह फ़ील्ड दिखता है. |
fileDetails.fileType |
stringYouTube के वीडियो प्रोसेसिंग इंजन से पता चला है कि अपलोड की गई फ़ाइल किस टाइप की है. फ़िलहाल, 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 longYouTube को वीडियो प्रोसेस करने में, मिलीसेकंड में कितना समय लगेगा. |
processingDetails.processingFailureReason |
stringYouTube पर वीडियो प्रोसेस न हो पाने की वजह. इस प्रॉपर्टी की वैल्यू सिर्फ़ तब होगी, जब 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स्थानीय भाषा में वीडियो का ब्यौरा. |