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 के एम्बेड किए गए प्लेयर (इसमें YouTube IFrame Player API भी शामिल है) का इस्तेमाल करने वाले एपीआई क्लाइंट को HTTP Referer अनुरोध हेडर की मदद से पहचान देनी होगी. कुछ एनवायरमेंट में, ब्राउज़र अपने-आप HTTP Referer सेट कर देगा. साथ ही, एपीआई क्लाइंट को सिर्फ़ यह पक्का करना होगा कि वे Referrer-Policy को इस तरह से सेट न कर रहे हों कि Referer वैल्यू को दबा दिया जाए. YouTube का सुझाव है कि आप strict-origin-when-cross-origin Referrer-Policy का इस्तेमाल करें. यह कई ब्राउज़र में पहले से ही डिफ़ॉल्ट रूप से सेट होता है.

इसी तरह, अगर JavaScript window.open का इस्तेमाल करके बनाई गई विंडो में YouTube के एम्बेड किए गए प्लेयर को इंटिग्रेट किया जा रहा है, तो एपीआई क्लाइंट को noreferrer सुविधा का इस्तेमाल नहीं करना चाहिए. यह सुविधा Referer वैल्यू को दबा देती है.

रेफ़रर सेट करना

जिन एनवायरमेंट में HTTP Referer डिफ़ॉल्ट रूप से खाली होता है और ब्राउज़र इसे अपने-आप सेट नहीं करता है वहां एपीआई क्लाइंट को अन्य तरीकों से अपनी पहचान बताने के लिए कार्रवाई करनी होगी. मोबाइल ऐप्लिकेशन या डेस्कटॉप ऐप्लिकेशन जैसे वेबव्यू इंटिग्रेशन में, HTTP Referer डिफ़ॉल्ट रूप से खाली होता है और Referer को आम तौर पर इनमें से किसी एक तकनीक का इस्तेमाल करके सेट किया जाता है:

• स्थानीय एचटीएमएल फ़ाइल में प्लेयर वाला मोबाइल ऐप्लिकेशन

  इस कॉन्फ़िगरेशन में, प्लेयर को ऐप्लिकेशन के साथ बंडल की गई एचटीएमएल फ़ाइल में लोड किया जाता है. इस एचटीएमएल फ़ाइल को लोड करते समय, baseUrl पैरामीटर सेट करने पर Referer सेट हो जाएगा.

  • Android loadDataWithBaseURL
  • iOS loadHTMLString:baseURL:

• स्थानीय एचटीएमएल फ़ाइल के बिना मोबाइल ऐप्लिकेशन

  इस कॉन्फ़िगरेशन में, प्लेयर को सीधे https://www.youtube.com/embed/VIDEO_ID से लोड किया जाता है. इसके लिए, किसी एचटीएमएल फ़ाइल का इस्तेमाल नहीं किया जाता. Referer को एचटीटीपी हेडर के तौर पर जोड़कर सेट किया जाता है:

  • additionalHttpHeaders पैरामीटर में जोड़े गए Referer एचटीटीपी हेडर के साथ Android loadUrl

  • iOS loadRequest:, जिसमें अनुरोध में Referer एचटीटीपी हेडर जोड़ा गया है. उदाहरण के लिए:

    NSString *bundleId = [[NSBundle mainBundle] bundleIdentifier];
    NSString *referrer = [[NSString stringWithFormat:@"https://%@", bundleId] lowercaseString];
    NSURL *referrerUrl = [NSURL URLWithString:referrer];
    
    NSString *destination = @"https://www.youtube.com/embed/VIDEO_ID";
    NSURL *destinationUrl = [NSURL URLWithString:destination];
    
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:destinationUrl];
    [request addValue:referrerUrl forHTTPHeaderField:@"Referer"];
    
    // Create an instance of WKWebView (omitted for simplicity), then load the NSMutableURLRequest.
    [webView loadRequest:request];
    

