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

Bir komut dosyası, bağımsız bir komut dosyası olarak değil de bir Google E-Tablolar, Dokümanlar, Slaytlar veya Formlar dosyasına bağlıdır. Bağlı bir komut dosyasının eklendiği dosyaya "kapsayıcı" adı verilir. Bağlı komut dosyaları genellikle bağımsız komut dosyaları gibi davranır ancak Google Drive'da görünmezler, bağlı oldukları dosyadan ayrılamazlar ve üst dosyaya göre birkaç özel ayrıcalık elde ederler.

Komut dosyalarının Google Sites'a da 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 nadiren web uygulamaları haline gelebilir.

Not: Bağlı komut dosyaları, yalnızca bağlı oldukları dosya için çalışan ve etkili bir şekilde yayından kaldırılmış olan eklentilerdir.

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. Komut dosyasını ileride yeniden açmak için aynı şeyi yapın veya Apps Komut Dosyası kontrol panelinden komut dosyasını açın.

Google Forms

Google Formlar'da bağlı bir komut dosyası oluşturmak için bir form açıp Diğer > Komut dosyası düzenleyicisi'ni 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.

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

Özel yöntemler

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

• getActiveSpreadsheet(), getActiveDocument(), getActivePresentation() ve getActiveForm() bağlı komut dosyalarının, dosya kimliğine bakmadan üst dosyaya başvurmasına izin verir.
• 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 izin verir.
• Google E-Tablolar'da getActiveSheet(), getActiveRange() ve getActiveCell() 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) ve setActiveRange(range) komut dosyasının bu seçimleri değiştirmesine izin verin.
• Google Dokümanlar'da getCursor() ve getSelection() komut dosyası, kullanıcının imlecinin veya seçilen metnin yerini belirler. setCursor(position) ve setSelection(range) komut dosyasının bu konumları 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 bakın.

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ı için kullanılabilir. Bağlı komut dosyaları 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ğlı 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.

Eklentilere özel menüler, iletişim kutuları ve kenar çubukları da eklenebilir. Bağımsız komut dosyaları kullanarak eklenti geliştirmeniz önerilir.

Eklentiler

Eklentiler; Gmail, Google E-Tablolar, Dokümanlar, Slaytlar ve Formlar'da çalışır. Bağlanmış veya bağımsız bir komut dosyası geliştirdiyseniz ve bunu tüm dünyayla paylaşmak istiyorsanız Apps Komut Dosyası, diğer kullanıcıların eklenti mağazasından yükleyebileceği bir eklenti olarak komut dosyanızı publish olanak tanır.

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 yüklenebilir tetikleyicileri de kullanabilirler.

Ö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ı dosyanın bir kopyasını oluştururlarsa kopyanın sahibi olurlar ve komut dosyasının bir kopyasını görüp çalıştırabilirler.

Komut dosyasının kapsayıcı dosyasını nasıl paylaşacağınızı öğrenmek için Google Drive'dan dosya paylaşma bölümüne bakın.

Kapsayıcıya bağlı tüm komut dosyaları, kapsayıcı dosyası için tanımlanan aynı sahip, görüntüleyici ve düzenleyici erişim listesini kullanır. Kapsayıcı sahibi, yeni komut dosyası projesini kimin oluşturduğundan bağımsız olarak o projenin sahipliğini alır.