Google Dokümanlar^{(Google Docs)} , Google E-Tablolar^{(Google Sheets)} , Google Analytics , Gmail ve diğerleri gibi Google hizmetlerini kullanıyorsanız, bu hizmetleri Google Apps Komut Dosyası^{(Google Apps Script)} kullanarak bağlayabilir ve otomatikleştirebilirsiniz . 

Google Apps Komut Dosyasını , Google'ın ^{(Google Apps Script)}Microsoft'un VBA komut dosyasının^{(Microsoft’s VBA script)} sürümü gibi düşünün . VBA ile ^{(Excel with VBA)}Microsoft Word ve Excel'de eylemleri ve görevleri otomatikleştirebildiğiniz veya makroları özelleştirebildiğiniz gibi , Google hizmetlerinde de görevleri ve eylemleri otomatikleştirebilirsiniz . E-Tablolar ve Dokümanlar^(Docs) gibi hizmetlerde kendi özel menülerinizi bile yazabilirsiniz.

Bu makalede, çeşitli Google hizmetlerinizde Apps Komut Dosyası'na nasıl erişeceğinizi ve bunları nasıl etkinleştireceğinizi , Apps ^{(various Google services)}Komut ^{(Apps Script)}Dosyası Düzenleyicisi'nde^{(Apps Script Editor)} nasıl gezineceğinizi ve hizmetlere nasıl bağlanacağınızı öğreneceksiniz. Belirli komut dosyası işlevlerini öğrenmeyeceksiniz^{(learn specific script functions)} , ancak Google , Apps Komut Dosyası^{(Apps Script)} yazmayı öğrenmek için mükemmel belgelere ve uygulama komut dosyası eğiticilerine sahiptir .

Google Apps Komut Dosyası Düzenleyicisine Nasıl Erişilir^{(Access Google Apps Script Editor)}

Google Apps Komut Dosyası^{(Google Apps Script)} kod düzenleyicisini bir dizi Google hizmetinden açabilirsiniz . Örneğin, Google E-Tablolar'daki Uzantılar^(Extensions) menüsünde Apps Komut Dosyası'nı^{(Apps Script)} bulacaksınız .

Diğer hizmetlerde, Google Apps Komut Dosyası^{(Google Apps Script)} düzenleyicisini aşağıdaki şekillerde açabilirsiniz :

• Google Dokümanlar^{(Google Docs)} : Araçlar^(Tools) menüsünde Komut Dosyası düzenleyicisini^{(Script editor)} seçin .
• Google Slaytlar^{(Google Slides)} : Araçlar^(Tools) menüsünden Komut Dosyası düzenleyicisini^{(Script editor)} seçin .
• Google Formlar^{(Google Forms)} : Üç noktalı menüden Komut Dosyası düzenleyicisini seçin.^{(Script editor)}
• Google Drive : Herhangi bir boş alanı sağ tıklayın, Diğer^(More) öğesini ve Google Apps Komut Dosyası^{(Google Apps Script)} öğesini seçin .

Bu yöntemlerden herhangi birini kullanarak, Apps Komut Dosyası^{(Apps Script)} kod düzenleyicisinin yeni bir sekmede açıldığını göreceksiniz . Bu, tüm komut dosyanızı oluşturan işlevlerin her birini yazacağınız penceredir. Varsayılan olarak, kodunuzu doldurmaya başlamanız için hazır olan myFunction() adlı boş bir işlev göreceksiniz.

Not^(Note) : Hatalardan kaçınmak için kod biçimlendirme çok önemlidir. Kod bölümleri içinde ne yapmaya çalıştığınızı kendinize hatırlatmak için aşağıdaki kodda gösterildiği gibi yorum yapmayı kullanın. Bu, web programlama ile HTML kodunda yorum yapmanın nasıl çalıştığına çok benzer .

