إذا كنت تستخدم خدمات Google مثل محرر مستندات ^{(Google Docs)}Google وجداول بيانات^{(Google Sheets)} Google و Google Analytics و Gmail وغيرها ، فيمكنك توصيل هذه الخدمات وتشغيلها تلقائيًا باستخدام Google Apps Script . 

فكر في Google Apps Script مثل إصدار Google من برنامج Microsoft VBA النصي^{(Microsoft’s VBA script)} . تمامًا كما يمكنك أتمتة الإجراءات والمهام أو تخصيص وحدات الماكرو في Microsoft Word و Excel باستخدام VBA^{(Excel with VBA)} ، يمكنك أتمتة المهام والإجراءات عبر خدمات Google . في خدمات مثل جداول البيانات والمستندات^(Docs) ، يمكنك حتى كتابة القوائم المخصصة الخاصة بك.

ستتعلم في هذه المقالة كيفية الوصول إلى Apps Script وتمكينها في خدمات Google المتنوعة^{(various Google services)} ، وكيفية التنقل في Apps Script Editor ، وكيفية توصيل الخدمات. لن تتعلم وظائف نصية محددة^{(learn specific script functions)} ، لكن لدى Google وثائق وتعليمات نصية للتطبيقات ممتازة متاحة لتعلم كيفية كتابة Apps Script .

كيفية الوصول إلى محرر البرامج النصية لتطبيقات Google^{(Access Google Apps Script Editor)}

يمكنك فتح محرر التعليمات البرمجية لـ Google Apps Script من داخل عدد من خدمات Google . على سبيل المثال ، ستجد Apps Script في قائمة الإضافات^(Extensions) داخل جداول بيانات Google.

في الخدمات الأخرى ، يمكنك فتح محرر برمجة تطبيقات Google^{(Google Apps Script)} بالطرق التالية:

• مُحرر مستندات Google^{(Google Docs)} : حدد محرر النص^{(Script editor)} في قائمة الأدوات^(Tools) .
• العروض التقديمية من Google^{(Google Slides)} : حدد محرر النص^{(Script editor)} في قائمة الأدوات^(Tools) .
• نماذج Google^{(Google Forms)} : حدد محرر البرنامج النصي^{(Script editor)} في قائمة النقاط الثلاث.
• Google Drive : انقر بزر الماوس الأيمن فوق أي مساحة فارغة ، وحدد المزيد^(More) ، وحدد Google Apps Script .

باستخدام أي من هذه الطرق ، سترى محرر رمز Apps Script مفتوحًا في علامة تبويب جديدة. ^{(Apps Script)}هذه هي النافذة حيث ستكتب كل وظيفة من الوظائف التي يتألف منها النص بأكمله. بشكل افتراضي ، سترى وظيفة فارغة تسمى myFunction () جاهزة لبدء ملء التعليمات البرمجية الخاصة بك.

ملاحظة^(Note) : تنسيق الكود مهم جدًا لتجنب الأخطاء. استخدم التعليق كما هو موضح في الكود التالي لتذكير نفسك بما كنت تحاول القيام به داخل أقسام الكود. هذا مشابه جدًا لكيفية عمل التعليقات في كود HTML مع برمجة الويب.

أثناء التنقل في محرر الكود ، يمكنك العودة إلى هذا القسم بتحديد Code.gs في جزء التنقل الأيسر في نافذة المحرر . ^(Editor)لمشاهدة النوافذ الأخرى المتاحة ، مرر الماوس فوق الرموز الموجودة في أقصى الجزء الأيمن وسيتم فتح جزء التنقل الرئيسي.

قسم النظرة العامة^(Overview) هو المكان الذي يمكنك فيه العثور على إحصائيات حول البرنامج النصي الخاص بك مثل عدد الأخطاء التي حدثت وعدد مرات تنفيذها والمزيد.

سنغطي كل قسم من الأقسام الأخرى لمحرر Google Apps Script في كل قسم أدناه.

التنقل في محرر النصوص البرمجية لتطبيقات Google^{(Google Apps Script Editor)}

