Class HtmlOutput

पेज में मेटा टैग जोड़ता है. Apps Script की एचटीएमएल फ़ाइल में सीधे तौर पर शामिल किए गए मेटा टैग को ignored कर दिया जाता है. सिर्फ़ इन मेटा टैग का इस्तेमाल किया जा सकता है:

<meta name="apple-mobile-web-app-capable" content="..."/>
<meta name="google-site-verification" content="..."/>
<meta name="mobile-web-app-capable" content="..."/>
<meta name="viewport" content="..."/>

const output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.addMetaTag('viewport', 'width=device-width, initial-scale=1');

पैरामीटर

वापसी का टिकट

HtmlOutput — चेन बनाने के लिए यह आउटपुट.

इस HtmlOutput के कॉन्टेंट में नया कॉन्टेंट जोड़ता है. इसका इस्तेमाल सिर्फ़ भरोसेमंद सोर्स से लिए गए कॉन्टेंट के लिए करें, क्योंकि यह एस्केप नहीं होता.

// Log "<b>Hello, world!</b><p>Hello again, world.</p>"
const output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.append('<p>Hello again, world.</p>');
Logger.log(output.getContent());

पैरामीटर

वापसी का टिकट

HtmlOutput — चेन बनाने के लिए यह आउटपुट.

थ्रो

Error — अगर एचटीएमएल गलत तरीके से बनाया गया है

इन्हें भी देखें

• appendUntrusted(addedContent)

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

यह तरीका, HtmlOutput की मौजूदा स्थिति के आधार पर कॉन्टेंट को सही तरीके से एस्केप करता है, ताकि नतीजा एक सुरक्षित स्ट्रिंग के तौर पर दिखे. इसमें कोई मार्कअप या साइड इफ़ेक्ट नहीं होता. जब भी किसी अविश्वसनीय सोर्स से कॉन्टेंट जोड़ें, तो append के बजाय इसका इस्तेमाल करें. जैसे, किसी उपयोगकर्ता से कॉन्टेंट जोड़ना. इससे, क्रॉस-साइट स्क्रिप्टिंग (XSS) बग को गलती से अनुमति देने से बचा जा सकता है. इस बग की वजह से, जोड़ा गया कॉन्टेंट या मार्कअप, अनचाहे कोड को लागू कर देता है.

// Log "<b>Hello, world!</b>&lt;p&gt;Hello again, world.&lt;/p&gt;"
const output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.appendUntrusted('<p>Hello again, world.</p>');
Logger.log(output.getContent());

पैरामीटर

वापसी का टिकट

HtmlOutput — चेन बनाने के लिए यह आउटपुट.

थ्रो

Error — अगर एचटीएमएल बहुत गलत तरीके से बनाया गया है

इन्हें भी देखें

• append(addedContent)

इस HtmlOutput से जुड़ा HtmlTemplate दिखाता है. इस तरीके का इस्तेमाल करके, टेंप्लेट को धीरे-धीरे बनाया जा सकता है. HtmlOutput में होने वाले बदलावों का असर, HtmlTemplate के कॉन्टेंट पर भी पड़ता है.

const output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
const template = output.asTemplate();

वापसी का टिकट

HtmlTemplate — नया HtmlTemplate.

मौजूदा कॉन्टेंट मिटाता है.

const output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.clear();

वापसी का टिकट

HtmlOutput — चेन बनाने के लिए यह आउटपुट.

इस ऑब्जेक्ट में मौजूद डेटा को, तय किए गए कॉन्टेंट टाइप में बदले गए ब्लॉब के तौर पर दिखाता है. इस तरीके से, फ़ाइल के नाम में सही एक्सटेंशन जुड़ जाता है. जैसे, "myfile.pdf". हालांकि, यह माना जाता है कि फ़ाइल के नाम के आखिरी पीरियड (अगर कोई है) के बाद का हिस्सा, मौजूदा एक्सटेंशन है और इसे बदला जाना चाहिए. इसलिए, "ShoppingList.12.25.2014", "ShoppingList.12.25.pdf" हो जाता है.

कन्वर्ज़न के लिए हर दिन के कोटे देखने के लिए, Google की सेवाओं के लिए कोटे देखें. नए बनाए गए Google Workspace डोमेन पर, कुछ समय के लिए ज़्यादा कड़े कोटे लागू हो सकते हैं.

पैरामीटर

वापसी का टिकट

Blob — डेटा को ब्लॉब के तौर पर दिखाया गया है.