Kod düzenleyicide gezinirken, Düzenleyici^(Editor) penceresindeki sol gezinme bölmesinde Code.gs'yi^(Code.gs) seçerek bu bölüme dönebilirsiniz . Kullanılabilir diğer pencereleri görmek için en soldaki bölmedeki simgelerin üzerine gelin; ana gezinme bölmesi açılacaktır.

Genel Bakış^(Overview) bölümü, komut dosyanızla ilgili kaç hata oluştuğu, kaç kez yürütüldüğü ve daha fazlası gibi istatistikleri bulabileceğiniz yerdir.

Aşağıdaki her bölümde Google Apps Komut Dosyası^{(Google Apps Script)} düzenleyicisinin diğer bölümlerinin her birini ele alacağız .

Google Apps Komut Dosyası Düzenleyicisi'nde^{(Google Apps Script Editor)} Gezinme

Kodunuzu düzenleyicide düzenlerken , çalışmanızı kaybetmemek için disk ( Kaydet^(Save) ) simgesini sık sık seçmek iyi bir fikirdir .

Kaydedildikten sonra, diğer menü seçeneklerinin yandığını göreceksiniz. 

Bunlar şunları içerir:

• Çalıştır^(Run) : Komut dosyanızın tamamını baştan sona çalıştırmayı deneyin.
• Hata Ayıklama^(Debug) : Komut dosyanızda her seferinde bir satır ilerleyin.
• İşlev açılır menüsü^{(Function dropdown)} : Oluşturduğunuz işlevlerin her birine göz atın ve bu işlevlere gidin.
• Yürütme günlüğü^{(Execution log)} : Komut dosyanızı çalıştırmak için yaptığınız her denemedeki durum veya hata mesajlarını görün.

Sol gezinme menüsündeki Kitaplıklar^(Libraries) seçeneği, diğer kişilerin yazdığı (veya başka bir yere yazıp kaydettiğiniz) kitaplıklara erişebileceğiniz yerdir. Bu, Google E-Tablolar^{(Google Sheets)} veya Google Dokümanlar'da^{(Google Docs)} kullanmak istediğiniz bir özelliği zaten yazan bir arkadaşınız varsa ancak bunun üzerine ek özellikler eklemek istiyorsanız kullanışlıdır.

Bu kitaplıkları projenize eklemek için ihtiyacınız olan tek şey Komut Dosyası Kimliğidir^{(Script ID)} . Bunu, bu makalenin sonuna doğru nasıl bulacağınızı göstereceğimiz proje ayarları bölümünde bulabilirsiniz.

Google Apps Komut Dosyası Hizmetleri Eklentileri

Hizmetler^(Services) bölümü en kullanışlı olanıdır . Mevcut komut dosyanızı kullanabileceğiniz diğer Google hizmetleriyle entegre edebileceğiniz yerdir. 

Bunu seçtiğinizde, Hizmet ekle^{(Add a service)} penceresinin açıldığını göreceksiniz. Mevcut projenize eklenti olarak kullanmak istediğiniz hizmete  ilerleyin .^(Scroll)

Örneğin, Google Analytics hesabınızdan bu komut dosyasına veri çekmek istiyorsanız, Google Analytics API'sini seçebilir ve ^{(Google Analytics API)}Ekle'yi^(Add) seçebilirsiniz .

Bu yeni eklenti hizmeti için hangi işlevlerin kullanılabildiği ve bunların nasıl kullanılacağı hakkında ayrıntıları öğrenmek istiyorsanız, API'nin^(API) sağındaki üç noktayı seçin ve Belgelere bakın^{(See documentation)} öğesini seçin .

Bu, Google Apps Komut Dosyası belgelerini yeni bir sekmede açar ve bu ^{(Google Apps Script)}Google hizmetinin bölümüne otomatik olarak açılır .

Kendi komut dosyanızda kullanabileceğiniz işlev sözdizimi, öğreticiler ve kod örnekleri için belgeleri keşfedin.