• नेटिव ब्राउज़र टैब में प्लेयर वाला मोबाइल ऐप्लिकेशन

  • Android CustomTabs

    रेफ़रर सेट करने के लिए, Intent.EXTRA_REFERRER का इस्तेमाल करें. Uri बनाते समय, https:// के बजाय android-app:// स्कीम का इस्तेमाल करना न भूलें. उदाहरण के लिए:

    String destinationUrl = "https://www.youtube.com/embed/VIDEO_ID";
    CustomTabsIntent customTabsIntent = new CustomTabsIntent.Builder().build()
    customTabsIntent.intent.putExtra(Intent.EXTRA_REFERRER, Uri.parse("android-app://" + context.getPackageName()));
    customTabsIntent.launchUrl(this, Uri.parse(destinationUrl));
    

  • iOS SFSafariViewController

    SFSafariViewController पर Referer सेट नहीं किया जा सकता. इस मामले में, इसके बजाय origin प्लेयर पैरामीटर सेट करें.

• डेस्कटॉप ऐप्लिकेशन

  इस कॉन्फ़िगरेशन में, Referer को एचटीटीपी हेडर के तौर पर जोड़कर सेट करें:

  • Microsoft .NET - HttpRequestHeaders.Referrer या CoreWebView2HttpRequestHeaders.SetHeader का इस्तेमाल करें
  • macOS - iOS मोबाइल ऐप्लिकेशन के लिए ऊपर दिए गए निर्देशों का पालन करें

जिन प्लैटफ़ॉर्म पर HTTP Referer डिफ़ॉल्ट रूप से खाली होता है उनके लिए, Referer वैल्यू सेट करें. इसके लिए, उस वेबव्यू को कॉन्फ़िगर करें जिसमें प्लेयर लोड किया गया है. प्लैटफ़ॉर्म के हिसाब से, इसकी सटीक तकनीक अलग-अलग हो सकती है.

अगर आपके पास किसी ऐसी लाइब्रेरी, फ़्रेमवर्क, प्लग इन, सेवा या रैपर का मालिकाना हक है जिसका इस्तेमाल डेवलपर, YouTube के एम्बेड किए गए प्लेयर को इंटिग्रेट करने के लिए करते हैं, तो आपको एनवायरमेंट से ऐप्लिकेशन आईडी वापस पाना होगा. हालांकि, प्लैटफ़ॉर्म के हिसाब से ऐसा करना मुमकिन नहीं हो सकता. इसके अलावा, डेवलपर को अपना ऐप्लिकेशन आईडी पास करने की अनुमति भी दी जा सकती है, ताकि ऊपर बताए गए तरीके से Referer (और अगर ज़रूरी हो, तो widget_referrer प्लेयर पैरामीटर) सेट किया जा सके.

रेफ़रर फ़ॉर्मैट

वेबव्यू पैरामीटर सेट करके या एचटीटीपी हेडर जोड़कर, रेफ़रर को साफ़ तौर पर उपलब्ध कराने पर, आम तौर पर फ़ॉर्मैट पूरी तरह से सही यूआरएल होता है. प्रोटोकॉल के तौर पर HTTPS डालें. यूआरएल में, डोमेन नेम आपका ऐप्लिकेशन आइडेंटिफ़ायर ("ऐप्लिकेशन आईडी") होना चाहिए. यह आईडी उस स्टोर के साथ रजिस्टर होना चाहिए जिसने आपके ऐप्लिकेशन को असली उपयोगकर्ताओं तक पहुंचाया है. अगर आपका ऐप्लिकेशन, लोगों को किसी अन्य डिस्ट्रिब्यूशन चैनल के ज़रिए उपलब्ध कराया जाता है, तो ऐप्लिकेशन इंस्टॉल करने के दौरान ऑपरेटिंग सिस्टम के साथ रजिस्टर किए गए ऐप्लिकेशन आईडी का इस्तेमाल करें. ज़्यादातर मामलों में, आपका ऐप्लिकेशन आईडी, com.google.android.youtube जैसा रिवर्स डोमेन नेम (इसे "रिवर्स-डीएनएस फ़ॉर्मैट" भी कहा जाता है) होगा. उदाहरण के लिए:

• ChromeOS पर Android OS और Android ऐप्लिकेशन: ऐप्लिकेशन आईडी
• Apple के प्लैटफ़ॉर्म, जिनमें iOS, iPadOS, और macOS शामिल हैं: बंडल आईडी
• Samsung Tizen: ऐप्लिकेशन आईडी
• Linux डिस्ट्रिब्यूशन:
  • Fedora: ऐप्लिकेशन आईडी
  • Gnome: ऐप्लिकेशन आईडी
  • Ubuntu: ऐप्लिकेशन आईडी

कुछ प्लैटफ़ॉर्म पर, ऐप्लिकेशन आईडी, रिवर्स किया गया डोमेन नेम नहीं होता. इन मामलों में, ऐप्लिकेशन को डिस्ट्रिब्यूट करने वाले स्टोर से असाइन किए गए यूनीक ऐप्लिकेशन आईडी का इस्तेमाल करें. जब स्टोर ऐप्लिकेशन आईडी, जनरेट की गई अक्षर और अंकों वाली स्ट्रिंग होती है (इसे स्टोर या डेवलपमेंट टूल असाइन करते हैं, ऐप्लिकेशन डेवलपर नहीं), तो ऐप्लिकेशन के डिसप्ले नेम (स्पेस को हाइफ़न से बदलकर) और स्टोर ऐप्लिकेशन आईडी, दोनों को शामिल करें. साथ ही, दोनों के बीच में पीरियड लगाएं. उदाहरण के लिए: <my-app-name>.<AppID>. यह वैल्यू, ऐप्लिकेशन के वर्शन में होने वाले बदलावों के दौरान स्थिर होनी चाहिए. अगर ऐप्लिकेशन किसी स्टोर पर होस्ट नहीं किया गया है, तो उस ऐप्लिकेशन आईडी का इस्तेमाल करें जिसे ऐप्लिकेशन इंस्टॉल करने के दौरान, ऑपरेटिंग सिस्टम के साथ रजिस्टर किया गया है. आम तौर पर, यह ऐप्लिकेशन मेनिफ़ेस्ट में मौजूद यूनीक आइडेंटिफ़ायर होता है. ऐप्लिकेशन के वर्शन और काम करने वाले आर्किटेक्चर के बारे में कोई जानकारी शामिल न करें. उदाहरण के लिए:

• Chrome Web Store: स्टोर पर होस्ट किया गया

  आम तौर पर, स्टोर ऐप्लिकेशन आईडी, ऐप्लिकेशन के यूआरएल https://chromewebstore.google.com/detail/<hyphenated-app-name>/<AppID> में पाथ का आखिरी हिस्सा होता है. ऊपर बताई गई <my-app-name>.<AppID> स्ट्रिंग बनाने के लिए, हाइफ़न वाले ऐप्लिकेशन के नाम और स्टोर ऐप्लिकेशन आईडी का इस्तेमाल करें.

• Windows: स्टोर पर होस्ट किया गया

  आम तौर पर, स्टोर ऐप्लिकेशन आईडी, ऐप्लिकेशन यूआरएल https://apps.microsoft.com/detail/<AppID> में पाथ का आखिरी हिस्सा होता है. ऊपर बताई गई <my-app-name>.<AppID> स्ट्रिंग बनाने के लिए, स्टोर ऐप्लिकेशन आईडी का इस्तेमाल करें. हाइफ़न लगाकर लिखा गया ऐप्लिकेशन का नाम भी शामिल करना होगा.

• Windows: स्टोर के बाहर डिस्ट्रिब्यूशन

  Windows ऐप्लिकेशन के मेनिफ़ेस्ट में पैकेज आइडेंटिटी मौजूद होती है: Name_Version_Architecture_ResourceID_PublisherID. सिर्फ़ Name एट्रिब्यूट का इस्तेमाल करें.

