توفّر هذه الخدمة إمكانية الوصول إلى معلومات المستخدمين، مثل عناوين البريد الإلكتروني وأسماء المستخدمين. وتتحكّم هذه الإعدادات أيضًا في سجلات النصوص البرمجية ومربّعات الحوار في تطبيقات 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
أماكن إقامة
الموقع | النوع | الوصف |
---|---|---|
Buttons | ButtonSet |
الطُرق
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
---|---|---|
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
أماكن إقامة
الموقع | النوع | الوصف |
---|---|---|
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 Apps Script |
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 أحرف بتنسيق 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
أماكن إقامة
الموقع | النوع | الوصف |
---|---|---|
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 | يفتح مربّع حوار إدخال في محرِّر المستخدم يتضمّن العنوان والرسالة ومجموعة buttons. |
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 | إخراج رسالة فارغة من مستوى التحذير إلى Stackdriver Logging |
warn(formatOrObject, values) | void | إخراج رسالة بمستوى تحذير إلى Stackdriver Logging |