Ayrıca, Apps Komut Dosyası^{(Apps Script)} kod düzenleyicisini ilk açtığınızda kullandığınız hizmete bağlı olarak komut dosyanızda hangi genel işlevlerin mevcut olduğunu görmek için belgelerin diğer bölümlerine gidebileceğinizi unutmayın .

Örneğin, düzenleyiciyi Google E-^{(Google Sheets)} Tablolar'da açtıysanız , komut dosyanızda kullanabileceğiniz Google E-Tablolar işlevleri için dokümantasyon menüsündeki ^{(Google Sheets)}E-Tablolar^(Sheets) bölümüne bakın .

Apps Komut Dosyası Tetikleyicilerini^{(Using Apps Script Triggers)} Ayarlama ve Kullanma

Google Apps Komut Dosyası'ndaki^{(Google Apps Script)} bir başka kullanışlı özellik de , bir dizi olay veya programa dayalı olarak tetikleyiciler ayarlama yeteneğidir.

Komut dosyanız için yeni bir tetikleyici yapılandırmak için en soldaki gezinme menüsünden Tetikleyiciler'i seçin. ^(Triggers)Açılan yeni Tetikleyiciler^(Triggers) penceresinde Tetik Ekle^{(Add Trigger)} düğmesini seçin.

Tetikleyici Ekle^{(Add Trigger)} penceresi, komut dosyanızın tam olarak nasıl ve ne zaman çalışmasını istediğinizi özelleştirmenize yardımcı olan uzun bir seçenekler listesine sahiptir. 

Not^(Note) : Bu seçeneklerin çoğu, komut dosyanızı yazdığınız hizmete veya eklediğiniz API'lere^{(the APIs that you’ve added)} bağlıdır .

Tetikleyicinizi ayarlamak için şunları seçmeniz gerekir:

• Başlangıçta hangi işlevin başlatılacağı
• Belirli bir saat, tarih gibi olay kaynağı veya hizmetinizdeki bir olay, örneğin bir Google e-tablo hücresinin değişmesi veya bir belgenin ilk kez açılması gibi
• Google e-tablonuzdaki veya belgenizdeki bir şey açıldığında veya düzenlendiğinde veya tarih veya saat için belirli ayar gibi etkinlik türü
• Komut dosyalarınızın ne zaman başarısız olduğuyla ilgili güncellemeleri ne sıklıkta almak istediğinize ilişkin bildirim sıklığı

Kaydet^(Save) 'i seçtikten sonra , ilk kez yeni bir tetikleyici kaydettiyseniz, “ Komut dosyası yetkilendirme başarısız oldu” mesajını görebilirsiniz.^(Script)

Bu genellikle tarayıcınızda etkinleştirilmiş bir açılır pencere engelleyiciniz varsa tetiklenir. Google Chrome kullanıyorsanız , üzerinde kırmızı bir "X" bulunan küçük pencere simgesini seçmeniz yeterlidir. Ayarı Pop-up'lara her zaman izin ver^{(Always allow pop-ups)} olarak değiştirin ve Bitti'yi seçin^(Done) .

Tekrar Kaydet'i^(Save) seçtiğinizde , yazdığınız komut dosyasını Google hesabınız veya Google Workspace altında çalıştırmak üzere yetkilendirme işleminde adım adım ilerlemeniz gerekir .

İlk olarak, komut dosyanızın altında çalışmasına izin vermek istediğiniz Google hesabını seçin.^(Google)

Yazdığınız özel işlevin veya komut dosyasının Google^(Google) tarafından "doğrulanmadığına" dair bir uyarı görürsünüz . Senaryoyu yazan kişi sizseniz, bunun bir önemi yoktur ve kendi Google Hesabınız^{(Google Account)} veya Google Workspace altında çalıştırmanız güvenlidir .

Bu uyarıyı atlamak için, Gelişmiş'i^(Advanced) seçin ve ardından alttaki Go to <project> (unsafe) bağlantısını seçin.