• Xbox: स्टोर पर होस्ट किया गया

  आम तौर पर, स्टोर ऐप्लिकेशन आईडी, ऐप्लिकेशन के यूआरएल https://www.xbox.com/<region>/games/store/<hyphenated-app-name>/<AppID> में पाथ का आखिरी हिस्सा होता है. ऊपर बताई गई <my-app-name>.<AppID> स्ट्रिंग बनाने के लिए, हाइफ़न वाले ऐप्लिकेशन के नाम और स्टोर ऐप्लिकेशन आईडी का इस्तेमाल करें.

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

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

वेबव्यू का टाइप

YouTube के एम्बेड किए गए प्लेयर को वेबव्यू में इंटिग्रेट करते समय, ओएस के उपलब्ध वेबव्यू टाइप में से किसी एक का इस्तेमाल करें. उदाहरण के लिए:

• Android OS: WebView या CustomTabs
• Apple के प्लैटफ़ॉर्म, जिनमें iOS, iPadOS, और macOS शामिल हैं: WKWebView या SFSafariViewController

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

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

ऑटोप्ले और स्क्रिप्ट किए गए प्लेबैक

इस सेक्शन में, वीडियो अपने-आप चलने की सुविधा के बारे में बताया गया है. यह नीति, YouTube पर एम्बेड किए गए उन प्लेयर पर लागू होती है जो autoplay प्लेयर पैरामीटर का इस्तेमाल करते हैं या YouTube IFrame 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	ज़रूरी है. वीडियो के ब्यौरे में. अगर वैल्यू 5,000 बाइट से ज़्यादा है, तो YouTube गड़बड़ी का मैसेज दिखाता है. YouTube पर, < और > को छोड़कर, UTF-8 के सभी मान्य वर्ण इस्तेमाल किए जा सकते हैं.
	status.privacyStatus	ज़रूरी है. वीडियो की निजता सेटिंग. उपयोगकर्ताओं को यह चुनने की सुविधा देनी होगी कि अपलोड किया गया वीडियो 'सार्वजनिक', 'निजी' या 'सबके लिए मौजूद नहीं' के तौर पर सेट किया जाए.
अनुरोध पैरामीटर
	onBehalfOfContentOwnerChannel	कुछ शर्तों के मुताबिक ज़रूरी है. अगर अनुरोध के अनुमति क्रेडेंशियल से कॉन्टेंट के मालिक की पहचान होती है और onBehalfOfContentOwner पैरामीटर सेट होता है, तो एपीआई उपयोगकर्ता को उस YouTube चैनल की जानकारी भी देनी होगी जिस पर वीडियो अपलोड किया जा रहा है.

टिप्पणियां दिखाना

	नाम	ब्यौरा
संसाधन प्रॉपर्टी
	snippet.textDisplay	ज़रूरी है. टिप्पणी का टेक्स्ट. एपीआई क्लाइंट को (a) किसी टिप्पणी या टिप्पणी के जवाब का पूरा टेक्स्ट दिखाना होगा या (b) टेक्स्ट को छोटा करना होगा और दर्शक को छोटा किया गया वर्शन से पूरा टेक्स्ट आसानी से ऐक्सेस करने का तरीका देना होगा. यह ज़रूरी शर्त सभी टिप्पणियों और टिप्पणियों के जवाबों पर लागू होती है. भले ही, टिप्पणियां किसी भी तरह के संसाधन (वीडियो, चैनल वगैरह) से जुड़ी हों. ध्यान दें कि commentThread संसाधन की snippet.topLevelComment प्रॉपर्टी वैल्यू एक comment संसाधन है और replies.comments[] प्रॉपर्टी, comment संसाधनों की सूची है. इसलिए, यह ज़रूरी शर्त 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 उपयोगकर्ता खाते की साफ़ तौर पर पहचान करनी चाहिए जिसका इस्तेमाल पाबंदी जोड़ने या हटाने के लिए किया जा रहा है.