इस ऑब्जेक्ट में मौजूद डेटा को ब्लॉब के तौर पर दिखाएं.

वापसी का टिकट

Blob — डेटा को ब्लॉब के तौर पर दिखाया गया है.

इस HtmlOutput का कॉन्टेंट पाता है.

// Log "<b>Hello, world!</b>"
const output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
Logger.log(output.getContent());

वापसी का टिकट

String — दिखाया जाने वाला कॉन्टेंट.

setFaviconUrl(iconUrl) को कॉल करके, पेज पर जोड़े गए फ़ेविकॉन लिंक टैग का यूआरएल पाता है. Apps Script की एचटीएमएल फ़ाइल में सीधे तौर पर शामिल किए गए फ़ेविकॉन लिंक टैग को,

const output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setFaviconUrl('http://www.example.com/image.png');
Logger.log(output.getFaviconUrl());

वापसी का टिकट

String — फ़ेविकॉन इमेज का यूआरएल.

Google Docs, Sheets या Forms में कस्टम डायलॉग बॉक्स की शुरुआती ऊंचाई दिखाता है. अगर HtmlOutput को वेब ऐप्लिकेशन के तौर पर पब्लिश किया जाता है, तो यह तरीका null दिखाता है. पहले से खुले डायलॉग का साइज़ बदलने के लिए, क्लाइंट-साइड कोड में google.script.host.setHeight(height) को कॉल करें.

const output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setHeight(200);
Logger.log(output.getHeight());

वापसी का टिकट

Integer — ऊंचाई, पिक्सल में.

addMetaTag(name, content) को कॉल करके, पेज पर जोड़े गए मेटा टैग दिखाने वाले ऑब्जेक्ट का कलेक्शन पाता है. Apps Script की एचटीएमएल फ़ाइल में सीधे तौर पर शामिल किए गए मेटा टैग को ignored कर दिया जाता है.

const output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.addMetaTag('viewport', 'width=device-width, initial-scale=1');

const tags = output.getMetaTags();
Logger.log(
    '<meta name="%s" content="%s"/>',
    tags[0].getName(),
    tags[0].getContent(),
);

वापसी का टिकट

HtmlOutputMetaTag[] — ऑब्जेक्ट की कैटगरी, जो addMetaTag(name, content) को कॉल करके पेज पर जोड़े गए मेटा टैग दिखाती है.

आउटपुट पेज का टाइटल दिखाता है. ध्यान दें कि <title> एचटीएमएल एलिमेंट को अनदेखा किया जाता है.

const output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
Logger.log(output.getTitle());

वापसी का टिकट

String — पेज का टाइटल.

Google Docs, Sheets या Forms में कस्टम डायलॉग बॉक्स की शुरुआती चौड़ाई दिखाता है. अगर HtmlOutput को वेब ऐप्लिकेशन के तौर पर पब्लिश किया जाता है, तो यह तरीका null दिखाता है. पहले से खुले डायलॉग का साइज़ बदलने के लिए, क्लाइंट-साइड कोड में google.script.host.setWidth(width) को कॉल करें.

const output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setWidth(200);
Logger.log(output.getWidth());

वापसी का टिकट

Integer — चौड़ाई, पिक्सल में.

इस HtmlOutput का कॉन्टेंट सेट करता है.

const output = HtmlService.createHtmlOutput();
output.setContent('<b>Hello, world!</b>');

पैरामीटर

वापसी का टिकट

HtmlOutput — चेन बनाने के लिए यह आउटपुट.

थ्रो

Error — अगर एचटीएमएल गलत तरीके से बनाया गया है

पेज पर फ़ैविकॉन के लिए लिंक टैग जोड़ता है. Apps Script की एचटीएमएल फ़ाइल में सीधे तौर पर शामिल किए गए फ़ाविकॉन लिंक टैग को अनदेखा किया जाता है.

const output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setFaviconUrl('http://www.example.com/image.png');

पैरामीटर

वापसी का टिकट

HtmlOutput — चेन बनाने के लिए यह आउटपुट.

Google Docs, Sheets या Forms में कस्टम डायलॉग बॉक्स की शुरुआती ऊंचाई सेट करता है. अगर HtmlOutput को वेब ऐप्लिकेशन के तौर पर पब्लिश किया जाता है, तो इस तरीके का कोई असर नहीं पड़ेगा. पहले से खुले डायलॉग का साइज़ बदलने के लिए, क्लाइंट-साइड कोड में google.script.host.setHeight(height) को कॉल करें.

