Base Service

Base

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

الدروس

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

Blob

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
copyBlob()	Blob	تعرض هذه الدالة نسخة من كائن البيانات الثنائية الكبير.
getAs(contentType)	Blob	لعرض البيانات داخل هذا العنصر ككائن ثنائي كبير تم تحويله إلى نوع المحتوى المحدّد
getBytes()	Byte[]	تعرض هذه الطريقة البيانات المخزّنة في هذا الكائن الثنائي الكبير.
getContentType()	String|null	تعرض هذه السمة نوع المحتوى الخاص بالبايت في كائن التخزين الثنائي الكبير هذا.
getDataAsString()	String	تعرض هذه الطريقة بيانات الكائن الثنائي الكبير (blob) كسلسلة بترميز UTF-8.
getDataAsString(charset)	String	تعرض بيانات هذا الكائن الثنائي الكبير كسلسلة باستخدام الترميز المحدّد.
getName()	String|null	تعرض هذه السمة اسم الكائن الثنائي الكبير.
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

الخصائص

الموقع	النوع	الوصف
Buttons	ButtonSet

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
inputBox(prompt)	String|null	يؤدي إلى ظهور مربّع حوار يتضمّن مربّع إدخال نص في متصفّح المستخدم.
inputBox(prompt, buttons)	String|null	يؤدي إلى ظهور مربّع حوار يتضمّن مربّع إدخال نص في متصفّح المستخدم.
inputBox(title, prompt, buttons)	String|null	يؤدي إلى ظهور مربّع حوار يتضمّن مربّع إدخال نص في متصفّح المستخدم.
msgBox(prompt)	String|null	يؤدي إلى ظهور مربّع حوار يتضمّن الرسالة المحدّدة وزر "حسنًا" في متصفّح المستخدم.
msgBox(prompt, buttons)	String|null	يؤدي إلى ظهور مربّع حوار يتضمّن الرسالة المحدّدة والأزرار المحدّدة في متصفّح المستخدم.
msgBox(title, prompt, buttons)	String|null	يفتح مربّع حوار بالعنوان والرسالة والأزرار المحدّدة في متصفّح المستخدم.

Button

الخصائص

الموقع	النوع	الوصف
CLOSE	Enum	زر الإغلاق العادي المعروض في شريط عنوان كل مربّع حوار
OK	Enum	زر "حسنًا" يشير إلى ضرورة المتابعة في عملية ما
CANCEL	Enum	زر "إلغاء" يشير إلى أنّه يجب عدم المتابعة في عملية ما
YES	Enum	زر "نعم" يشير إلى ردّ إيجابي على سؤال
NO	Enum	زر "لا" يشير إلى ردّ سلبي على سؤال

ButtonSet

الخصائص

الموقع	النوع	الوصف
OK	Enum	زرّ "حسنًا" واحد يشير إلى رسالة معلوماتية لا يمكن إلا إغلاقها.
OK_CANCEL	Enum	زرّ "حسنًا" وزرّ "إلغاء"، ما يسمح للمستخدم إما بمتابعة عملية أو إيقافها.
YES_NO	Enum	زر "نعم" وزر "لا"، ما يسمح للمستخدم بالإجابة عن سؤال بنعم أو لا
YES_NO_CANCEL	Enum	زر "نعم" وزر "لا" وزر "إلغاء"، ما يتيح للمستخدم إما الإجابة عن سؤال بنعم أو لا أو إيقاف عملية.

ColorType

الخصائص

الموقع	النوع	الوصف
UNSUPPORTED	Enum	نوع لون غير متوافق
RGB	Enum	لون محدّد بقنوات الألوان الأحمر والأخضر والأزرق
THEME	Enum	لون يشير إلى إدخال في نظام ألوان المظهر

Logger

الطُرق

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

Menu

الطُرق

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

MimeType

الخصائص

