Base Service

توفّر هذه الخدمة إمكانية الوصول إلى معلومات المستخدمين، مثل عناوين البريد الإلكتروني وأسماء المستخدمين. ويتحكّم أيضًا في سجلات النصوص البرمجية ومربّعات الحوار في تطبيقات 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.

Base Service تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الدروس

الطُرق

الطُرق

الخصائص

الطُرق

الخصائص

الخصائص

الخصائص

الطُرق

الطُرق

الخصائص

الخصائص

الطُرق

الطُرق

الطُرق

الخصائص

الطُرق

الطُرق

الخصائص

الطُرق

Base Service