Bir komut dosyası, bağımsız komut dosyası olarak değil de ilgili dokümandan oluşturulduysa Google E-Tablolar, Dokümanlar, Slaytlar veya Formlar dosyasına bağlanır. Bağlı komut dosyasının eklendiği dosyaya "kapsayıcı" adı verilir. Bağlı komut dosyaları genellikle bağımsız komut dosyaları gibi davranır. Bununla birlikte, Google Drive'da görünmezler, bağlı oldukları dosyadan ayrılamazlar ve üst dosya üzerinde birkaç özel ayrıcalık elde ederler.
Komut dosyalarının da Google Sites'a bağlı olabileceğini, ancak bu komut dosyalarının neredeyse her zaman web uygulamaları olarak dağıtıldığını unutmayın. Google E-Tablolar, Dokümanlar, Slaytlar veya Formlar'a bağlı komut dosyaları da web uygulaması haline gelebilir ancak bu durum yaygın değildir.
Bağlı komut dosyası oluşturma
Google Dokümanlar, E-Tablolar veya Slaytlar
Google Dokümanlar, E-Tablolar veya Slaytlar'da bağlı bir komut dosyası oluşturmak için Dokümanlar'da bir doküman, E-Tablolar'da bir e-tablo ya da Slaytlar'da bir sunu açın ve Uzantılar > Apps Komut Dosyası'nı tıklayın. Gelecekte komut dosyasını yeniden açmak için aynı işlemi yapın veya komut dosyasını Apps Script kontrol panelinden açın.
Google Forms
Google Formlar'da bağlı komut dosyası oluşturmak için bir form açın ve Diğer > Komut dosyası düzenleyici'yi tıklayın. Komut dosyasını ileride yeniden açmak için aynı şeyi yapın veya Apps Komut Dosyası kontrol panelinden komut dosyasını açın.
Özel yöntemler
Bağlı komut dosyaları, bağımsız komut dosyalarının çağıramadığı birkaç yöntemi çağırabilir:
getActiveSpreadsheet(),getActiveDocument(),getActivePresentation()vegetActiveForm(), bağlı komut dosyalarının dosyanın kimliğine başvurmadan üst dosyalarına başvurmasına olanak tanır.getUi, bağlı komut dosyalarının özel menüler, iletişim kutuları ve kenar çubukları eklemek için üst dosyalarının kullanıcı arayüzüne erişmesine olanak tanır.- Google E-Tablolar'da
getActiveSheet(),getActiveRange()vegetActiveCell()komut dosyasının kullanıcının mevcut sayfasını, seçilen hücre aralığını veya seçilen tek bir hücreyi belirlemesine izin verir.setActiveSheet(sheet)vesetActiveRange(range)komut dosyasının bu seçimleri değiştirmesine izin verin. - Google Dokümanlar'da
getActiveTab(),getCursor()vegetSelection(); kullanıcının geçerli sekmesini, kullanıcının imlecinin konumunu veya seçili metni komut dosyasının belirlemesine izin verir.setActiveTab(tabId),setCursor(position)vesetSelection(range)komut dosyasının bu seçimleri değiştirmesine izin verin.
Daha fazla bilgi için Google E-Tablolar'ı genişletme kılavuzuna veya Google Dokümanlar'ı genişletme kılavuzuna göz atın.
Özel menüler, iletişim kutuları ve kenar çubukları
Bağlanmış komut dosyaları, özel menüler ve iletişim kutuları veya kenar çubukları ekleyerek Google E-Tablolar, Dokümanlar ve Formlar'ı özelleştirebilir. Bununla birlikte, bir komut dosyasının yalnızca açık bir dosyanın geçerli örneğinin kullanıcı arayüzüyle etkileşim kurabileceğini unutmayın. Yani bir belgeye bağlı komut dosyası, başka bir dokümanın kullanıcı arayüzünü etkileyemez.
Eklentiler
Eklentiler; Gmail, Google E-Tablolar, Dokümanlar, Slaytlar ve Formlar'da çalışır. Bağlı veya bağımsız bir komut dosyası geliştirdiyseniz ve bunu dünyayla paylaşmak istiyorsanız Apps Komut Dosyası, komut dosyanızı eklenti olarak yayınlamanıza olanak tanır. Böylece diğer kullanıcılar eklenti mağazasından komut dosyanızı yükleyebilir.
Tetikleyiciler
Bağlı komut dosyaları, bir dosya düzenleme erişimine sahip bir kullanıcı tarafından her açıldığında otomatik olarak çalışan özel onOpen() işlevi gibi basit tetikleyiciler kullanabilir. Tüm komut dosyası türleri gibi, bu komut dosyaları da yüklenebilir tetikleyiciler kullanabilir.
Özel işlevler
Özel işlev, Google E-Tablolar'a bağlı bir komut dosyasında bulunan ve =myFunctionName() söz dizimini kullanarak doğrudan bir hücreden çağırdığınız bir işlevdir. Bu nedenle özel işlevler, E-Tablolar'daki AVERAGE veya SUM gibi yüzlerce yerleşik işleve benzer. Tek fark, özel işlevin davranışını sizin tanımlamanızdır.
Bağlı komut dosyalarına erişim
Yalnızca kapsayıcıyı düzenleme izni olan kullanıcılar bağlı komut dosyasını çalıştırabilir. Yalnızca görüntüleme erişimi olan ortak çalışanlar komut dosyası düzenleyiciyi açamaz. Ancak kapsayıcı dosyasının kopyasını oluştururlarsa kopyanın sahibi olurlar ve komut dosyasının kopyasını görüp çalıştırabilirler.
Bir komut dosyasının kapsayıcı dosyasını nasıl paylaşacağınızı öğrenmek için Google Drive'dan dosya paylaşma başlıklı makaleyi inceleyin.