ऐसे एपीआई प्रोजेक्ट जो 28 जुलाई, 2020 के बाद बनाए गए थे और जिनकी पुष्टि नहीं हुई है, उनके
videos.insert
एंडपॉइंट से अपलोड किए गए सभी वीडियो, निजी मोड में देखने के लिए सीमित कर दिए जाएंगे. इस पाबंदी को हटाने के लिए, हर एपीआई प्रोजेक्ट का ऑडिट कराना ज़रूरी है, ताकि इस बात की पुष्टि की जा सके कि वह सेवा की शर्तों का पालन कर रहा है. ज़्यादा जानकारी के लिए, कृपया एपीआई में बदलाव का इतिहास देखें.
video
संसाधन एक YouTube वीडियो के बारे में बताता है.
तरीके
videos
रिसॉर्स के लिए, एपीआई इन तरीकों का इस्तेमाल करता है:
- getरेटिंग
- उन रेटिंग को फिर से हासिल करता है जो उपयोगकर्ता ने कुछ खास वीडियो को दी हैं. इसे अभी आज़माएं.
- list
- एपीआई अनुरोध के पैरामीटर से मेल खाने वाले वीडियो की सूची दिखाता है. इसे अभी आज़माएं.
- डालें
- YouTube पर वीडियो अपलोड करता है और वैकल्पिक तौर पर वीडियो का मेटाडेटा सेट करता है.
- अपडेट करें
- वीडियो के मेटाडेटा को अपडेट करता है. इसे अभी आज़माएं.
- मिटाएं
- YouTube वीडियो को मिटाता है. इसे अभी आज़माएं.
- दर
- किसी वीडियो में पसंद या नापसंद करने की रेटिंग जोड़ें या किसी वीडियो से रेटिंग हटाएं. इसे अभी आज़माएं.
- गलत इस्तेमाल की शिकायत करना
- बुरे बर्ताव वाले वीडियो की शिकायत करना. इसे अभी आज़माएं.
संसाधन का प्रतिनिधित्व
यह 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 }, "statistics": { "viewCount": string, "likeCount": string, "dislikeCount": string, "favoriteCount": string, "commentCount": string }, "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 इस संसाधन का एटैग. |
id |
string इस आईडी का इस्तेमाल, YouTube किसी वीडियो की खास तरह से पहचान करने के लिए करता है. |
snippet |
object snippet ऑब्जेक्ट में, वीडियो की बुनियादी जानकारी होती है. जैसे, टाइटल, ब्यौरा, और कैटगरी. |
snippet.publishedAt |
datetime वीडियो पब्लिश करने की तारीख और समय. ध्यान दें कि यह समय, वीडियो अपलोड करने के समय से अलग हो सकता है. उदाहरण के लिए, अगर किसी वीडियो को निजी वीडियो के तौर पर अपलोड किया जाता है और बाद में उसे सार्वजनिक किया जाता है, तो यह प्रॉपर्टी, वीडियो के सार्वजनिक होने का समय बताएगी. इसके कुछ खास मामले हैं:
|
snippet.channelId |
string इस आईडी का इस्तेमाल करके, YouTube उस चैनल की खास तरह से पहचान करता है जिस पर वीडियो अपलोड किया गया था. |
snippet.title |
string वीडियो का टाइटल. प्रॉपर्टी की वैल्यू में ज़्यादा से ज़्यादा 100 वर्ण हो सकते हैं. साथ ही, इसमें < और > को छोड़कर, सभी मान्य UTF-8 वर्ण शामिल हो सकते हैं. अगर videos.update तरीके को कॉल किया जाता है और video संसाधन के snippet हिस्से को अपडेट किया जा रहा है, तो आपको इस प्रॉपर्टी के लिए एक वैल्यू सेट करनी होगी. |
snippet.description |
string वीडियो का ब्यौरा. प्रॉपर्टी की वैल्यू की लंबाई ज़्यादा से ज़्यादा 5000 बाइट होती है. इसमें < और > को छोड़कर, सभी मान्य 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 |
string video संसाधन की snippet.title और snippet.description प्रॉपर्टी में मौजूद टेक्स्ट की भाषा. |
snippet.localized |
object snippet.localized ऑब्जेक्ट में, वीडियो का शीर्षक और ब्यौरा स्थानीय भाषा में हो सकता है. इसके अलावा, वीडियो के मेटाडेटा की डिफ़ॉल्ट भाषा में शीर्षक भी मौजूद हो सकता है.
localizations ऑब्जेक्ट का इस्तेमाल करें. |
snippet.localized.title |
string स्थानीय भाषा में बनाए गए वीडियो का टाइटल. |
snippet.localized.description |
string स्थानीय जगह के अनुसार वीडियो का ब्यौरा. |
snippet.defaultAudioLanguage |
string default_audio_language प्रॉपर्टी, वीडियो के डिफ़ॉल्ट ऑडियो ट्रैक में बोली गई भाषा के बारे में बताती है. |
contentDetails |
object contentDetails ऑब्जेक्ट में, वीडियो के कॉन्टेंट की जानकारी होती है. इसमें वीडियो की लंबाई और यह जानकारी भी शामिल होती है कि वीडियो के लिए कैप्शन उपलब्ध हैं या नहीं. |
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 |
object regionRestriction ऑब्जेक्ट में उन देशों की जानकारी होती है जहां कोई वीडियो दिखता है (या नहीं दिखता है). ऑब्जेक्ट में 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 nella Comunicazioni (AGCOM) से वीडियो को मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.anatelRating |
string चिली के टेलिविज़न के लिए, वीडियो को Anatel (Asociación Nacional de Televiión) की रेटिंग दी गई है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.bbfcRating |
string वीडियो की ब्रिटिश बोर्ड ऑफ़ फ़िल्म क्लासिफ़िकेशन (बीबीएफ़सी) रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.bfvcRating |
string इस वीडियो को थाईलैंड के बोर्ड ऑफ़ फ़िल्म ऐंड वीडियो सेंसर्स से रेटिंग मिली है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.bmukkRating |
string ऑस्ट्रियन बोर्ड ऑफ़ मीडिया क्लासिफ़िकेशन (Bundesministium für Unterrickt, Kanst und Kultur) ने वीडियो को जो रेटिंग दी है, वह है. इस प्रॉपर्टी के लिए, मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.catvRating |
string कैनेडियन टीवी के लिए रेटिंग सिस्टम - कैनेडियन टीवी क्लासिफ़िकेशन सिस्टम ज़्यादा जानकारी के लिए, कनेडियन ब्रॉडकास्ट स्टैंडर्ड काउंसिल वेबसाइट देखें. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.catvfrRating |
string कनाडा के फ़्रेंच भाषा में ब्रॉडकास्ट करने के लिए, कनाडा के रेडियो-टेलिविज़न ऐंड टेलिकम्यूनिकेशन्स कमीशन (सीआरटीसी) से वीडियो को मिली रेटिंग. ज़्यादा जानकारी के लिए, कनेडियन ब्रॉडकास्ट स्टैंडर्ड काउंसिल वेबसाइट देखें. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.cbfcRating |
string वीडियो को सेंट्रल बोर्ड ऑफ़ फ़िल्म सर्टिफ़िकेशन (सीबीएफ़सी - भारत) की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.cccRating |
string वीडियो को मिली Consejo de Calificación Cinematográfica (चिली) की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.cceRating |
string पुर्तगाल के Comissão de Classificação de Espect 'culos वीडियो को रेटिंग दी गई है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.chfilmRating |
string स्विट्ज़रलैंड में वीडियो को कितनी रेटिंग मिली है. इस प्रॉपर्टी के लिए, मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.chvrsRating |
string वीडियो की कनाडा के होम वीडियो रेटिंग सिस्टम (CHVRS) रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.cicfRating |
string Commission de Contrôle des Films (बेल्जियम) से वीडियो को मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.cnaRating |
string रोमानिया के CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) से वीडियो को मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.cncRating |
string फ़्रांस में रेटिंग सिस्टम - कमीशन डी क्लासिफ़िकेशन सिनेमैटोग्राफ़िक इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.csaRating |
string ब्रॉडकास्ट कॉन्टेंट की रेटिंग देने के लिए, फ़्रांस के Conseil supérieur de l?audiowi उपकरण से वीडियो को मिली रेटिंग. इस प्रॉपर्टी के लिए सही वैल्यू ये हैं:
|
contentDetails.contentRating.cscfRating |
string इस वीडियो को लक्ज़मबर्ग के कमीशन de Ssur ग्राहकों की जानकारी, कैटगरी और फ़िल्में (सीएससीएफ़) से रेटिंग दी गई है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.czfilmRating |
string चेक गणराज्य में वीडियो को मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.djctqRating |
string वीडियो की Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - Brazil) रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू, ये हैं:
|
contentDetails.contentRating.djctqRatingReasons[] |
list वीडियो को DJCQT (ब्राज़ील) की रेटिंग मिलने की वजहें. |
contentDetails.contentRating.ecbmctRating |
string तुर्किये में रेटिंग सिस्टम - मिनिस्ट्री ऑफ़ कल्चर ऐंड टूरिज़्म का इवैलुएशन ऐंड क्लासिफ़िकेशन बोर्ड इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.eefilmRating |
string एस्टोनिया में वीडियो को मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.egfilmRating |
string मिस्र में वीडियो को मिली रेटिंग. इस प्रॉपर्टी के लिए, मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.eirinRating |
string वीडियो की Eirin (映倫) रेटिंग. Eirin, जैपनीज़ रेटिंग सिस्टम है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.fcbmRating |
string वीडियो को मलेशिया के फ़िल्म सेंसरशिप बोर्ड से मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.fcoRating |
string इस वीडियो को हॉन्ग कॉन्ग के ऑफ़िस फ़ॉर फ़िल्म, न्यूज़पेपर, ऐंड आर्टिकल एडमिनिस्ट्रेशन से मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.fmocRating |
string इस प्रॉपर्टी पर 2 नवंबर, 2015 से रोक लगा दी गई है. इसके बजाय, contentDetails.contentRating.cncRating प्रॉपर्टी का इस्तेमाल करें.इस वीडियो की सेंटर नैशनल डु सिनेमा एट डे l'इमेज एनिम (फ़्रेंच मिनिस्ट्री ऑफ़ कल्चर) की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
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 Audiovisiones (आईसीएए - स्पेन) की रेटिंग. इस प्रॉपर्टी के लिए, मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.ifcoRating |
string वीडियो की आयरिश फ़िल्म क्लासिफ़िकेशन ऑफ़िस (आईएफ़सीओ - आयरलैंड) की रेटिंग. ज़्यादा जानकारी के लिए, IFCO की वेबसाइट पर जाएं. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.ilfilmRating |
string वीडियो को इज़रायल में रेटिंग मिली है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.incaaRating |
string वीडियो को मिला IncAA (Instituto Nacional de Cine y Artes Audiovisiones - अर्जेंटीना) की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.kfcbRating |
string केन्या फ़िल्म क्लासिफ़िकेशन बोर्ड से वीडियो को मिली रेटिंग. इस प्रॉपर्टी के लिए, मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.kijkwijzerRating |
string voor de Classificatie van Audiomisuele Media (नीदरलैंड्स). इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.kmrbRating |
string वीडियो की कोरिया मीडिया रेटिंग बोर्ड (영상물등위원요) खाते की रेटिंग. केएमआरबी, दक्षिण कोरिया में वीडियो को रेटिंग देता है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.lsfRating |
string इस वीडियो को इंडोनेशिया के लेमबागा सेंसर फ़िल्म ने रेटिंग दी है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mccaaRating |
string माल्टा के फ़िल्म एज-क्लासिफ़िकेशन बोर्ड से वीडियो को मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mccypRating |
string वीडियो को डेनिश फ़िल्म इंस्टिट्यूट (Det Danske Filminstitut) के मीडिया काउंसिल फ़ॉर चिल्ड्रन ऐंड यंग पीपल से मिला रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mcstRating |
string वियतनाम के लिए वीडियो का रेटिंग सिस्टम - MCST इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mdaRating |
string वीडियो को सिंगापुर की मीडिया डेवलपमेंट अथॉरिटी (एमडीए) से और खास तौर पर, बोर्ड ऑफ़ फ़िल्म सेंसर्स (बीएफ़सी) से मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.medietilsynetRating |
string इस वीडियो को, नॉर्वेजियन मीडिया अथॉरिटी, Medietilsynet से रेटिंग मिली है. इस प्रॉपर्टी के लिए, मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mekuRating |
string वीडियो को फ़िनलैंड के Kansallinen Audiovisionualinen Instituutti (नैशनल ऑडियोविज़ुअल इंस्टिट्यूट) से रेटिंग दी गई है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mibacRating |
string Minio dei Beni e della Attività Culturali e del Turismo (इटली) से मिले वीडियो को रेटिंग दी गई है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mocRating |
string वीडियो की Miniio 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 |
string वीडियो को बुल्गेरियन नैशनल फ़िल्म सेंटर से मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
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 Éirienn से, वीडियो को रेटिंग मिली है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.russiaRating |
string वीडियो की नैशनल फ़िल्म रजिस्ट्री ऑफ़ द रशियन फ़ेडरेशन (एमकेआरएफ़ - रूस) रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.skfilmRating |
string स्लोवाकिया में वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.smaisRating |
string आइसलैंड में वीडियो की रेटिंग. इस प्रॉपर्टी के लिए, मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.smsaRating |
string इस वीडियो को Statens medieråd (स्वीडन की नैशनल मीडिया काउंसिल) ने रेटिंग दी है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.tvpgRating |
string टीवी पर माता-पिता के लिए बने दिशा-निर्देशों (TVPG) की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.ytRating |
string YouTube इस रेटिंग का इस्तेमाल, उम्र की पाबंदी वाले वीडियो की पहचान करने के लिए करता है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.projection |
string इससे वीडियो के प्रोजेक्शन फ़ॉर्मैट के बारे में पता चलता है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.hasCustomThumbnail |
boolean इससे पता चलता है कि वीडियो अपलोड करने वाले ने, वीडियो के लिए कस्टम थंबनेल इमेज दी है या नहीं. यह प्रॉपर्टी सिर्फ़ वीडियो अपलोड करने वाले को दिखती है. |
status |
object status ऑब्जेक्ट में, वीडियो को अपलोड करने, प्रोसेस करने, और निजता की स्थितियों की जानकारी होती है. |
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 अनुरोध में, प्रॉपर्टी की वैल्यू सिर्फ़ तब दिखाई जाती है, जब चैनल के मालिक ने एपीआई अनुरोध की अनुमति दी हो. |
statistics |
object statistics ऑब्जेक्ट में वीडियो के आंकड़े शामिल होते हैं. |
statistics.viewCount |
unsigned long वह संख्या जो बताती है कि वीडियो कितनी बार देखा गया है. |
statistics.likeCount |
unsigned long ऐसे दर्शकों की संख्या जिन्होंने यह बताया है कि उन्होंने वीडियो को पसंद किया. |
statistics.dislikeCount |
unsigned long ध्यान दें:
statistics.dislikeCount प्रॉपर्टी को
13 दिसंबर, 2021 से निजी के तौर पर सेट कर दिया गया था. इसका मतलब है कि एपीआई के अनुरोध की पुष्टि करने के बाद ही, वीडियो के मालिक ने प्रॉपर्टी को एपीआई रिस्पॉन्स में शामिल किया होगा. ज़्यादा जानकारी के लिए,
बदलाव का इतिहास देखें.ऐसे दर्शकों की संख्या जिन्होंने यह संकेत दिया है कि उन्होंने वीडियो नापसंद किया है. |
statistics.favoriteCount |
unsigned long ध्यान दें: यह प्रॉपर्टी अब काम नहीं करती है. यह सुविधा 28 अगस्त, 2015 से लागू होगी. प्रॉपर्टी की वैल्यू अब हमेशा 0 पर सेट है. |
statistics.commentCount |
unsigned long वीडियो पर की गई टिप्पणियों की संख्या. |
player |
object player ऑब्जेक्ट में ऐसी जानकारी होती है जिसका इस्तेमाल, एम्बेड किए गए प्लेयर में वीडियो चलाने के लिए किया जाएगा. |
player.embedHtml |
string एक <iframe> टैग, जो वीडियो चलाने वाले प्लेयर को एम्बेड करता है.
|
player.embedHeight |
long player.embedHtml प्रॉपर्टी में, एम्बेड किए गए प्लेयर की ऊंचाई. यह प्रॉपर्टी सिर्फ़ तब वापस की जाती है, जब अनुरोध में maxHeight और/या maxWidth पैरामीटर के लिए कोई वैल्यू दी गई हो और वीडियो का आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) पता हो. |
player.embedWidth |
long player.embedHtml प्रॉपर्टी में, एम्बेड किए गए प्लेयर की चौड़ाई दिखाई जाती है. यह प्रॉपर्टी सिर्फ़ तब वापस की जाती है, जब अनुरोध में maxHeight और/या maxWidth पैरामीटर के लिए कोई वैल्यू दी गई हो और वीडियो का आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) पता हो. |
topicDetails |
object topicDetails ऑब्जेक्ट, वीडियो से जुड़े विषयों के बारे में जानकारी इकट्ठा करता है.अहम जानकारी: विषय के आईडी में होने वाले बदलावों के बारे में ज़्यादा जानने के लिए, 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[] |
list यह Wikipedia के यूआरएल की सूची है, जिसमें वीडियो के कॉन्टेंट की पूरी जानकारी दी गई है. |
recordingDetails |
object recordingDetails ऑब्जेक्ट, वीडियो रिकॉर्ड करने की जगह, तारीख, और पते के बारे में जानकारी इकट्ठा करता है. |
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 |
object fileDetails ऑब्जेक्ट, 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 |
object processingDetails ऑब्जेक्ट, यह जानकारी इकट्ठा करता है कि अपलोड किए गए वीडियो को प्रोसेस करने के लिए, YouTube ने कितना काम किया है. ऑब्जेक्ट में मौजूद प्रॉपर्टी, वीडियो प्रोसेस होने के मौजूदा स्टेटस की पहचान करती हैं. साथ ही, यह भी पता लगाती हैं कि YouTube वीडियो प्रोसेस होने में कितना समय लगेगा. इस हिस्से से यह भी पता चलता है कि वीडियो के लिए, अलग-अलग तरह का डेटा या कॉन्टेंट उपलब्ध है या नहीं, जैसे कि फ़ाइल की जानकारी या थंबनेल इमेज.processingProgress ऑब्जेक्ट को पोल कराने के लिए डिज़ाइन किया गया है, ताकि अपलोड किया गया वीडियो उस वीडियो की प्रोग्रेस ट्रैक कर सके जो YouTube ने अपलोड की गई वीडियो फ़ाइल को प्रोसेस करने के लिए किया है. इस डेटा को सिर्फ़ वीडियो का मालिक ही वापस ला सकता है. |
processingDetails.processingStatus |
string वीडियो प्रोसेस होने की स्थिति. इस वैल्यू से पता चलता है कि YouTube, वीडियो को प्रोसेस कर पाया या नहीं या वीडियो को अब भी प्रोसेस किया जा रहा है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
processingDetails.processingProgress |
object processingProgress ऑब्जेक्ट में, यह जानकारी होती है कि YouTube ने वीडियो को प्रोसेस करने के लिए क्या बदलाव किया है. यह वैल्यू सिर्फ़ तब काम की होती है, जब वीडियो को प्रोसेस करने की स्थिति processing हो. |
processingDetails.processingProgress.partsTotal |
unsigned long इस बात का अनुमान कि वीडियो के कुल कितने हिस्सों को प्रोसेस किया जाना है. जब YouTube वीडियो प्रोसेस कर रहा हो, तब संख्या को ज़्यादा सटीक अनुमानों के साथ अपडेट किया जा सकता है. |
processingDetails.processingProgress.partsProcessed |
unsigned long वीडियो के कितने हिस्सों को 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 |
object suggestions ऑब्जेक्ट, सुझावों को एक साथ दिखाता है. इससे वीडियो की क्वालिटी या अपलोड किए गए वीडियो के मेटाडेटा को बेहतर बनाने वाले सुझावों की पहचान की जाती है. इस डेटा को सिर्फ़ वीडियो का मालिक ही वापस ला सकता है. 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 |
object liveStreamingDetails ऑब्जेक्ट में, लाइव वीडियो ब्रॉडकास्ट का मेटाडेटा होता है. ऑब्जेक्ट, 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 |
object localizations ऑब्जेक्ट में, वीडियो के मेटाडेटा के अनुवाद मौजूद होते हैं. |
localizations.(key) |
object मुख्य वैल्यू से जुड़े स्थानीय भाषा में लिखे टेक्स्ट की भाषा. वैल्यू एक स्ट्रिंग है, जिसमें BCP-47 भाषा कोड होता है. |
localizations.(key).title |
string स्थानीय भाषा में बनाए गए वीडियो का टाइटल. |
localizations.(key).description |
string स्थानीय जगह के अनुसार वीडियो का ब्यौरा. |