YouTube API सेवाएं - ज़रूरी कम से कम सुविधाएं

ध्यान दें: डेवलपर के लिए बनाई गई YouTube की नीतियों का पालन करने से, आपको उदाहरण और दिशा-निर्देश मिलते हैं. इनसे आपको यह पक्का करने में मदद मिलती है कि आपके एपीआई क्लाइंट, YouTube API सेवाओं की शर्तों और नीतियों (एपीआई की सेवा की शर्तों) के खास हिस्सों का पालन करें. इस गाइड में इस बारे में अहम जानकारी दी गई है कि YouTube, एपीआई की सेवा की शर्तों के कुछ पहलुओं को कैसे लागू करता है. हालांकि, यह किसी मौजूदा दस्तावेज़ की जगह नहीं लेती.

इस दस्तावेज़ में, एपीआई क्लाइंट के लिए फ़ंक्शन से जुड़ी उन ज़रूरी शर्तों के बारे में बताया गया है जो YouTube API सेवाओं ("एपीआई क्लाइंट") की खास सुविधाएं लागू करने या उनका ऐक्सेस देने के लिए होती हैं.

इन ज़रूरी शर्तों और दिशा-निर्देशों से यह पक्का होता है कि एपीआई क्लाइंट, एक जैसा उपयोगकर्ता अनुभव दे रहे हैं. इससे YouTube इस्तेमाल करने वालों, कॉन्टेंट के मालिकों, और विज्ञापन देने वालों के हितों की रक्षा की जा सकती है. ये नियम YouTube API की सेवा की शर्तों का अहम हिस्सा हैं. किसी भी एपीआई क्लाइंट को बनाते और लागू करते समय इनका पालन किया जाना चाहिए.

आपको इस दस्तावेज़ में दी गई ज़रूरी शर्तों में बदलाव करना होगा, ताकि हम YouTube की मौजूदा सुविधाओं का इस्तेमाल करने वाले लोगों को बेहतर अनुभव दे सकें. YouTube की नई और अपडेट की गई सुविधाओं के हिसाब से, इन नीतियों में भी बदलाव होंगे. कभी-कभी, इन बदलावों की वजह से आपको अपने एपीआई क्लाइंट अपडेट करने पड़ सकते हैं, ताकि नई ज़रूरी शर्तों को पूरा किया जा सके. सेवा की शर्तों में किए गए बदलावों का इतिहास सेक्शन में किए गए सभी बदलावों को दर्ज करेगा. इसलिए, कृपया उस दस्तावेज़ को समय-समय पर देखते रहें या इसके आरएसएस फ़ीड की सदस्यता लें. इससे, आपको उन बदलावों के बारे में जल्दी पता चल जाएगा जिनका आपके एपीआई क्लाइंट पर असर पड़ सकता है.

इस दस्तावेज़ में दी गई ज़रूरी शर्तों के अलावा, हमारा सुझाव है कि आप YouTube API की सेवाओं की नीतियों में बताए गए सबसे सही तरीके अपनाएं. साथ ही, YouTube API सेवाओं के दस्तावेज़ों में दी गई दूसरी जगहों पर इनके बारे में बताया गया है. अगर ये तरीके पूरी तरह से ज़रूरी न हों, तब भी इन तरीकों की मदद से आपके एपीआई क्लाइंट, गड़बड़ियों को जल्द से जल्द ठीक कर पाते हैं. साथ ही, अगर वे कोटा तय करने वाली YouTube API सेवाओं का इस्तेमाल करते हैं, तो उनका कोटा इस्तेमाल ऑप्टिमाइज़ करने में मदद मिलती है. साथ ही, ये तरीके YouTube नेटवर्क को सुरक्षित रखने में मदद करते हैं. साथ ही, इनसे आपके एपीआई क्लाइंट और YouTube ऐप्लिकेशन के उपयोगकर्ताओं को बेहतर अनुभव देने में भी मदद मिलती है.

