اگر از سرویس‌های Google مانند Google Docs ، Google Sheets ، Google Analytics ، Gmail و سایرین استفاده می‌کنید، می‌توانید آن سرویس‌ها را با استفاده از Google Apps Script متصل و خودکار کنید. 

به Google Apps Script^{(Google Apps Script)} مانند نسخه Google از اسکریپت VBA مایکروسافت^{(Microsoft’s VBA script)} فکر کنید . درست همانطور که می توانید اقدامات و وظایف را خودکار کنید یا ماکروها را در Microsoft Word و Excel با VBA^{(Excel with VBA)} سفارشی کنید، می توانید کارها و اقدامات را در سراسر سرویس های Google خودکار کنید. در سرویس‌هایی مانند Sheets و Docs ، حتی می‌توانید منوهای سفارشی خود را بنویسید.

در این مقاله نحوه دسترسی و فعال کردن Apps Script در سرویس‌های مختلف Google^{(various Google services)} خود ، نحوه پیمایش در Apps Script Editor و نحوه اتصال سرویس‌ها را خواهید آموخت. شما توابع اسکریپت خاصی را یاد^{(learn specific script functions)} نخواهید گرفت ، اما Google مستندات عالی و آموزش های اسکریپت برنامه ها را برای یادگیری نحوه نوشتن Apps Script در دسترس دارد.

نحوه دسترسی به ویرایشگر اسکریپت Google Apps^{(Access Google Apps Script Editor)}

می‌توانید ویرایشگر کد Google Apps Script را از داخل تعدادی از سرویس‌های Google باز کنید. ^(Google)برای مثال، Apps Script را در منوی Extensions در Google Sheets خواهید دید.

در سرویس‌های دیگر، می‌توانید ویرایشگر Google Apps Script را به روش‌های زیر باز کنید:

• Google Docs : ویرایشگر اسکریپت^{(Script editor)} را در منوی ابزار^(Tools) انتخاب کنید.
• اسلایدهای Google^{(Google Slides)} : ویرایشگر اسکریپت^{(Script editor)} را در منوی ابزار^(Tools) انتخاب کنید.
• Google Forms : ویرایشگر اسکریپت^{(Script editor)} را در منوی سه نقطه انتخاب کنید.
• Google Drive : روی هر فضای خالی کلیک راست کنید، More را انتخاب کنید و Google Apps Script را انتخاب کنید .

با استفاده از هر یک از این روش ها، ویرایشگر کد Apps Script را در یک برگه جدید باز می بینید . این پنجره ای است که در آن هر یک از توابع را که کل اسکریپت شما را تشکیل می دهند، می نویسید. به‌طور پیش‌فرض، یک تابع خالی به نام myFunction() خواهید دید که برای شروع پر کردن کدتان آماده است.

توجه^(Note) : قالب بندی کد برای جلوگیری از خطا بسیار مهم است. همانطور که در کد زیر نشان داده شده است از کامنت گذاری استفاده کنید تا به خود یادآوری کنید که در بخش های کد می خواهید چه کاری انجام دهید. این بسیار شبیه نحوه عملکرد کامنت در کدهای HTML^(HTML) با برنامه نویسی وب است.

همانطور که در ویرایشگر کد پیمایش می کنید، می توانید با انتخاب Code.gs در پنجره ناوبری سمت چپ در پنجره ویرایشگر^(Editor) ، به این بخش بازگردید. برای مشاهده سایر پنجره های موجود، نشانگر را روی نمادها در سمت چپ سمت چپ قرار دهید و صفحه اصلی ناوبری باز می شود.

بخش نمای کلی^(Overview) جایی است که می توانید آمارهای مربوط به اسکریپت خود را پیدا کنید، مانند تعداد خطاهای رخ داده، چند بار اجرا و موارد دیگر.

ما هر یک از بخش‌های دیگر ویرایشگر Google Apps Script را در هر بخش در زیر پوشش خواهیم داد.^{(Google Apps Script)}

پیمایش در ویرایشگر اسکریپت Google Apps^{(Google Apps Script Editor)}

همانطور که کد خود را در ویرایشگر ویرایش می کنید، بهتر است اغلب نماد دیسک ( ذخیره^(Save) ) را انتخاب کنید تا کار خود را از دست ندهید.

