Base Service

Base

توفّر هذه الخدمة إمكانية الوصول إلى معلومات المستخدمين، مثل عناوين البريد الإلكتروني وأسماء المستخدمين. وتتحكّم هذه الإعدادات أيضًا في سجلات النصوص البرمجية ومربّعات الحوار في تطبيقات Google Workspace.

صفوف

الاسموصف قصير
Blobعنصر تبادل البيانات لخدمات Apps Script
BlobSourceواجهة للكائنات التي يمكنها تصدير بياناتها كملف Blob
Browserتوفّر هذه الفئة إمكانية الوصول إلى مربّعات حوار خاصة بخدمة "جداول بيانات Google".
Buttonفهرس يمثّل أزرار مربّعات الحوار المترجَمة والمحدّدة مسبقًا التي يعرضها alert أو PromptResponse.getSelectedButton() للإشارة إلى الزر الذي نقر عليه المستخدم في مربّع الحوار
ButtonSetفهرس يمثّل مجموعات مُحدَّدة مسبقًا ومُترجَمة من زرّ واحد أو أكثر من أزرار مربّع الحوار يمكن إضافتها إلى alert أو prompt
ColorTypeأنواع الألوان
Loggerتسمح هذه الفئة للمطوّر بالكتابة في سجلّ التنفيذ وسجلّات Google Cloud إذا كان النص البرمجي مرتبطًا بمشروع عادي على Cloud.
Menuقائمة مخصّصة في مثيل لواجهة مستخدم تطبيق Google
MimeTypeقائمة توفّر إمكانية الوصول إلى بيانات نوع MIME بدون كتابة السلاسل بشكل صريح.
Monthمصنّف يمثّل أشهر السنة
PromptResponseاستجابة لمربّع حوار prompt معروض في بيئة واجهة المستخدم لتطبيق Google
RgbColorلون محدّد من خلال قنوات اللون الأحمر والأخضر والأزرق
Sessionتوفّر فئة Session إمكانية الوصول إلى معلومات الجلسة، مثل عنوان البريد الإلكتروني للمستخدم (في بعض الحالات) وإعدادات اللغة.
Uiمثيل لواجهة مستخدم تطبيق Google يسمح للنص البرمجي بإضافة ميزات مثل القوائم ومربّعات الحوار والأشرطة الجانبية.
Userتمثيل مستخدم، مناسب للبرمجة
Weekdayمصنّف يمثّل أيام الأسبوع
consoleتسمح هذه الفئة للمطوّر بالكتابة في سجلّ التنفيذ وسجلّات Google Cloud إذا كان النص البرمجي مرتبطًا بمشروع عادي على Cloud.

Blob

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
copyBlob()Blobعرض نسخة من هذا العنصر
getAs(contentType)Blobعرض البيانات داخل هذا العنصر كبيانات ثنائية كبيرة تم تحويلها إلى نوع المحتوى المحدّد
getBytes()Byte[]تحصل على البيانات المخزّنة في هذا المربّع.
getContentType()Stringتحصل على نوع محتوى البايتات في ملف تخزين البيانات الثنائية الكبير هذا.
getDataAsString()Stringتحصل على بيانات هذا العنصر المصغّر كسلسلة بترميز UTF-8.
getDataAsString(charset)Stringتحصل على بيانات هذا المربّع المصغّر كسلسلة باستخدام ترميز محدّد.
getName()Stringتحصل على اسم هذا المربّع.
isGoogleType()Booleanتُعرِض ما إذا كان هذا المخطّط البياني ملفًا على Google Workspace ("جداول بيانات Google" أو "مستندات Google" أو غير ذلك).
setBytes(data)Blobتُستخدَم لضبط البيانات المخزّنة في هذه الكتلة.
setContentType(contentType)Blobلضبط نوع محتوى البايتات في ملف تخزين البيانات الثنائية الكبير هذا.
setContentTypeFromExtension()Blobلضبط نوع محتوى البايتات في هذه الكتلة، استنادًا إلى امتداد الملف
setDataFromString(string)Blobتُستخدَم لضبط بيانات هذا العنصر من سلسلة بترميز UTF-8.
setDataFromString(string, charset)Blobتُستخدَم هذه الدالة لضبط بيانات هذا العنصر من سلسلة باستخدام ترميز محدّد.
setName(name)Blobتُستخدَم لضبط اسم هذا المربّع.

BlobSource

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
getAs(contentType)Blobعرض البيانات داخل هذا العنصر كبيانات ثنائية كبيرة تم تحويلها إلى نوع المحتوى المحدّد
getBlob()Blobعرض البيانات داخل هذا الكائن ككتلة بيانات