YouTube एम्बेड किया गया प्लेयर और वीडियो चलाना

इस सेक्शन में दी गई शर्तें खास तौर पर एम्बेड किए गए YouTube प्लेयर के लिए हैं. YouTube API सेवाओं की नीतियों में, ऐसे एपीआई क्लाइंट के लिए कई नीतियां भी शामिल हैं जो YouTube पर ऑडियोविज़ुअल कॉन्टेंट चलाते हैं.

एम्बेड किए गए YouTube प्लेयर का साइज़

एम्बेड किए गए प्लेयर में कम से कम 200 पिक्सल x 200 पिक्सल वाला एक व्यूपोर्ट होना चाहिए. अगर प्लेयर कंट्रोल दिखाता है, तो व्यूपोर्ट को छोटा किए बिना, कंट्रोल को पूरी तरह से दिखाने के लिए इसका साइज़ तय सीमा से कम होना चाहिए. हमारा सुझाव है कि 16:9 प्लेयर कम से कम 480 पिक्सल चौड़ी और 270 पिक्सल लंबी होनी चाहिए.

अपने-आप चलने वाले और स्क्रिप्ट किए गए वीडियो चलाने की सुविधा

इस सेक्शन में, वीडियो अपने-आप चलने की सुविधा के बारे में बताया गया है. यह नीति, एम्बेड किए गए उन YouTube प्लेयर पर लागू होती है जो autoplay प्लेयर पैरामीटर का इस्तेमाल करते हैं. इसके अलावा, YouTube IFrame Player API सेवा, YouTube Android Player API सेवा या किसी दूसरी YouTube API सेवा का इस्तेमाल करके, प्रोग्राम के ज़रिए अपने-आप वीडियो चलने की सुविधा शुरू कर सकते हैं.

• एम्बेड किए गए जो प्लेयर अपने-आप वीडियो चलाते हैं उन्हें पेज लोड होते ही या एम्बेड किए गए प्लेयर के पूरी तरह दिखने पर, तुरंत वीडियो चलाना शुरू कर देना चाहिए. हालांकि, एपीआई क्लाइंट को अपने-आप वीडियो तब तक नहीं चलाना चाहिए, जब तक प्लेयर न दिख रहा हो और पेज या स्क्रीन पर प्लेयर का आधा से ज़्यादा हिस्सा न दिख रहा हो.

• किसी पेज या स्क्रीन पर एक से ज़्यादा YouTube प्लेयर नहीं होने चाहिए, जो एक साथ अपने-आप कॉन्टेंट चलाते हों.

• YouTube के जिस थंबनेल से वीडियो चलना शुरू होता है वह कम से कम 120 पिक्सल चौड़ा और 70 पिक्सल लंबा होना चाहिए.

YouTube प्लेयर की विशेषताएं