پس از ذخیره، می بینید که سایر گزینه های منو روشن می شوند. 

این شامل:

• اجرا^(Run) : سعی کنید کل اسکریپت خود را از ابتدا تا انتها اجرا کنید.
• اشکال زدایی^(Debug) : اسکریپت خود را یک خط در یک زمان طی کنید.
• کشویی تابع^{(Function dropdown)} : هر یک از عملکردهایی که ایجاد کرده اید را مرور کرده و به آن پیمایش کنید.
• گزارش اجرا^{(Execution log)} : هر گونه وضعیت یا پیام خطا را از هر تلاشی که برای اجرای اسکریپت خود انجام داده اید مشاهده کنید.

گزینه Libraries^(Libraries) در منوی ناوبری سمت چپ جایی است که می توانید به کتابخانه هایی که دیگران نوشته اند (یا شما در جای دیگری نوشته و ذخیره کرده اید) دسترسی داشته باشید. اگر دوستی دارید که قبلاً یک ویژگی را نوشته است که می‌خواهید در Google Sheets یا Google Docs استفاده کنید ، اما می‌خواهید ویژگی‌های دیگری را در کنار آن اضافه کنید.

تنها چیزی که برای افزودن آن کتابخانه ها به پروژه خود نیاز دارید، شناسه اسکریپت^{(Script ID)} است. شما می توانید این را در بخش تنظیمات پروژه بیابید، که در پایان این مقاله به شما نشان خواهیم داد که چگونه آن را پیدا کنید.

افزونه های خدمات اسکریپت Google Apps

بخش خدمات^(Services) مفیدترین است. اینجا جایی است که می توانید اسکریپت فعلی خود را با سایر سرویس های Google که ممکن است استفاده کنید ادغام کنید. 

وقتی آن را انتخاب کردید، پنجره Add a service باز می شود. ^{(Add a service)}به سرویسی که می‌خواهید به عنوان یک افزونه برای پروژه موجود خود استفاده کنید، به پایین  بروید .^(Scroll)

برای مثال، اگر می‌خواهید داده‌ها را از حساب Google Analytics خود به این اسکریپت بکشید، می‌توانید API Google Analytics را^{(Google Analytics API)} انتخاب کنید و افزودن^(Add) را انتخاب کنید .

اگر می‌خواهید جزئیاتی در مورد عملکردهای موجود برای استفاده برای آن سرویس افزودنی جدید و نحوه استفاده از آنها بیابید، سه نقطه سمت راست API را انتخاب کنید و مشاهده مستندات را^{(See documentation)} انتخاب کنید .

با این کار اسناد Google Apps Script در یک برگه جدید باز می شود که به طور خودکار در بخش مربوط به آن سرویس Google باز می شود.

اسناد مربوط به نحو تابع، آموزش‌ها و نمونه‌های کد را که می‌توانید در اسکریپت خود استفاده کنید، کاوش کنید.

همچنین، توجه داشته باشید که می‌توانید به بخش‌های دیگر اسناد بروید تا ببینید چه عملکردهای کلی در اسکریپت شما بر اساس سرویسی که در هنگام باز کردن ویرایشگر کد Apps Script استفاده می‌کردید، در دسترس است.^{(Apps Script)}

برای مثال، اگر ویرایشگر را در کاربرگ‌نگار Google^{(Google Sheets)} باز کرده‌اید ، بخش کاربرگ‌نگار^(Sheets) را در منوی اسناد برای توابع Google Sheets که می‌توانید در اسکریپت خود استفاده کنید، بررسی کنید.

راه اندازی و استفاده از Apps Script Triggers^{(Using Apps Script Triggers)}

یکی دیگر از ویژگی‌های مفید در Google Apps Script ، امکان تنظیم محرک‌ها بر اساس تعدادی رویداد یا زمان‌بندی است.

برای پیکربندی یک ماشه جدید برای اسکریپت خود، Triggers را از منوی ناوبری سمت چپ انتخاب کنید. در پنجره جدید Triggers که باز می شود، دکمه ^(Triggers)Add Trigger را انتخاب کنید.

