Google Workspace'teki Özel Menüler

Komut dosyaları, tıklandığında bir Apps Komut Dosyası işlevi yürüten kullanıcı arayüzü öğeleri ekleyerek belirli Google ürünlerini genişletebilir. En yaygın örnek, Google Dokümanlar, E-Tablolar, Slaytlar veya Formlar'daki özel bir menü öğesinden komut dosyası çalıştırmaktır. Komut dosyası işlevleri de Google E-Tablolar'da resim ve çizimler tıklanarak tetiklenebilir.

Google Dokümanlar, E-Tablolar, Slaytlar veya Formlar'daki özel menüler

Apps Komut Dosyası, Google Dokümanlar, E-Tablolar, Slaytlar veya Formlar'da her menü komut dosyasındaki bir işleve bağlı yeni menüler ekleyebilir. (Google Formlar'da özel menüler, formu düzenlemek için açan bir düzenleyici tarafından yalnızca görünürken yanıt vermek için formu açan kullanıcı tarafından görülemez.)

Komut dosyası yalnızca doküman, e-tablo veya forma bağlıysa menü oluşturabilir. Kullanıcı bir dosyayı açtığında menüyü görüntülemek için menü kodunu bir onOpen() işlevine yazın.

Aşağıdaki örnekte bir öğeli bir menüyü, ardından bir görsel ayırıcıyı ve başka bir öğeyi içeren bir alt menüyü nasıl ekleyeceğiniz gösterilmektedir. (Google E-Tablolar'da, yeni sürümü kullanmıyorsanız bunun yerine addMenu() söz dizimini kullanmanız gerektiğini ve alt menülerin kullanılamayacağını unutmayın.) Kullanıcı, menü öğelerinden birini seçtiğinde ilgili işlev bir uyarı iletişim kutusu açar. Açabileceğiniz iletişim türleri hakkında daha fazla bilgi edinmek için iletişim kutuları ve kenar çubukları kılavuzuna bakın.

function onOpen() {
  var ui = SpreadsheetApp.getUi();
  // Or DocumentApp or FormApp.
  ui.createMenu('Custom Menu')
      .addItem('First item', 'menuItem1')
      .addSeparator()
      .addSubMenu(ui.createMenu('Sub-menu')
          .addItem('Second item', 'menuItem2'))
      .addToUi();
}

function menuItem1() {
  SpreadsheetApp.getUi() // Or DocumentApp or FormApp.
     .alert('You clicked the first menu item!');
}

function menuItem2() {
  SpreadsheetApp.getUi() // Or DocumentApp or FormApp.
     .alert('You clicked the second menu item!');
}

Bir doküman, e-tablo, sunu veya form, belirli bir ada sahip yalnızca bir menü içerebilir. Aynı komut dosyası veya başka bir komut dosyası aynı ada sahip bir menü eklerse yeni menü, eskisinin yerini alır. Dosya açıkken menüler kaldırılamaz. Bununla birlikte, belirli bir mülk ayarlanmışsa ileride menüyü atlamak için onOpen() işlevinizi yazabilirsiniz.

Google E-Tablolar'da tıklanabilir resimler ve çizimler

Komut dosyası e-tabloya bağlı olduğu sürece, Google E-Tablolar'da bir resme veya çizime Apps Komut Dosyası işlevi de atayabilirsiniz. Aşağıdaki örnekte, bunun nasıl ayarlanacağı gösterilmektedir.

  1. Google E-Tablolar'da, e-tabloya bağlı bir komut dosyası oluşturmak için Uzantılar > Apps Komut Dosyası menü öğesini seçin.
  2. Komut dosyası düzenleyicisindeki tüm kodları silip aşağıdaki kodu yapıştırın.

      function showMessageBox() {
        Browser.msgBox('You clicked it!');
      }
    
  3. E-Tablolar'a dönün ve Ekle > Resim veya Ekle > Çizim'i seçerek bir resim veya çizim ekleyin.

  4. Resmi veya çizimi ekledikten sonra tıklayın. Sağ üst köşede küçük bir açılır menü seçici görünür. Komut dosyası ata'yı tıklayın.

  5. Açılan iletişim kutusunda, parantez olmadan çalıştırmak istediğiniz Apps Komut Dosyası işlevinin adını yazın (bu örnekte showMessageBox). Tamam'ı tıklayın.

  6. Resmi veya çizimi tekrar tıklayın. İşlev şimdi yürütülecektir.

Komut dosyası siteye bağlı olduğu sürece Google Sites'taki bir bağlantıya da Apps Komut Dosyası işlevi atayabilirsiniz. Aşağıdaki örnekte, bunun nasıl ayarlanacağı gösterilmektedir.

  1. Google Sites sitesinde Diğer > Siteyi yönet'i tıklayın.
  2. Kenar çubuğunda Apps Komut Dosyaları'nı, ardından Yeni komut dosyası ekle'yi tıklayarak siteye bağlı bir komut dosyası oluşturun.
  3. Komut dosyası düzenleyicisindeki herhangi bir kodu silin ve aşağıdaki kodu yapıştırın. Bu, kullanıcı bir bağlantıyı tıkladığında e-posta gönderir.

      function sitesLink() {
        var recipient = Session.getActiveUser().getEmail();
        GmailApp.sendEmail(recipient, 'Email from your site', 'You clicked a link!');
      }
    
  4. Google Sites sitesine dönün ve bir sayfayı düzenleyin. Click me gibi bir bağlantı olacak bir etiket yazıp metni vurgulayın ve Ekle > Bağlantı'yı seçin.

  5. Açılan iletişim kutusunda Apps Komut Dosyası'nı ve ardından az önce oluşturduğunuz sitesLink işlevini tıklayın. Tamam'ı tıklayın.

  6. Sayfanın en üstündeki Kaydet'i tıklayın.

  7. Sayfaya eklediğiniz bağlantıyı tıklayın.

  8. Komut dosyasının yetkilendirme gerektirdiğini belirten bir iletişim kutusu görünür. OK (Tamam) seçeneğini tıklayın. Ardından, belirli Google hizmetleri için yetkilendirme isteyen ikinci bir iletişim kutusu açılır. Bildirimi dikkatle okuyun, ardından İzin ver'i ve ardından Kapat'ı tıklayın.

  9. Komut dosyası yetkilendirildiğine göre, sayfaya eklediğiniz bağlantıyı tekrar tıklayın. İşlev şimdi yürütülecektir. Kendi gönderdiğiniz e-postayı görmek için e-postanızı kontrol edin.