Kapsayıcıya Bağlı Komut Dosyaları

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ı" denir. 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 Google Sites'e de bağlanabileceğini ancak bu komut dosyalarının neredeyse her zaman web uygulaması 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.

Not: Bağlı komut dosyaları, yalnızca bağlı oldukları dosya için çalışan, yayınlanmamış eklentilerdir.

Bağlı komut dosyası oluşturma

Google Dokümanlar, E-Tablolar veya Slaytlar

Google Dokümanlar, E-Tablolar veya Slaytlar'da bağlı komut dosyası oluşturmak için Dokümanlar'da bir doküman, E-Tablolar'da bir e-tablo veya Slaytlar'da bir sunu açıp Uzantılar > Apps Script'i tıklayın. Senaryoyu gelecekte yeniden açmak için aynı işlemi yapın veya 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. Senaryoyu gelecekte yeniden açmak için aynı işlemi yapın veya Apps Script kontrol panelinden açın.

Not: clasp aracı, bağlı komut dosyaları oluşturamaz ancak bu komut dosyalarını kopyalayıp düzenleyebilir.

Özel yöntemler

Bağlı komut dosyaları, bağımsız komut dosyalarının çağıramadığı birkaç yöntemi çağırabilir:

• getActiveSpreadsheet(), getActiveDocument(), getActivePresentation() ve getActiveForm(), 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() ve getActiveCell(), kullanıcının geçerli e-tablosunu, seçili hücre aralığını veya seçili tek hücreyi komut dosyasının belirlemesine olanak tanır. setActiveSheet(sheet) ve setActiveRange(range) komut dosyasının bu seçimleri değiştirmesine izin verin.
• Google Dokümanlar'da getActiveTab(), getCursor() ve getSelection() kullanıcı için geçerli sekmeyi, imlecin konumunu veya seçili metni belirlemek için komut dosyasını kullanın. setActiveTab(tabId), setCursor(position) ve setSelection(range) komut dosyasının bu seçimleri değiştirmesine izin verin.

Daha fazla bilgi için Google E-Tablolar'ı genişletme kılavuzunu veya Google Dokümanlar'ı genişletme kılavuzunu inceleyin.

Not: Bu yöntemler yalnızca komut dosyası düzenleyicisinden, menü öğelerinden, iletişim kutularından, kenar çubuklarından veya tetikleyicilerden çalıştırılan bağlı komut dosyaları tarafından kullanılabilir. Bağlı bir komut dosyası web uygulaması olarak veya Apps Script API üzerinden çalıştırıldığında bu yöntemler kullanılamaz.

Ö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. Ancak bir komut dosyasının yalnızca açık dosyanın mevcut örneğinin kullanıcı arayüzüyle etkileşim kurabileceğini unutmayın. Yani bir dokümana bağlı komut dosyası, başka bir dokümanın kullanıcı arayüzünü etkileyemez.

Eklentiler ayrıca özel menüler, iletişim kutuları ve kenar çubukları da ekleyebilir. Eklentilerin bağımsız komut dosyaları kullanılarak geliştirilmesi önerilir.

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şimi olan bir kullanıcı tarafından 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 iznine sahip 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.

Kapsayıcıya bağlı tüm komut dosyaları, kapsayıcı dosyası için tanımlanan aynı sahip, görüntüleyen ve düzenleyici erişim listesini kullanır. Kapsayıcı sahibi, yeni bir komut dosyası projesinin sahibi olur.