इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

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

इस दस्तावेज़ में, एपीआई क्लाइंट के लिए ज़रूरी शर्तों के बारे में बताया गया है. ये शर्तें, 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 वैल्यू को छिपाया जाता है.

Referer सेट करना

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

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

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

इस कॉन्फ़िगरेशन में, प्लेयर को सीधे https://www.youtube.com/embed/VIDEO_ID से लोड किया जाता है. इसके लिए, किसी एचटीएमएल फ़ाइल की ज़रूरत नहीं होती. Referer को एचटीटीपी हेडर के तौर पर जोड़कर सेट किया जाता है:
- Android loadUrl, जिसमें additionalHttpHeaders पैरामीटर में Referer एचटीटीपी हेडर जोड़ा गया हो
- अनुरोध में जोड़े गए Referer एचटीटीपी हेडर के साथ iOS loadRequest:. उदाहरण के लिए:
```
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 की वैल्यू सेट करें. इसके लिए, उस WebView को कॉन्फ़िगर करें जिसमें प्लेयर लोड किया गया है. सटीक तरीका, प्लैटफ़ॉर्म के हिसाब से अलग-अलग हो सकता है.

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

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

WebView पैरामीटर सेट करके या एचटीटीपी हेडर जोड़कर, रेफ़रर की जानकारी साफ़ तौर पर देने पर, फ़ॉर्मैट आम तौर पर पूरी तरह से क्वालिफ़ाइड यूआरएल होता है. प्रोटोकॉल के तौर पर 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: store-hosted

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

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

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

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

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

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

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

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

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

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

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

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

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

YouTube Player के एट्रिब्यूट

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

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

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

माउसओवर

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

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

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

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

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

	नाम	ब्यौरा
संसाधन की प्रॉपर्टी
	`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 उपयोगकर्ता खाते की साफ़ तौर पर पहचान करनी होगी जिसका इस्तेमाल, पाबंदी लगाने या हटाने के लिए किया जा रहा है.