الموقع	النوع	الوصف
GOOGLE_APPS_SCRIPT	Enum	تمثّل هذه السمة نوع MIME لمشروع برمجة تطبيقات Google.
GOOGLE_DRAWINGS	Enum	تمثيل لنوع MIME لملف "رسومات Google".
GOOGLE_DOCS	Enum	تمثيل لنوع MIME لملف "مستندات Google".
GOOGLE_FORMS	Enum	تمثيل لنوع MIME لملف "نماذج Google".
GOOGLE_SHEETS	Enum	تمثيل لنوع MIME لملف جداول بيانات Google
GOOGLE_SITES	Enum	تمثّل هذه السمة نوع MIME لملف في "مواقع Google".
GOOGLE_SLIDES	Enum	تمثيل لنوع MIME لملف "العروض التقديمية من Google".
FOLDER	Enum	تمثيل لنوع MIME لمجلد Google Drive
SHORTCUT	Enum	تمثّل هذه السمة نوع MIME لاختصار في Google Drive.
BMP	Enum	تمثيل لنوع MIME لملف صورة BMP (عادةً ‎ .bmp).
GIF	Enum	تمثّل هذه السمة نوع MIME لملف صورة GIF (عادةً ‎ .gif).
JPEG	Enum	تمثّل هذه السمة نوع MIME لملف صورة JPEG (عادةً ‎ .jpg).
PNG	Enum	تمثّل هذه السمة نوع MIME لملف صورة بتنسيق PNG (عادةً ‎ .png).
SVG	Enum	تمثّل نوع MIME لملف صورة SVG (عادةً ‎ .svg).
PDF	Enum	تمثيل لنوع MIME لملف PDF (عادةً ‎ .pdf).
CSS	Enum	تمثيل لنوع MIME لملف نصي CSS (عادةً ‎ .css).
CSV	Enum	تمثيل لنوع MIME لملف نصي بتنسيق CSV (عادةً ‎ .csv).
HTML	Enum	تمثيل لنوع MIME لملف نصي بتنسيق HTML (عادةً ‎ .html).
JAVASCRIPT	Enum	تمثيل لنوع MIME لملف نصي JavaScript (عادةً ‎ .js).
PLAIN_TEXT	Enum	تمثيل لنوع MIME لملف نص عادي (عادةً ‎ .txt).
RTF	Enum	تمثّل نوع MIME لملف نص منسّق (عادةً ‎ .rtf).
OPENDOCUMENT_GRAPHICS	Enum	تمثيل لنوع MIME لملف رسومات OpenDocument (عادةً ‎ .odg).
OPENDOCUMENT_PRESENTATION	Enum	تمثيل لنوع MIME لملف عرض تقديمي من OpenDocument (عادةً ‎ .odp).
OPENDOCUMENT_SPREADSHEET	Enum	تمثيل لنوع MIME لملف جدول بيانات OpenDocument (عادةً ‎ .ods).
OPENDOCUMENT_TEXT	Enum	تمثيل لنوع MIME لملف معالجة نصوص OpenDocument (عادةً ‎ .odt).
MICROSOFT_EXCEL	Enum	تمثيل لنوع MIME لملف جدول بيانات Microsoft Excel (عادةً ‎ .xlsx).
MICROSOFT_EXCEL_LEGACY	Enum	تمثيل لنوع MIME لملف Microsoft Excel قديم (عادةً ‎ .xls).
MICROSOFT_POWERPOINT	Enum	تمثّل هذه السمة نوع MIME لملف عرض تقديمي من Microsoft PowerPoint (عادةً ‎ .pptx).
MICROSOFT_POWERPOINT_LEGACY	Enum	تمثيل لنوع MIME لملف Microsoft PowerPoint قديم (عادةً ‎ .ppt).
MICROSOFT_WORD	Enum	تمثيل لنوع MIME لملف مستند Microsoft Word (عادةً ‎ .docx).
MICROSOFT_WORD_LEGACY	Enum	تمثيل لنوع MIME لملف Microsoft Word قديم (عادةً ‎ .doc).
ZIP	Enum	تمثيل لنوع MIME لملف أرشيف ZIP (عادةً ‎ .zip).

Month

الخصائص

الموقع	النوع	الوصف
JANUARY	Enum	يناير (الشهر 1)
FEBRUARY	Enum	شباط (فبراير) (الشهر 2)
MARCH	Enum	مارس (الشهر 3)
APRIL	Enum	أبريل (الشهر 4)
MAY	Enum	مايو (الشهر 5)
JUNE	Enum	يونيو (الشهر 6)
JULY	Enum	يوليو (الشهر 7)
AUGUST	Enum	أغسطس (الشهر 8)
SEPTEMBER	Enum	أيلول (سبتمبر) (الشهر 9)
OCTOBER	Enum	أكتوبر (الشهر 10)
NOVEMBER	Enum	تشرين الثاني (الشهر 11)
DECEMBER	Enum	ديسمبر (الشهر 12)

PromptResponse

الطُرق

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

RgbColor

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
asHexString()	String	تعرض هذه السمة اللون كسلسلة سداسية عشرية مؤلفة من 7 أحرف (#rrggbb) أو 9 أحرف (#aarrggbb) بتنسيق CSS.
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

الخصائص

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

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
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	يفتح مربّع حوار إدخال في محرّر المستخدم بالعنوان والرسالة ومجموعة الأزرار المحدّدة.
showModalDialog(userInterface, title)	void	يفتح مربّع حوار مشروطًا في محرِّر المستخدم يتضمّن محتوًى مخصّصًا من جهة العميل.
showModelessDialog(userInterface, title)	void	يفتح مربّع حوار غير مشروط في محرّر المستخدم يتضمّن محتوًى مخصّصًا من جهة العميل.
showSidebar(userInterface)	void	يفتح شريطًا جانبيًا في محرِّر المستخدم يتضمّن محتوًى مخصّصًا من جهة العميل.

User

الطُرق

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

Weekday

الخصائص

الموقع	النوع	الوصف
SUNDAY	Enum	الأحد
MONDAY	Enum	الاثنين
TUESDAY	Enum	الثلاثاء
WEDNESDAY	Enum	الأربعاء
THURSDAY	Enum	الخميس
FRIDAY	Enum	يوم الجمعة
SATURDAY	Enum	السبت

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	يُخرج رسالة فارغة بمستوى WARNING إلى Stackdriver Logging.
warn(formatOrObject, values)	void	يُخرج رسالة بمستوى WARNING إلى Stackdriver Logging.