أثناء قيامك بتحرير الكود الخاص بك في المحرر ، من الأفضل تحديد رمز القرص ( حفظ^(Save) ) كثيرًا حتى لا تفقد عملك.

بمجرد الحفظ ، سترى خيارات القائمة الأخرى تضيء. 

وتشمل هذه:

• تشغيل^(Run) : حاول تشغيل البرنامج النصي بالكامل من البداية إلى النهاية.
• تصحيح الأخطاء^(Debug) : انتقل إلى البرنامج النصي الخاص بك سطرًا واحدًا في كل مرة.
• القائمة المنسدلة للوظائف^{(Function dropdown)} : تصفح وانتقل إلى كل وظيفة من الوظائف التي قمت بإنشائها.
• سجل التنفيذ^{(Execution log)} : شاهد أي حالة أو رسائل خطأ من كل محاولة قمت بها لتشغيل البرنامج النصي الخاص بك.

خيار المكتبات^(Libraries) في قائمة التنقل اليسرى هو المكان الذي يمكنك من خلاله الوصول إلى المكتبات التي كتبها أشخاص آخرون (أو قمت بكتابتها وحفظها في مكان آخر). يكون هذا مفيدًا إذا كان لديك صديق كتب بالفعل ميزة تريد استخدامها في جداول بيانات^{(Google Sheets)} Google أو مستندات Google^{(Google Docs)} ولكنك ترغب في إضافة ميزات إضافية فوق ذلك.

كل ما تحتاجه لإضافة هذه المكتبات إلى مشروعك هو معرف البرنامج النصي^{(Script ID)} . يمكنك العثور على هذا في قسم إعدادات المشروع ، والذي سنوضح لك كيفية العثور عليه في نهاية هذه المقالة.

الوظائف الإضافية لخدمات برمجة تطبيقات Google

قسم الخدمات^(Services) هو الأكثر فائدة. إنه المكان الذي يمكنك فيه دمج البرنامج النصي الحالي مع خدمات Google الأخرى التي قد تستخدمها. 

عند تحديده ، سترى نافذة إضافة خدمة مفتوحة. ^{(Add a service)}قم بالتمرير^(Scroll) لأسفل إلى الخدمة التي تريد استخدامها كإضافة لمشروعك الحالي. 

على سبيل المثال ، إذا كنت ترغب في سحب البيانات من حسابك في Google Analytics إلى هذا النص البرمجي ، يمكنك تحديد Google Analytics API ، وتحديد Add .

إذا كنت تريد العثور على تفاصيل حول الوظائف المتاحة للاستخدام لهذه الخدمة الإضافية الجديدة وكيفية استخدامها ، فحدد النقاط الثلاث على يمين واجهة برمجة التطبيقات^(API) وحدد انظر الوثائق^{(See documentation)} .

سيؤدي هذا إلى فتح وثائق Google Apps Script في علامة تبويب جديدة ، يتم فتحها تلقائيًا إلى قسم خدمة Google هذه .

استكشف الوثائق الخاصة ببناء جملة الوظائف والبرامج التعليمية وأمثلة التعليمات البرمجية التي يمكنك استخدامها في البرنامج النصي الخاص بك.

لاحظ أيضًا أنه يمكنك الانتقال إلى أقسام أخرى من الوثائق لمعرفة الوظائف العامة المتوفرة في النص البرمجي بناءً على الخدمة التي كنت تستخدمها عندما فتحت محرر رمز Apps Script في الأصل.^{(Apps Script)}

على سبيل المثال ، إذا فتحت المحرر في Google Sheets ، فتحقق من قسم Sheets في قائمة التوثيق لوظائف Google Sheets التي يمكنك استخدامها في البرنامج النصي الخاص بك.

إعداد مشغلات برمجة التطبيقات واستخدامها^{(Using Apps Script Triggers)}

ميزة أخرى مفيدة في Google Apps Script هي القدرة على تعيين المشغلات بناءً على عدد من الأحداث أو الجداول الزمنية.