Son olarak, izinler penceresinde, özel işlevlerinizin ve komut dosyanızın Google hesabınız veya Google Workspace altında çalışmasına izin vermek için ^{(Google Workspace)}İzin Ver'i^(Allow) seçin .

Bu işlemi tekrarlamanız gerekmeyecek, yalnızca özel Google Apps komut dosyası projelerinizi ilk kez kaydettiğinizde veya çalıştırdığınızda. 

Google Komut Dosyası Kimliğinize Erişme

Son bir not - komut dosyanızı arkadaşlarınıza veya iş arkadaşlarınıza sağlamak isteyebilirsiniz, böylece komut dosyanızı kullanabilirler veya kendi komut dosyalarına bir kitaplık olarak ekleyebilirler. 

Komut Dosyası Kimliğinizi^{(Script ID)} , en soldaki gezinme bölmesindeki Ayarlar^(Settings) simgesinin altında bulabilirsiniz .

Komut Dosyası Kimliği , ^{(Script ID)}Komut Dosyası Kimliği'nin^{(Script ID)} sağındaki Kimlikler^(IDs) bölümünde bulunabilir .

Gördüğünüz gibi, kullanmak istediğiniz her bir özelliğe nasıl gideceğinizi biliyorsanız , Google Apps Komut Dosyası düzenleyicisi oldukça basittir. ^{(Google Apps Script)}Komut^(Just) dosyalarınızı ve kullanılabilen tüm işlevleri nasıl yazacağınızı öğrenmeye başlayabilmeniz için Google'ın Apps Komut Dosyası belgelerini iyi incelediğinizden emin olun.^{(Apps Script)}

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

If you use Google serviсеs like Google Dосs, Google Sheets, Google Analyticѕ, Gmail, and others, you could connect аnd automate those services using Google Appѕ 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'ın Deneysel Uygulamaları Dijital Bağımlılıkla Mücadelenize Nasıl Yardımcı Olabilir?

• Windows, Mac ve Linux İçin En İyi 5 Mavi Işık Filtresi Uygulaması

• USB Belleğinizde Bulunmasını Kesinlikle İstediğiniz 5 Taşınabilir Uygulama

• Google Chrome Otomatik Doldurma: Eksiksiz Bir Kılavuz

• 4 En İyi Bağlantı Noktası Yönlendirme Yazılımı Uygulaması ve Nasıl Kullanılacağı

• Google Chrome İçerik Ayarları: Tam Kılavuz

• Signal Masaüstü Uygulaması Gizliliğinizi Korumaya Nasıl Yardımcı Olabilir?

• Monitörünüzle İlgili Sorunları Tanılamak ve Sorun Gidermek için 3 Araç

• Zapier E-posta Ayrıştırıcı: Kullanmanın 3 Yaratıcı Yolu

• Windows Programlarını Yüklemek için Windows Paket Yöneticisi Nasıl Kullanılır

• Windows 10'da Yinelenen Dosyaları Bulmak ve Kaldırmak için 5 Uygulama

• Avast Çevrimiçi Güvenlik Uzantısı: Kullanmaya Değer mi?

• Çocuklar İçin E-Öğrenme – Çocuklarınızı Evde Eğitmek İçin En İyi Uygulamalar ve Araçlar

• Çift Monitörleri Yönetmek için En İyi 5 Yazılım Programı

• Bir Microsoft Planner Eğitimi: Bilmeniz Gereken Her Şey

• Herhangi Bir PC'ye Uzaktan Bağlanmak için En İyi 6 Ekran Paylaşımı Uygulaması

• Bu 5 Site ve Uygulamayla Bir Profesyonel Gibi Kodlamayı Öğrenin

• Windows Installer Paketleri Oluşturmak için 4 Harika Araç

• En İyi Konferans Görüşmesi Hizmeti Nedir – Karşılaştırılan En İyi Uygulamalar

• Windows için Xcode (PC'de iOS Uygulamaları Geliştirmek için En İyi 8 Araç)