Browser

أماكن إقامة

الموقعالنوعالوصف
ButtonsButtonSet

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
inputBox(prompt)Stringتنشئ نافذة منبثقة مربّع إدخال نص في متصفّح المستخدم.
inputBox(prompt, buttons)Stringتنشئ نافذة منبثقة مربّع إدخال نص في متصفّح المستخدم.
inputBox(title, prompt, buttons)Stringتنشئ نافذة منبثقة مربّع إدخال نص في متصفّح المستخدم.
msgBox(prompt)Stringيطفو مربع حوار يتضمّن الرسالة المحدّدة وزر "حسنًا" في متصفّح المستخدم.
msgBox(prompt, buttons)Stringتعرِض هذه السمة مربّع حوار يتضمّن الرسالة المحدّدة والأزرار المحدّدة في متصفّح المستخدم.
msgBox(title, prompt, buttons)Stringتعرِض هذه السمة مربّع حوار يتضمّن العنوان والرسالة والأزرار المحدّدة في متصفّح المستخدم.

Button

أماكن إقامة

الموقعالنوعالوصف
CLOSEEnumزر الإغلاق العادي المعروض في شريط عنوان كل مربّع حوار
OKEnumزر "حسنًا" يشير إلى أنّه يجب مواصلة تنفيذ العملية
CANCELEnumزر "إلغاء" يشير إلى أنّه يجب عدم مواصلة العملية
YESEnumزر "نعم"، يشير إلى إجابة إيجابية عن سؤال
NOEnumزر "لا" للإشارة إلى ردّ سلبي على سؤال

ButtonSet

أماكن إقامة

الموقعالنوعالوصف
OKEnumزر "حسنًا" واحد يشير إلى رسالة معلوماتية لا يمكن إغلاقها إلا من خلال هذا الزر
OK_CANCELEnumزر "حسنًا" وزر "إلغاء"، للسماح للمستخدم بمواصلة عملية أو إيقافها
YES_NOEnumزر "نعم" وزر "لا"، للسماح للمستخدم بالإجابة عن سؤال بنعم/لا
YES_NO_CANCELEnumزر "نعم" وزر "لا" وزر "إلغاء"، للسماح للمستخدم بالإجابة عن سؤال "نعم/لا" أو إيقاف عملية

ColorType

أماكن إقامة

الموقعالنوعالوصف
UNSUPPORTEDEnumنوع لون غير متوافق
RGBEnumلون محدّد من خلال قنوات الألوان الأحمر والأخضر والأزرق
THEMEEnumلون يشير إلى إدخال في نظام ألوان التصميم

Logger

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
clear()voidيمحو السجلّ.
getLog()Stringتعرِض هذه الدالة قائمة كاملة بالرسائل في السجلّ الحالي.
log(data)Loggerكتابة البيانات في السجلّ
log(format, values)Loggerيُستخدَم لكتابة سلسلة منسَّقة في وحدة تحكّم التسجيل، باستخدام التنسيق والقيم المقدَّمة.

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addItem(caption, functionName)Menuتُضيف عنصرًا إلى القائمة.
addSeparator()Menuتضيف فاصلًا مرئيًا إلى القائمة.
addSubMenu(menu)Menuتُضيف قائمة فرعية إلى القائمة.
addToUi()voidتُدرج القائمة في مثيل واجهة مستخدِم المحرِّر.

MimeType

أماكن إقامة

