كائن Textإخراج يمكن عرضه من نص برمجي.
لأسباب تتعلق بالأمان، لا يمكن للنصوص البرمجية عرض محتوى نصي مباشرةً في المتصفح. وبدلاً من ذلك، تتم إعادة توجيه المتصفّح إلى googleusercontent.com، والذي سيعرضه بدون أي عملية تطهير أو تلاعب إضافية.
يمكنك عرض محتوى نصي كما يلي:
function doGet() { return ContentService.createTextOutput("hello world!"); }هناك أيضًا طرق لعرض JSON وRSS وXML كمخرجات نصية. يمكنك الاطّلاع على الطرق المقابلة لها على
ContentService
.الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
append(addedContent) | TextOutput | لإلحاق محتوى جديد بالمحتوى الذي سيتم عرضه |
clear() | TextOutput | يؤدي إلى محو المحتوى الحالي. |
downloadAsFile(filename) | TextOutput | يتم استخدام هذا الإعداد لإبلاغ المتصفّحات بتنزيل المحتوى بدلاً من تنزيله. |
getContent() | String | يحصل على المحتوى الذي سيتم عرضه. |
getFileName() | String | عرض اسم الملف لتنزيل هذا الملف بتنسيق ، أو تركه فارغًا إذا كان يجب عرضه بدلاً من تنزيله. |
getMimeType() | MimeType | حدِّد نوع بروتوكول MIME لهذا المحتوى. |
setContent(content) | TextOutput | ضبط المحتوى الذي سيتم عرضه. |
setMimeType(mimeType) | TextOutput | تتيح هذه السياسة ضبط نوع MIME للمحتوى الذي سيتم عرضه. |
المستندات التفصيلية
append(addedContent)
لإلحاق محتوى جديد بالمحتوى الذي سيتم عرضه
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
addedContent | String | المحتوى المراد إلحاقه |
تذكرة ذهاب وعودة
TextOutput
— هذا النص الناتج نفسه، مفيد للسلاسل
clear()
downloadAsFile(filename)
يتم استخدام هذا الإعداد لإبلاغ المتصفّحات بتنزيل المحتوى بدلاً من تنزيله.
ستتجاهل بعض المتصفحات هذا الإعداد. ويؤدي ضبطها على "فارغ" إلى محوها إلى السلوك التلقائي للعرض بدلاً من تنزيلها.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
filename | String | اسم الملف لإبلاغ المتصفّح باستخدامه |
تذكرة ذهاب وعودة
TextOutput
: كائن Textإخراج مفيد للسلاسل
طرح
Error
— إذا كان اسم الملف يحتوي على أحرف غير قانونية
getContent()
يحصل على المحتوى الذي سيتم عرضه.
تذكرة ذهاب وعودة
String
- المحتوى الذي سيتم عرضه
getFileName()
عرض اسم الملف لتنزيل هذا الملف بتنسيق ، أو تركه فارغًا إذا كان يجب عرضه بدلاً من تنزيله.
تذكرة ذهاب وعودة
String
— اسم الملف
getMimeType()
حدِّد نوع بروتوكول MIME لهذا المحتوى.
تذكرة ذهاب وعودة
MimeType
- نوع بروتوكول MIME الذي سيتم استخدامه مع
setContent(content)
ضبط المحتوى الذي سيتم عرضه.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
content | String | المحتوى المراد عرضه |
تذكرة ذهاب وعودة
TextOutput
— هذا النص الناتج نفسه، مفيد للسلاسل
setMimeType(mimeType)
تتيح هذه السياسة ضبط نوع MIME للمحتوى الذي سيتم عرضه. الإعداد التلقائي هو النص العادي.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
mimeType | MimeType | نوع MIME |
تذكرة ذهاب وعودة
TextOutput
— هذا النص الناتج نفسه، مفيد للسلاسل