پنجره Add Trigger دارای فهرست طولانی از گزینه‌ها است که به شما کمک می‌کند دقیقاً نحوه و زمان اجرای اسکریپت خود را سفارشی کنید. 

توجه^(Note) : بسیاری از این گزینه ها به سرویسی که اسکریپت خود را برای آن می نویسید یا API هایی که اضافه کرده اید^{(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 Account)} Google یا Google Workspace امن است.

برای دور زدن این هشدار، فقط Advanced را انتخاب کنید و سپس پیوند Go to <project> (unsafe) را در پایین انتخاب کنید.

در نهایت، در پنجره مجوزها، Allow را انتخاب کنید تا به توابع و اسکریپت سفارشی شما اجازه داده شود تا در حساب Google یا Google Workspace شما اجرا شوند.

لازم نیست این فرآیند را دوباره تکرار کنید، فقط اولین باری که پروژه‌های اسکریپت  Google Apps سفارشی خود را ذخیره یا اجرا می‌کنید.^{(Google Apps)}

دسترسی به شناسه Google Script شما

نکته پایانی - ممکن است بخواهید اسکریپت خود را در اختیار دوستان یا همکاران خود قرار دهید تا آنها بتوانند از اسکریپت شما استفاده کنند یا آن را به عنوان یک کتابخانه به اسکریپت خود اضافه کنند. 

می توانید شناسه اسکریپت^{(Script ID)} خود را در زیر نماد تنظیمات^(Settings) در سمت چپ پنجره ناوبری پیدا کنید.

شناسه اسکریپت^{(Script ID)} را می توان در قسمت شناسه ها^(IDs) ، سمت راست شناسه اسکریپت^{(Script ID)} پیدا کرد.

همانطور که می بینید، ویرایشگر Google Apps Script نسبتاً ساده است اگر بدانید چگونه به هر ویژگی که می خواهید استفاده کنید پیمایش کنید. فقط^(Just) مطمئن شوید که مستندات Google's Apps Script را به خوبی مطالعه کرده اید تا بتوانید شروع به یادگیری نحوه نوشتن اسکریپت های خود و همه عملکردهایی کنید که برای استفاده در دسترس هستند.

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

If yоu use Google services like Google Docs, Google Sheets, Google Analytics, Gmail, and others, you could connect and automate those serviceѕ 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

• چگونه اپلیکیشن های آزمایشی گوگل می توانند به شما در مبارزه با اعتیاد دیجیتال کمک کنند

• 5 بهترین برنامه فیلتر نور آبی برای ویندوز، مک و لینوکس

• 5 برنامه قابل حمل که قطعاً می خواهید روی USB Stick خود داشته باشید

• تکمیل خودکار گوگل کروم: راهنمای کامل

• 4 بهترین نرم افزار حمل و نقل پورت و نحوه استفاده از آنها

• بهترین برنامه های تحلیلگر WiFi برای Windows، iOS، macOS و Android

• برنامه افزودنی امنیتی آنلاین Avast: آیا ارزش استفاده از آن را دارد؟

• بهترین افزونه ها برای تقویت مجموعه آفیس Google شما

• چگونه DVD و Blu-Ray خود را بدون دردسر با MakeMKV پاره کنید

• آموزش الکترونیکی برای کودکان - بهترین برنامه‌ها و ابزارها برای آموزش کودکان در خانه

• 11 بهترین برنامه تیم مایکروسافت در سال 2022

• ترجمه گوگل در مقابل بینگ ترنسلیت – کدام یک بهترین است؟

• بهترین ابزارهای تنظیم CPU، کارت ویدئو و RAM

• آیا بازیابی فایل ویندوز مایکروسافت کار می کند؟ ما آن را آزمایش کردیم.

• 6 بهترین برنامه اشتراک‌گذاری صفحه برای اتصال از راه دور به هر رایانه شخصی

• 7 بهترین برنامه طراحی برای ویندوز

• بهترین ویرایشگرهای Markdown: همه پلتفرم ها و آنلاین

• وب‌سایت‌ها چگونه کار می‌کنند: بیاموزید که چه چیزی زیر سرپوش است

• انتقال، حذف یا کپی خودکار فایل ها در ویندوز

• از یک وب کم قدیمی برای نظارت بر اموال خود به صورت رایگان استفاده کنید