Class HtmlService

سرویس Html

سرویس برای برگرداندن HTML و سایر محتوای متنی از یک اسکریپت.

به دلیل ملاحظات امنیتی، اسکریپت ها نمی توانند مستقیماً محتوا را به مرورگر بازگردانند. در عوض، آنها باید HTML را پاکسازی کنند تا نتواند اقدامات مخرب انجام دهد. توضیح Html Output را ببینید که چه محدودیت هایی در مورد آنچه که می توان برگرداند وجود دارد.

خواص

اموال تایپ کنید توضیحات
Sandbox Mode Sandbox Mode فهرستی که حالت‌های جعبه ایمنی را نشان می‌دهد که می‌تواند برای اسکریپت‌های Html Service سمت سرویس گیرنده استفاده شود.
XFrameOptionsMode XFrameOptionsMode فهرستی که حالت‌های X-Frame-Options را نشان می‌دهد که می‌تواند برای اسکریپت‌های Html Service سمت سرویس گیرنده استفاده شود.

روش ها

روش نوع برگشت شرح مختصر
create Html Output() Html Output یک شیء Html Output جدید ایجاد می کند که می تواند از اسکریپت برگردانده شود.
create Html Output(blob) Html Output یک شیء Html Output جدید از یک منبع Blob Source ایجاد می کند.
create Html Output(html) Html Output یک شیء Html Output جدید ایجاد می کند که می تواند از اسکریپت برگردانده شود.
create Html Output From File(filename) Html Output یک شیء Html Output جدید از یک فایل در ویرایشگر کد ایجاد می کند.
create Template(blob) Html Template یک شیء Html Template جدید از یک منبع Blob Source ایجاد می کند.
create Template(html) Html Template یک شیء Html Template جدید ایجاد می کند که می تواند از اسکریپت برگردانده شود.
create Template From File(filename) Html Template یک شیء Html Template جدید از یک فایل در ویرایشگر کد ایجاد می کند.
get User Agent() String رشته user-agent را برای مرورگر فعلی دریافت می کند.

مستندات دقیق

create Html Output()

یک شیء Html Output جدید ایجاد می کند که می تواند از اسکریپت برگردانده شود. 

const output = HtmlService.createHtmlOutput();

بازگشت

Html Output - شیء جدید HtmlOutput

create Html Output(blob)

یک شیء Html Output جدید از یک منبع Blob Source ایجاد می کند. 

function createFromBlob(blob) {
  const output = HtmlService.createHtmlOutput(blob);
  return output;
}

پارامترها

نام تایپ کنید توضیحات
blob Blob Source شیئی که HTML از آن خارج می شود

بازگشت

Html Output - شیء Html Output جدید

پرتاب می کند

Error - اگر لکه حاوی HTML نباشد یا HTML بد شکل باشد

create Html Output(html)

یک شیء Html Output جدید ایجاد می کند که می تواند از اسکریپت برگردانده شود. 

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

پارامترها

نام تایپ کنید توضیحات
html String محتوای مورد نظر برای ارائه

بازگشت

Html Output - شیء جدید HtmlOutput

پرتاب می کند

Error - اگر html بد شکل باشد

create Html Output From File(filename)

یک شیء Html Output جدید از یک فایل در ویرایشگر کد ایجاد می کند. 

const output = HtmlService.createHtmlOutputFromFile('myPage');

پارامترها

نام تایپ کنید توضیحات
filename String نام فایل مورد استفاده

بازگشت

Html Output - شیء Html Output جدید

پرتاب می کند

Error - اگر فایل پیدا نشد یا HTML موجود در آن نادرست است

create Template(blob)

یک شیء Html Template جدید از یک منبع Blob Source ایجاد می کند. 

function createFromBlob(blob) {
  const template = HtmlService.createTemplate(blob);
  const output = template.evaluate();
  return output;
}

پارامترها

نام تایپ کنید توضیحات
blob Blob Source شیئی که HTML از آن خارج می شود.

بازگشت

Html Template - شیء Html Template جدید

پرتاب می کند

Error - اگر لکه حاوی HTML نباشد

create Template(html)

یک شیء Html Template جدید ایجاد می کند که می تواند از اسکریپت برگردانده شود. 

const template = HtmlService.createTemplate(
    '<b>The time is &lt;?= new Date() ?&gt;</b>',
);

پارامترها

نام تایپ کنید توضیحات
html String محتوای قالب

بازگشت

Html Template - شیء Html Template جدید

create Template From File(filename)

یک شیء Html Template جدید از یک فایل در ویرایشگر کد ایجاد می کند. 

const template = HtmlService.createTemplateFromFile('myTemplate');

پارامترها

نام تایپ کنید توضیحات
filename String نام فایل مورد استفاده

بازگشت

Html Template - شیء Html Template جدید

پرتاب می کند

Error - اگر فایل پیدا نشد

get User Agent()

رشته user-agent را برای مرورگر فعلی دریافت می کند. اگر در تابع do Get() یا do Post() یک برنامه وب استفاده نشود، برای اکثر اجرای اسکریپت ها null برمی گرداند.

بازگشت

String - رشته عامل کاربر