28 जुलाई, 2020 के बाद बनाए गए, बिना पुष्टि वाले एपीआई प्रोजेक्ट से
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 }, "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 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 Unterrict, 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 culas से वीडियो को मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
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 (सीएनए) से मिली वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.cncRating |
string फ़्रांस में रेटिंग सिस्टम - कमीशन डी क्लासिफ़िकेशन सिनेमैटोग्राफ़िक इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.csaRating |
string फ़्रांस के Conseil supérieur de l?audiovisuel से मिले वीडियो की रेटिंग, ब्रॉडकास्ट कॉन्टेंट की रेटिंग क्या है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.cscfRating |
string लक्ज़मबर्ग के Commission de Sulation de de laटैगिंग des Films (सीएससीएफ़) से वीडियो को मिली रेटिंग. इस प्रॉपर्टी के लिए सही वैल्यू ये हैं:
|
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 प्रॉपर्टी का इस्तेमाल करें.इस वीडियो की रेटिंग सेंटर नैशनल ड्यू cinéma et de l'image animé (फ़्रेंच मिनिस्ट्री ऑफ़ कल्चर) की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.fpbRating |
string दक्षिण अफ़्रीका के फ़िल्म ऐंड पब्लिकेशन बोर्ड से वीडियो को मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.fpbRatingReasons[] |
list वीडियो को एफ़पीबी (दक्षिण अफ़्रीका) से रेटिंग क्यों मिली, इसकी वजहें. |
contentDetails.contentRating.fskRating |
string इस वीडियो को मिली Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - Germany) रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.grfilmRating |
string वीडियो को ग्रीस में रेटिंग मिली है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.icaaRating |
string वीडियो को Instituto de la Cinematografía y de las Artes Audio बेहतरीनes (ICAA - Spain) की रेटिंग दी गई है. इस प्रॉपर्टी के लिए, मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.ifcoRating |
string वीडियो की आयरिश फ़िल्म क्लासिफ़िकेशन ऑफ़िस (आईएफ़सीओ - आयरलैंड) की रेटिंग. ज़्यादा जानकारी के लिए, IFCO की वेबसाइट देखें. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.ilfilmRating |
string वीडियो को इज़रायल में रेटिंग दी गई है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.incaaRating |
string वीडियो को IncAA (Instituto Nacional de Cine y Artes AudioVisuales - अर्जेंटीना) की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.kfcbRating |
string केन्या फ़िल्म क्लासिफ़िकेशन बोर्ड से वीडियो को मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.kijkwijzerRating |
string voor de Classificatie van Audiovisuele Media (नीदरलैंड्स). इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.kmrbRating |
string वीडियो की कोरिया मीडिया रेटिंग बोर्ड (영상물등위원बोन) में दी गई रेटिंग. KMRB, दक्षिण कोरिया में वीडियो को रेटिंग देता है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.lsfRating |
string वीडियो को इंडोनेशिया की लेंबागा सेंसर फ़िल्म ने रेटिंग दी है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mccaaRating |
string माल्टा के फ़िल्म एज-क्लासिफ़िकेशन बोर्ड ने वीडियो को रेटिंग दी है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mccypRating |
string डेनिश फ़िल्म इंस्टिट्यूट के (Det Danske Moviesinstitut) मीडिया काउंसिल फ़ॉर चिल्ड्रन ऐंड यंग पीपल से मिली वीडियो को रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
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 Minio dei Beni e delle Attività Culturali e del Turismo (इटली) से मिले वीडियो की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.mocRating |
string वीडियो की Minsurio 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 Nacion जाएगीs कीनो सेंटर (नैशनल फ़िल्म सेंटर ऑफ़ लातविया) से वीडियो को मिली रेटिंग. इस प्रॉपर्टी के लिए सही वैल्यू ये हैं:
|
contentDetails.contentRating.oflcRating |
string वीडियो के ऑफ़िस ऑफ़ फ़िल्म ऐंड लिटरेचर क्लासिफ़िकेशन (ओएफ़एलसी - न्यूज़ीलैंड) की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.pefilmRating |
string पेरू में वीडियो को मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.resorteviolenciaRating |
string वेनेज़ुएला में वीडियो को मिली रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.rtcRating |
string वीडियो को जनरल डायरेक्टरेट ऑफ़ रेडियो, टेलिविज़न ऐंड सिनेमैटोग्राफ़ी (मेक्सिको) की रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.rteRating |
string आयरलैंड के Raidió Teilifís Éireann ने वीडियो को रेटिंग दी है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.contentRating.russiaRating |
string वीडियो की नैशनल फ़िल्म रजिस्ट्री ऑफ़ द रशियन फ़ेडरेशन (एमकेआरएफ़ - रूस) रेटिंग. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
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 ने अपलोड की गई वीडियो फ़ाइल को कितना प्रोसेस किया है. ऑब्जेक्ट में मौजूद प्रॉपर्टी, वीडियो प्रोसेस होने की मौजूदा स्थिति की पहचान करती हैं. साथ ही, यह भी बताती हैं कि वीडियो को प्रोसेस होने में कितना समय लग सकता है. इस हिस्से से यह भी पता चलता है कि वीडियो के लिए अलग-अलग तरह का डेटा या कॉन्टेंट उपलब्ध है या नहीं, जैसे कि फ़ाइल की जानकारी या थंबनेल इमेज.processingProgress ऑब्जेक्ट को पोल कराने के लिए डिज़ाइन किया गया है, ताकि अपलोड किया गया वीडियो इस बात को ट्रैक कर सके कि अपलोड की गई वीडियो फ़ाइल को प्रोसेस करने के दौरान, YouTube ने क्या-क्या किया है. इस डेटा को सिर्फ़ वीडियो का मालिक ही वापस ला सकता है. |
processingDetails.processingStatus |
string वीडियो प्रोसेस होने की स्थिति. इस वैल्यू से पता चलता है कि YouTube, वीडियो को प्रोसेस कर पाया या नहीं. इसके अलावा, यह भी पता चलता है कि वीडियो अब भी प्रोसेस हो रहा है या नहीं. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
processingDetails.processingProgress |
object processingProgress ऑब्जेक्ट में, यह जानकारी होती है कि 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 |
object suggestions ऑब्जेक्ट में सुझावों को शामिल किया जाता है. ये सुझाव, अपलोड किए गए वीडियो की क्वालिटी या मेटाडेटा को बेहतर बनाने के मौकों की पहचान करते हैं. इस डेटा को सिर्फ़ वीडियो का मालिक ही वापस ला सकता है. suggestions ऑब्जेक्ट सिर्फ़ तब दिखाया जाएगा, जब processingDetails.tagSuggestionsAvailability प्रॉपर्टी या processingDetails.editorSuggestionsAvailability प्रॉपर्टी की वैल्यू available हो. |
suggestions.processingErrors[] |
list उन गड़बड़ियों की सूची जिनकी वजह से YouTube, अपलोड किए गए वीडियो को प्रोसेस नहीं कर पाएगा. इन गड़बड़ियों से पता चलता है कि वीडियो का मौजूदा प्रोसेसिंग स्टेटस चाहे कुछ भी हो, करीब-करीब यह स्टेटस failed ही रहेगा.इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
suggestions.processingWarnings[] |
list 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 स्थानीय भाषा के हिसाब से बनाए गए वीडियो का ब्यौरा. |