لتكوين مشغل جديد للبرنامج النصي الخاص بك ، حدد المشغلات^(Triggers) من قائمة التنقل أقصى اليسار. في نافذة المشغلات^(Triggers) الجديدة التي تفتح ، حدد زر إضافة مشغل .^{(Add Trigger)}

تحتوي نافذة Add Trigger على قائمة طويلة من الخيارات التي تساعدك على تخصيص بالضبط كيف ومتى تريد تشغيل البرنامج النصي. 

ملاحظة^(Note) : تعتمد العديد من هذه الخيارات على الخدمة التي تكتب البرنامج النصي لها أو واجهات برمجة التطبيقات التي أضفتها^{(the APIs that you’ve added)} .

لإعداد المشغل الخاص بك ، ستحتاج إلى اختيار:

• الوظيفة التي سيتم إطلاقها في البداية
• مصدر الحدث مثل وقت أو تاريخ محدد أو حدث في خدمتك مثل عندما تتغير خلية جدول بيانات Google أو عندما يتم فتح مستند في البداية
• نوع الحدث ، مثل وقت فتح أو تحرير شيء ما في جدول بيانات Google أو المستند ، أو الإعداد المحدد للتاريخ أو الوقت
• عدد مرات التنبيه عن عدد المرات التي تريد الحصول على تحديثات حول وقت فشل البرامج النصية الخاصة بك

بمجرد تحديد حفظ^(Save) ، قد ترى رسالة " فشل تخويل البرنامج النصي^(Script) " إذا كانت هذه هي المرة الأولى التي تحفظ فيها مشغلًا جديدًا.

يتم تشغيل هذا عادةً إذا كان لديك مانع النوافذ المنبثقة ممكّنًا في متصفحك. إذا كنت تستخدم Google Chrome ، فما عليك سوى تحديد رمز النافذة الصغيرة مع علامة "X" حمراء فوقه. قم بتغيير الإعداد إلى السماح دائمًا بالنوافذ المنبثقة^{(Always allow pop-ups)} وحدد تم^(Done) .

عند تحديد " حفظ^(Save) " مرة أخرى ، ستحتاج إلى تنفيذ العملية للسماح للبرنامج الذي كتبته للتشغيل ضمن حساب Google الخاص بك أو Google Workspace .

أولاً ، حدد حساب Google الذي تريد السماح بتشغيل البرنامج النصي تحته.

سترى تحذيرًا من أن الوظيفة المخصصة أو النص البرمجي الذي كتبته لم يتم "التحقق منه" بواسطة Google . إذا كنت أنت الشخص الذي كتب النص ، فهذا لا يهم ومن الآمن تشغيله ضمن حساب Google^{(Google Account)} الخاص بك أو Google Workspace .

لتجاوز هذا التحذير ، ما عليك سوى تحديد متقدم^(Advanced) ثم تحديد الارتباط Go to <project> (unsafe) في الأسفل.

أخيرًا ، في نافذة الأذونات ، حدد السماح^(Allow) للسماح بتشغيل وظائفك المخصصة والنصوص البرمجية ضمن حساب Google الخاص بك أو Google Workspace .

لن تضطر إلى تكرار هذه العملية مرة أخرى ، فقط في المرة الأولى التي تحفظ فيها أو تشغل مشاريعك البرمجية  المخصصة لتطبيقات Google .^{(Google Apps)}

الوصول إلى معرف Google Script الخاص بك

ملاحظة أخيرة - قد ترغب في تقديم النص الخاص بك إلى الأصدقاء أو الزملاء حتى يتمكنوا من استخدام البرنامج النصي أو إضافته كمكتبة إلى البرنامج النصي الخاص بهم. 

يمكنك العثور على معرّف البرنامج النصي^{(Script ID)} الخاص بك ضمن أيقونة الإعدادات^(Settings) في جزء التنقل أقصى اليسار.

يمكن العثور على معرف البرنامج النصي ضمن قسم المعرفات ^{(Script ID)}،^(IDs) على يمين معرف البرنامج النصي^{(Script ID)} .