YouTube प्लेयर के एट्रिब्यूट और पैरामीटर, YouTube API दस्तावेज़ और स्पेसिफ़िकेशन (https://developers.google.com/youtube) में बताए गए हैं. इनमें, प्लेयर में YouTube ब्रैंडिंग के दिखने का तरीका भी शामिल है. आपको YouTube प्लेयर में ऐसे बदलाव नहीं करने चाहिए जिनके बारे में एपीआई दस्तावेज़ में साफ़ तौर पर न बताया गया हो.

ओवरले और फ़्रेम

YouTube के एम्बेड किए गए प्लेयर के किसी भी हिस्से के सामने ओवरले, फ़्रेम या दूसरे विज़ुअल एलिमेंट नहीं दिखाए जा सकते. इसमें प्लेयर कंट्रोल भी शामिल हैं. इसी तरह, एम्बेड किए गए प्लेयर के किसी भी हिस्से को धुंधला करने के लिए, ओवरले, फ़्रेम या दूसरे विज़ुअल एलिमेंट का इस्तेमाल न करें. इसमें प्लेयर कंट्रोल भी शामिल हैं.

माउसओवर

उपयोगकर्ता की ओर से कोई भी कार्रवाई शुरू करने के लिए, आपको YouTube प्लेयर पर माउसओवर या टच इवेंट का इस्तेमाल नहीं करना चाहिए. जैसे, विंडो खोलना या चैनल की सदस्यता लेना.

वीडियो अपलोड करना

अगर एपीआई क्लाइंट, उपयोगकर्ताओं को एक से ज़्यादा प्लैटफ़ॉर्म पर कॉन्टेंट अपलोड करने की सुविधा देते हैं, तो उपयोगकर्ताओं को उन प्लैटफ़ॉर्म को चुनने और चुने हुए का निशान हटाने का विकल्प मिलना चाहिए जिन पर वे अपने वीडियो अपलोड करना चाहते हैं.

डेटा से जुड़ी ज़रूरी शर्तें

जिन एपीआई क्लाइंट ने उपयोगकर्ताओं को YouTube पर वीडियो अपलोड करने की सुविधा दी है उन्हें नीचे दी गई सूची में वैल्यू सेट करने के लिए, उपयोगकर्ताओं को चालू करना होगा. सूची में शामिल न की गई प्रॉपर्टी ज़रूरी नहीं होती हैं.

	नाम	ब्यौरा
संसाधन प्रॉपर्टी
	snippet.title	ज़रूरी है. वीडियो का टाइटल. अगर वैल्यू 100 वर्णों से ज़्यादा है, तो YouTube गड़बड़ी वाला मैसेज दिखाता है. YouTube पर < और > को छोड़कर, सभी मान्य UTF-8 वर्णों का इस्तेमाल किया जा सकता है.
	snippet.description	ज़रूरी है. वीडियो का ब्यौरा. अगर वैल्यू 5000 बाइट से ज़्यादा होती है, तो YouTube गड़बड़ी का मैसेज दिखाता है. YouTube पर < और > को छोड़कर, सभी मान्य UTF-8 वर्णों का इस्तेमाल किया जा सकता है.
	status.privacyStatus	ज़रूरी है. वीडियो की निजता सेटिंग. उपयोगकर्ताओं के पास यह चुनने का विकल्प होना चाहिए कि अपलोड किया गया वीडियो सार्वजनिक, निजी या सबके लिए मौजूद नहीं है.
पैरामीटर का अनुरोध करना
	onBehalfOfContentOwnerChannel	कुछ शर्तों के मुताबिक ज़रूरी है. अगर अनुरोध की अनुमति देने वाले क्रेडेंशियल से किसी कॉन्टेंट के मालिक की पहचान होती है और onBehalfOfContentOwner पैरामीटर सेट होता है, तो एपीआई उपयोगकर्ता के पास वह YouTube चैनल भी होना चाहिए जिस पर वीडियो अपलोड किया जा रहा है.

टिप्पणियां दिखाई जा रही हैं

	नाम	ब्यौरा
संसाधन प्रॉपर्टी
	snippet.textDisplay	ज़रूरी है. टिप्पणी का टेक्स्ट. एपीआई क्लाइंट को (a) किसी टिप्पणी या टिप्पणी के जवाब का पूरा टेक्स्ट दिखाना चाहिए या (b) टेक्स्ट को छोटा करके, दर्शकों के लिए छोटा किए गए वर्शन से पूरे टेक्स्ट को ऐक्सेस करने का तरीका बताना होगा. यह ज़रूरी शर्त सभी टिप्पणियों और टिप्पणियों के जवाबों पर लागू होती है, फिर चाहे टिप्पणियां किसी भी तरह के संसाधन (वीडियो, चैनल वगैरह) से जुड़ी हों. ध्यान दें कि commentThread संसाधन की snippet.topLevelComment प्रॉपर्टी की वैल्यू comment है और संसाधनों की सूची comment है.replies.comments[] इसलिए, यह ज़रूरी शर्त snippet.topLevelComment.snippet.textDisplay और replies.comments[].snippet.textDisplay प्रॉपर्टी पर भी लागू होती है.
	snippet.title (channel)	ज़रूरी है (सुझाव). चैनल का टाइटल. अगर टिप्पणी किसी चैनल से जुड़ी है, तो एपीआई क्लाइंट को चैनल का नाम दिखाना होगा. अगर टिप्पणी किसी वीडियो से जुड़ी है, तो एपीआई क्लाइंट को उस चैनल का नाम दिखाना होगा जिससे वीडियो अपलोड किया गया था.
	snippet.title (video)	कुछ शर्तों के मुताबिक ज़रूरी है (सुझाव). वीडियो का टाइटल. अगर टिप्पणी किसी वीडियो से जुड़ी है, तो यह वैल्यू दिखाना ज़रूरी है.
	snippet.moderationStatus	कुछ शर्तों के मुताबिक ज़रूरी है. अगर एपीआई अनुरोध में moderationStatus पैरामीटर की वैल्यू heldForReview या likelySpam है, तो डिसप्ले में प्रॉपर्टी की वैल्यू, मिलती-जुलती भाषा, जैसे कि "इस टिप्पणी को समीक्षा के लिए रोकी गई है"), हेडर (जैसे, "समीक्षा के लिए रोकी गई") या दूसरी आसान भाषा का इस्तेमाल करके उस स्थिति की साफ़ तौर पर पहचान की जानी चाहिए. commentThreads.list तरीके से, टिप्पणियों को मॉडरेट करने की स्थिति के आधार पर वापस पाया जा सकता है.