const output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setHeight(200);

पैरामीटर

वापसी का टिकट

HtmlOutput — चेन बनाने के लिए यह आउटपुट.

इस तरीके का अब कोई असर नहीं पड़ता — पहले यह क्लाइंट-साइड स्क्रिप्ट के लिए इस्तेमाल किया जाने वाला sandbox mode सेट करता था. उपयोगकर्ताओं को नुकसान पहुंचाने वाले एचटीएमएल या JavaScript कोड से बचाने के लिए, एचटीएमएल सेवा से दिखाया जाने वाला क्लाइंट-साइड कोड, सुरक्षा सैंडबॉक्स में चलता है. यह सैंडबॉक्स, कोड पर पाबंदियां लगाता है. मूल रूप से, इस तरीके से स्क्रिप्ट बनाने वाले लोगों को सैंडबॉक्स के अलग-अलग वर्शन में से किसी एक को चुनने की अनुमति मिलती थी. हालांकि, अब सभी स्क्रिप्ट IFRAME मोड का इस्तेमाल करती हैं. भले ही, सैंडबॉक्स का कोई भी मोड सेट किया गया हो. ज़्यादा जानकारी के लिए, एचटीएमएल सेवा में पाबंदियों के बारे में गाइड देखें.

IFRAME मोड, सैंडबॉक्स के अन्य मोड के मुकाबले बहुत कम पाबंदियां लगाता है और सबसे तेज़ी से काम करता है. हालांकि, यह कुछ पुराने ब्राउज़र में काम नहीं करता. जैसे, Internet Explorer 9. google.script.sandbox.mode की जांच करके, क्लाइंट-साइड स्क्रिप्ट में सैंडबॉक्स मोड को पढ़ा जा सकता है. ध्यान दें कि यह प्रॉपर्टी, क्लाइंट पर मौजूद असल मोड दिखाती है. अगर अनुरोध किया गया मोड, उपयोगकर्ता के ब्राउज़र पर काम नहीं करता है, तो यह सर्वर पर अनुरोध किए गए मोड से अलग हो सकता है.

<!-- Read the sandbox mode (in a client-side script). -->
<script>
  alert(google.script.sandbox.mode);
</script>

पैरामीटर

वापसी का टिकट

HtmlOutput — चेन बनाने के लिए यह आउटपुट.

आउटपुट पेज का टाइटल सेट करता है. वेब ऐप्लिकेशन के लिए, यह पूरे पेज का टाइटल होता है. वहीं, Google Sheets में दिखाए गए HtmlOutput के लिए, यह डायलॉग का टाइटल होता है.

const output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setTitle('My First Page');

पैरामीटर

वापसी का टिकट

HtmlOutput — चेन बनाने के लिए यह आउटपुट.

Google Docs, Sheets या Forms में, कस्टम डायलॉग बॉक्स की शुरुआती चौड़ाई सेट करता है. अगर HtmlOutput को वेब ऐप्लिकेशन के तौर पर पब्लिश किया जाता है, तो इस तरीके का कोई असर नहीं पड़ेगा. पहले से खुले डायलॉग का साइज़ बदलने के लिए, क्लाइंट-साइड कोड में google.script.host.setWidth(width) को कॉल करें.

const output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setWidth(200);

पैरामीटर

वापसी का टिकट

HtmlOutput — चेन बनाने के लिए यह आउटपुट.

पेज के X-Frame-Options हेडर की स्थिति सेट करता है. इससे क्लिक जैकिंग को रोकने की सुविधा को कंट्रोल किया जाता है.

XFrameOptionsMode.ALLOWALL सेट करने पर, किसी भी साइट को पेज को iframe करने की अनुमति मिलती है. इसलिए, डेवलपर को क्लिक जैकिंग से बचाने के लिए, अपनी सुरक्षा लागू करनी चाहिए.

अगर कोई स्क्रिप्ट X-Frame-Options मोड सेट नहीं करती है, तो Apps Script डिफ़ॉल्ट रूप से XFrameOptionsMode.DEFAULT मोड का इस्तेमाल करता है.

// Serve HTML with no X-Frame-Options header (in Apps Script server-side code).
const output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setXFrameOptionsMode(HtmlService.XFrameOptionsMode.ALLOWALL);

पैरामीटर

वापसी का टिकट

HtmlOutput — चेन बनाने के लिए यह आउटपुट.