كما ترى ، يعد محرر النص البرمجي لتطبيقات Google^{(Google Apps Script)} واضحًا إلى حد ما إذا كنت تعرف كيفية التنقل إلى كل ميزة تريد استخدامها. فقط^(Just) تأكد من دراسة وثائق Google Apps Script جيدًا حتى تتمكن من البدء في تعلم كيفية كتابة البرامج النصية وجميع الوظائف المتاحة للاستخدام.

Google Apps Script Editor: Everything You Need to Know to Get Started

If you use Google services like Google Docs, Google Sheets, Google Analytics, Gmail, and otherѕ, yoυ could connect and аutomate those services using Google Apps Script. 

Think of Google Apps Script like Google’s version of Microsoft’s VBA script. Just like you can automate actions and tasks or customize macros in Microsoft Word and Excel with VBA, you can automate tasks and actions across Google services. In services like Sheets and Docs, you can even write your own custom menus.

In this article you will learn how to access and enable Apps Script in your various Google services, how to navigate the Apps Script Editor, and how to connect services. You won’t learn specific script functions, but Google has excellent documentation and apps script tutorials available to learn how to write Apps Script.

How to Access Google Apps Script Editor

You can open the Google Apps Script code editor from within a number of Google services. For example, you’ll find Apps Script in the Extensions menu inside Google Sheets.

In other services, you can open the Google Apps Script editor in the following ways:

• Google Docs: Select Script editor in the Tools menu.
• Google Slides: Select Script editor in the Tools menu.
• Google Forms: Select Script editor in the three-dot menu.
• Google Drive: Right-click any blank space, select More, and select Google Apps Script.

Using any of these methods, you’ll see the Apps Script code editor open in a new tab. This is the window where you’ll write each of the functions that make up your entire script. By default, you’ll see an empty function named myFunction() that’s ready for you to start filling in your code.

Note: Code formatting is very important in order to avoid errors. Use commenting as shown in the following code to remind yourself what you were trying to do inside sections of code. This is very similar to how commenting works in HTML code with web programming.

As you navigate the code editor, you can return to this section by selecting Code.gs in the left navigation pane in the Editor window. To see other available windows, hover over the icons in the far left pane and the main navigation pane will open.

The Overview section is where you can find statistics about your script like how many errors have occurred, how many times it’s executed, and more.

We’ll cover each of the other sections of the Google Apps Script editor in each section below.

Navigating the Google Apps Script Editor

As you edit your code in the editor, it’s a good idea to select the disk (Save) icon often so that you don’t lose your work.

Once saved, you’ll see the other menu options light up. 

These include:

• Run: Attempt to run your entire script from beginning to end.
• Debug: Step through your script one line at a time.
• Function dropdown: Browse through and navigate to each of the functions you’ve created.
• Execution log: See any status or error messages from each attempt you’ve made to run your script.

The Libraries option in the left navigation menu is where you can access libraries that other people have written (or you’ve written and saved elsewhere). This is useful if you have a friend who already wrote a feature you’d like to use in Google Sheets or Google Docs but you’d like to add additional features on top of that.

All you need to add those libraries into your project is the Script ID. You can find this in the project settings section, which we’ll show you how to find toward the end of this article.

Google Apps Script Services Add-Ons

The Services section is the most useful. It’s where you can integrate your current script with other Google services you may use. 

When you select it, you’ll see the Add a service window open. Scroll down to the service you want to use as an add-on to your existing project. 

For example, if you’d like to pull data from your Google Analytics account into this script, you can select the Google Analytics API, and select Add.

If you want to find details about what functions are available to use for that new add-on service and how to use them, select the three dots to the right of the API and select See documentation.

This will open the Google Apps Script documentation in a new tab, opened automatically to the section for that Google service.

Explore the documentation for function syntax, tutorials, and code examples that you can use in your own script.

Also, note that you can navigate to other sections of the documentation to see what general functions are available in your script based on the service you were using when you originally opened the Apps Script code editor.

For example, if you opened the editor in Google Sheets, check the Sheets section in the documentation menu for Google Sheets functions you’re able to use in your script.

Setting Up and Using Apps Script Triggers