टिप्पणियां जोड़ना

	नाम	ब्यौरा
संसाधन प्रॉपर्टी
	snippet.title (channel)	ज़रूरी है. चैनल का टाइटल. अगर उपयोगकर्ता किसी चैनल के बारे में टिप्पणी जोड़ रहा है, तो एपीआई क्लाइंट को चैनल का नाम दिखाना होगा. अगर उपयोगकर्ता किसी वीडियो के बारे में टिप्पणी जोड़ रहा है, तो एपीआई क्लाइंट को उस चैनल का नाम दिखाना होगा जिससे वीडियो अपलोड किया गया था.
	snippet.title (video)	ज़रूरी है. अगर उपयोगकर्ता किसी वीडियो के बारे में टिप्पणी जोड़ रहा है, तो एपीआई क्लाइंट को वीडियो का टाइटल दिखाना होगा.
अन्य ज़रूरी शर्तें
	Comment author's channel name	ज़रूरी है. एपीआई क्लाइंट को उस YouTube उपयोगकर्ता खाते की साफ़ तौर पर पहचान करनी चाहिए जिससे टिप्पणी की जाएगी. अगर अनुरोध की अनुमति देने वाले क्रेडेंशियल से किसी कॉन्टेंट के मालिक की पहचान होती है और onBehalfOfContentOwner पैरामीटर सेट होता है, तो एपीआई उपयोगकर्ता के पास वह YouTube चैनल भी होना चाहिए जिसे टिप्पणी एट्रिब्यूट की जाएगी.

टिप्पणियों के जवाब जोड़ना

	नाम	ब्यौरा
संसाधन प्रॉपर्टी
	snippet.textDisplay	ज़रूरी है. टिप्पणी का टेक्स्ट. एपीआई क्लाइंट को उस टिप्पणी का टेक्स्ट दिखाना चाहिए जिसका जवाब उपयोगकर्ता दे रहा है. यह टेक्स्ट, इस दस्तावेज़ के टिप्पणियां दिखाना सेक्शन में बताए गए नियमों के मुताबिक होना चाहिए.
	snippet.title (channel)	ज़रूरी है. चैनल का टाइटल. अगर उपयोगकर्ता किसी चैनल के बारे में की गई टिप्पणी का जवाब दे रहा है, तो एपीआई क्लाइंट को चैनल का नाम दिखाना होगा. अगर उपयोगकर्ता किसी वीडियो के बारे में की गई टिप्पणी का जवाब दे रहा है, तो एपीआई क्लाइंट को वीडियो अपलोड करने वाले चैनल का नाम दिखाना होगा.
	snippet.title (video)	ज़रूरी है. अगर उपयोगकर्ता किसी वीडियो के बारे में की गई टिप्पणी का जवाब दे रहा है, तो एपीआई क्लाइंट को वीडियो का टाइटल दिखाना चाहिए.