الموقعالنوعالوصف
GOOGLE_APPS_SCRIPTEnumتمثيل لنوع MIME لمشروع Google Apps Script
GOOGLE_DRAWINGSEnumتمثيل لنوع MIME لملف "رسومات Google"
GOOGLE_DOCSEnumتمثيل لنوع MIME لملف "مستندات Google"
GOOGLE_FORMSEnumتمثيل لنوع MIME لملف "نماذج Google"
GOOGLE_SHEETSEnumتمثيل لنوع MIME لملف "جداول بيانات Google"
GOOGLE_SITESEnumتمثيل لنوع MIME لملف على "مواقع Google"
GOOGLE_SLIDESEnumتمثيل لنوع MIME لملف "العروض التقديمية من Google"
FOLDEREnumتمثيل لنوع MIME لمجلد Google Drive
SHORTCUTEnumتمثيل لنوع MIME لاختصار Google Drive
BMPEnumتمثيل لنوع MIME لملف صورة BMP (عادةً ‎.bmp)
GIFEnumتمثيل لنوع MIME لملف صورة GIF (عادةً ‎.gif)
JPEGEnumتمثيل لنوع MIME لملف صورة JPEG (عادةً ‎.jpg)
PNGEnumتمثيل لنوع MIME لملف صورة بتنسيق PNG (عادةً ‎.png)
SVGEnumتمثيل لنوع MIME لملف صورة SVG (عادةً svg.).
PDFEnumتمثيل لنوع MIME لملف PDF (عادةً ‎.pdf)
CSSEnumتمثيل لنوع MIME لملف نصي بتنسيق CSS (عادةً ‎.css)
CSVEnumتمثيل لنوع MIME لملف نصي بتنسيق CSV (عادةً ‎.csv)
HTMLEnumتمثيل نوع MIME لملف نصي بتنسيق HTML (عادةً html.).
JAVASCRIPTEnumتمثيل لنوع MIME لملف نصي بتنسيق JavaScript (عادةً js.).
PLAIN_TEXTEnumتمثيل لنوع MIME لملف نص عادي (عادةً ‎.txt)
RTFEnumتمثيل لنوع MIME لملف نص غني (عادةً ‎.rtf)
OPENDOCUMENT_GRAPHICSEnumتمثيل لنوع MIME لملف رسومات OpenDocument (عادةً ‎.odg)
OPENDOCUMENT_PRESENTATIONEnumتمثيل لنوع MIME لملف عرض OpenDocument (عادةً ‎.odp)
OPENDOCUMENT_SPREADSHEETEnumتمثيل لنوع MIME لملف جدول بيانات OpenDocument (عادةً ‎.ods)
OPENDOCUMENT_TEXTEnumتمثيل لنوع MIME لملف معالجة النصوص OpenDocument (عادةً ‎.odt)
MICROSOFT_EXCELEnumتمثيل لنوع MIME لملف جدول بيانات Microsoft Excel (عادةً ‎.xlsx)
MICROSOFT_EXCEL_LEGACYEnumتمثيل لنوع MIME لملف قديم من Microsoft Excel (عادةً ‎.xls)
MICROSOFT_POWERPOINTEnumتمثيل لنوع MIME لملف عرض تقديمي من Microsoft PowerPoint (عادةً ‎.pptx)
MICROSOFT_POWERPOINT_LEGACYEnumتمثيل لنوع MIME لملف قديم من Microsoft PowerPoint (عادةً ‎ .ppt).
MICROSOFT_WORDEnumتمثيل لنوع MIME لملف مستند Microsoft Word (عادةً ‎.docx)
MICROSOFT_WORD_LEGACYEnumتمثيل لنوع MIME لملف قديم من Microsoft Word (عادةً ‎.doc)
ZIPEnumتمثيل لنوع MIME لملف أرشيف ZIP (عادةً ‎.zip)

Month

أماكن إقامة

الموقعالنوعالوصف
JANUARYEnumكانون الثاني (يناير) (الشهر 1)
FEBRUARYEnumشباط (فبراير) (الشهر 2).
MARCHEnumآذار (الشهر 3).
APRILEnumنيسان (أبريل) (الشهر 4).
MAYEnumأيار (الشهر 5).
JUNEEnumحزيران (يونيو) (الشهر 6).
JULYEnumتموز (يوليو) (الشهر 7)
AUGUSTEnumآب (أغسطس) (الشهر 8)
SEPTEMBEREnumأيلول (سبتمبر) (الشهر 9)
OCTOBEREnumتشرين الأول (أكتوبر) (الشهر 10).
NOVEMBEREnumتشرين الثاني (نوفمبر) (الشهر 11).
DECEMBEREnumكانون الأول (ديسمبر) (الشهر 12).

PromptResponse

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
getResponseText()Stringتحصل على النص الذي أدخله المستخدم في حقل الإدخال في مربّع الحوار.
getSelectedButton()Buttonتحصل على الزر الذي نقر عليه المستخدم لإغلاق مربّع الحوار.