Another useful feature in Google Apps Script is the ability to set triggers based on a number of events or schedules.

To configure a new trigger for your script, select Triggers from the far left navigation menu. In the new Triggers window that opens, select the Add Trigger button.

The Add Trigger window has a long list of options that help you customize exactly how and when you want your script to run. 

Note: Many of these options depend on the service you’re writing your script for or the APIs that you’ve added.

To set up your trigger, you’ll need to choose:

• Which function to initially launch
• The event source such as a specific time, date, or an event in your service like when a Google spreadsheet cell changes or a document is initially opened
• The event type such as when something in your Google spreadsheet or document is opened or edited, or the specific setting for date or time
• Notification frequency for how often you want to get updates about when your scripts have failed

Once you select Save, you may see a “Script authorization failed” message if it’s the first time you’ve saved a new trigger.

This is usually triggered if you have a pop-up blocker enabled in your browser. If you’re using Google Chrome, just select the small window icon with a red “X” over it. Change the setting to Always allow pop-ups and select Done.

When you select Save again, you’ll need to step through the process to authorize the script you’ve written to run under your Google account or Google Workspace.

First, select the Google account that you want to allow your script to run under.

You’ll see a warning that the custom function or script you wrote isn’t “verified” by Google. If you’re the person who wrote the script, then this doesn’t matter and it’s safe to run under your own Google Account or Google Workspace.

To bypass this warning, just select Advanced and then select the Go to <project> (unsafe) link at the bottom.

Finally, in the permissions window, select Allow to allow your custom functions and script to run under your Google account or Google Workspace.

You won’t have to repeat this process again, only the first time you save or run your custom Google Apps script projects. 

Accessing Your Google Script ID

One final note – you may want to provide your script to friends or colleagues so they can either use your script or add it as a library to their own script. 

You can find your Script ID under the Settings icon in the far left navigation pane.

The Script ID can be found under the IDs section, to the right of Script ID.

As you can see, the Google Apps Script editor is fairly straightforward if you know how to navigate to each feature you want to use. Just make sure to study Google’s Apps Script documentation well so that you can start learning how to write your scripts and all functions that are available to use.

Related posts

• كيف يمكن أن تساعدك تطبيقات Google التجريبية في مكافحة الإدمان الرقمي

• أفضل 5 تطبيقات لتصفية الضوء الأزرق لنظام التشغيل Windows و Mac و Linux

• 5 تطبيقات محمولة تريد بالتأكيد الحصول عليها على USB Stick

• Google Chrome Autofill: دليل كامل

• 4 أفضل تطبيقات برامج إعادة توجيه المنافذ وكيفية استخدامها

• كيفية التحقق مما إذا كانت درجة حرارة وحدة المعالجة المركزية لديك مرتفعة جدًا

• أفضل 6 تطبيقات للتحقق من درجة حرارة وحدة المعالجة المركزية في نظام التشغيل Windows 11/10

• 3 أدوات لتشخيص واستكشاف مشاكل الشاشة

• امتداد أمان Avast عبر الإنترنت: هل يستحق الاستخدام؟

• استخدم كاميرا ويب قديمة لمراقبة ممتلكاتك مجانًا

• أفضل التطبيقات لمراقبة استخدام الإنترنت

• أشياء يجب مراعاتها قبل إنشاء الويكي الخاص بك

• 4 أدوات رائعة لإنشاء حزم Windows Installer

• التعلم الإلكتروني للأطفال - أفضل التطبيقات والأدوات لتثقيف أطفالك في المنزل

• Xcode لنظام التشغيل Windows (أفضل 8 أدوات لتطوير تطبيقات iOS على جهاز الكمبيوتر)

• أفضل 4 تطبيقات خارجية لنظام التشغيل Windows 10 يجب عليك تثبيتها الآن

• أفضل 4 بدائل لـ Google Chromecast

• إعدادات محتوى Google Chrome: دليل كامل

• 5 أفضل مواقع تنزيل APK آمنة لتطبيقات Android

• أفضل 11 برنامج لقطة شاشة مجانية لنظام التشغيل Windows