अन्य ज़रूरी शर्तें
	Comment author's channel name	ज़रूरी है. एपीआई क्लाइंट को उस YouTube उपयोगकर्ता खाते की साफ़ तौर पर पहचान करनी चाहिए जिससे टिप्पणी का जवाब दिया जाएगा. अगर अनुरोध की अनुमति देने वाले क्रेडेंशियल से किसी कॉन्टेंट के मालिक की पहचान होती है और onBehalfOfContentOwner पैरामीटर सेट होता है, तो एपीआई उपयोगकर्ता के पास वह YouTube चैनल भी होना चाहिए जिसे टिप्पणी का जवाब दिया जाएगा.

टिप्पणियों के जवाबों में बदलाव करना या उन्हें मिटाना

	नाम	ब्यौरा
संसाधन प्रॉपर्टी
	snippet.textDisplay	ज़रूरी है. टिप्पणी का टेक्स्ट. एपीआई क्लाइंट को उस टिप्पणी का टेक्स्ट दिखाना होगा जिसमें उपयोगकर्ता बदलाव कर रहा है या जिसे मिटा रहा है. यह टेक्स्ट, इस दस्तावेज़ के टिप्पणियां दिखाना सेक्शन में बताए गए नियमों के मुताबिक होना चाहिए.
	snippet.title (channel)	ज़रूरी है. चैनल का टाइटल. अगर उपयोगकर्ता किसी चैनल की टिप्पणी में बदलाव कर रहा है या उसे मिटा रहा है, तो एपीआई क्लाइंट को चैनल का नाम दिखाना चाहिए. अगर उपयोगकर्ता किसी वीडियो पर की गई टिप्पणी में बदलाव कर रहा है या उसे मिटा रहा है, तो एपीआई क्लाइंट को उस चैनल का नाम दिखाना होगा जिसने वीडियो अपलोड किया था.
	snippet.title (video)	ज़रूरी है. अगर उपयोगकर्ता किसी वीडियो के बारे में की गई टिप्पणी में बदलाव कर रहा है या उसे मिटा रहा है, तो एपीआई क्लाइंट को वीडियो का टाइटल दिखाना चाहिए.
अन्य ज़रूरी शर्तें
	Comment author's channel name	ज़रूरी है. एपीआई क्लाइंट को उस YouTube उपयोगकर्ता खाते की साफ़ तौर पर पहचान करनी चाहिए जिससे टिप्पणी की गई है.

किसी व्यक्ति को लाइव चैट से प्रतिबंधित करना (या प्रतिबंध हटाना)

	नाम	ब्यौरा
संसाधन प्रॉपर्टी
	snippet.title (channel)	ज़रूरी है. उस YouTube चैनल का नाम जिस पर पाबंदी लगाई गई है या जिस पर पाबंदी लगाई गई है. इसके अलावा, नाम को चैनल से लिंक होना चाहिए या चैनल का यूआरएल भी दिखाया जाना चाहिए.
अन्य ज़रूरी शर्तें
	टिप्पणी करने वाले चैनल का नाम	ज़रूरी है. एपीआई क्लाइंट को उस YouTube उपयोगकर्ता खाते की साफ़ तौर पर पहचान करनी चाहिए जिसका इस्तेमाल पाबंदी को जोड़ने या हटाने के लिए किया जा रहा है.