RgbColor

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
asHexString()Stringتُعرِض هذه الدالة اللون على شكل سلسلة سداسية عشرية من 7 أحرف بتنسيق CSS‏ (#rrggbb) أو سلسلة سداسية عشرية من 9 أحرف (#aarrggbb).
getBlue()Integerقناة اللون الأزرق لهذا اللون، كعدد من 0 إلى 255
getColorType()ColorTypeالحصول على نوع هذا اللون
getGreen()Integerالقناة الخضراء لهذا اللون، بالتنسيق الرقمي من 0 إلى 255
getRed()Integerقناة اللون الأحمر لهذا اللون، كعدد من 0 إلى 255

Session

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
getActiveUser()Userللحصول على معلومات عن المستخدم الحالي
getActiveUserLocale()Stringتحصل على إعدادات اللغة للمستخدم الحالي كسلسلة، على سبيل المثال، en للغة الإنجليزية.
getEffectiveUser()Userتحصل على معلومات عن المستخدم الذي يتم تشغيل النص البرمجي بموجب سلطته.
getScriptTimeZone()Stringتحصل على المنطقة الزمنية للنص البرمجي.
getTemporaryActiveUserKey()Stringالحصول على مفتاح مؤقت فريد للمستخدم النشط ولكن لا يكشف هوية المستخدم

Ui

أماكن إقامة

الموقعالنوعالوصف
ButtonButtonفهرس يمثّل أزرار مربّعات الحوار المترجَمة والمحدّدة مسبقًا التي يعرضها التنبيه أو PromptResponse.getSelectedButton() للإشارة إلى الزر الذي نقر عليه المستخدم في مربّع الحوار
ButtonSetButtonSetفهرس يمثّل مجموعات مُحدَّدة مسبقًا ومُترجَمة من زرّ واحد أو أكثر من أزرار مربّع الحوار يمكن إضافتها إلى تنبيه أو طلب

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
alert(prompt)Buttonيفتح مربّع حوار في محرِّر المستخدم يتضمّن الرسالة المحدّدة وزر "حسنًا".
alert(prompt, buttons)Buttonيفتح مربّع حوار في محرِّر المستخدم يتضمّن الرسالة المحدّدة ومجموعة الأزرار.
alert(title, prompt, buttons)Buttonيفتح مربّع حوار في محرِّر المستخدم يتضمّن العنوان والرسالة ومجموعة الأزرار المحدّدة.
createAddonMenu()Menuتُنشئ هذه الميزة أداة إنشاء يمكن استخدامها لإدراج قائمة فرعية في قائمة "الإضافات" في المحرّر.
createMenu(caption)Menuتُنشئ أداة إنشاء يمكن استخدامها لإضافة قائمة إلى واجهة مستخدم المحرِّر.
prompt(prompt)PromptResponseيفتح مربّع حوار إدخال في محرِّر المستخدم يتضمّن الرسالة المحدّدة وزر "حسنًا".
prompt(prompt, buttons)PromptResponseيفتح مربّع حوار إدخال في محرِّر المستخدم يتضمّن الرسالة المحدّدة ومجموعة من الأزرار.
prompt(title, prompt, buttons)PromptResponseيفتح مربّع حوار إدخال في محرِّر المستخدم يتضمّن العنوان والرسالة ومجموعة buttons.
showModalDialog(userInterface, title)voidيفتح مربّع حوار مشروطًا في محرِّر المستخدم يتضمّن محتوى مخصّصًا من جهة العميل.
showModelessDialog(userInterface, title)voidيفتح مربّع حوار بدون وضع في محرِّر المستخدم يحتوي على محتوى مخصّص من جهة العميل.
showSidebar(userInterface)voidيؤدي هذا الإجراء إلى فتح شريط جانبي في محرِّر المستخدم يتضمّن محتوى مخصّصًا من جهة العميل.

User

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
getEmail()Stringتحصل على عنوان البريد الإلكتروني للمستخدم، إن توفّر.

Weekday

أماكن إقامة

الموقعالنوعالوصف
SUNDAYEnumالأحد.
MONDAYEnumالاثنين.
TUESDAYEnumيوم الثلاثاء.
WEDNESDAYEnumالأربعاء.
THURSDAYEnumالخميس.
FRIDAYEnumالجمعة.
SATURDAYEnumالسبت.

console

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
error()voidإخراج رسالة فارغة على مستوى ERROR إلى Stackdriver Logging
error(formatOrObject, values)voidإخراج رسالة على مستوى ERROR إلى Stackdriver Logging
info()voidإخراج رسالة فارغة من مستوى INFO إلى Stackdriver Logging
info(formatOrObject, values)voidإخراج رسالة بمستوى INFO إلى Stackdriver Logging
log()voidإخراج رسالة فارغة على مستوى DEBUG إلى Stackdriver Logging
log(formatOrObject, values)voidإخراج رسالة بمستوى DEBUG إلى Stackdriver Logging
time(label)voidيبدأ موقّتًا يمكنك استخدامه لتتبُّع المدة التي تستغرقها إحدى العمليات.
timeEnd(label)voidيوقف الموقّت الذي سبق أن تم تشغيله من خلال طلب console.time().
warn()voidإخراج رسالة فارغة من مستوى التحذير إلى Stackdriver Logging
warn(formatOrObject, values)voidإخراج رسالة بمستوى تحذير إلى Stackdriver Logging