Google E-Tablolar'ın kapsamını eklentilerle genişletme

Google E-Tablolar, gerçek zamanlı ortak çalışma ve verileri görselleştirmek, işlemek ve paylaşmak için güçlü araçlar sunan bulut tabanlı bir e-tablo çözümüdür.

E-Tablolar'ı, özelleştirilmiş iş akışı iyileştirmeleri oluşturan, üçüncü taraf sistemlerle bağlantı kuran ve E-Tablolar verilerinizi diğer Google Workspace uygulamalarıyla (ör. Google Slaytlar) entegre eden eklentilerle genişletebilirsiniz.

Diğer kullanıcıların oluşturduğu E-Tablolar eklentilerini Google Workspace Marketplace'te görebilirsiniz.

Ne yapabilirsiniz?

Google E-Tablolar'ı genişleten bir eklentiyle yapabileceğiniz bazı işlemler:

  • Yerleşik Apps Komut Dosyası e-tablo hizmetini kullanarak Google E-Tablolar e-tablolarındaki verileri okuyabilir, düzenleyebilir, görselleştirebilir ve biçimlendirebilirsiniz. Bu hizmet, koşullu biçimlendirme ve veri doğrulama kuralları oluşturmanıza ve değiştirmenize de olanak tanır.
  • Google Sheets API'ye doğrudan erişmek için Apps Komut Dosyası gelişmiş E-Tablolar hizmetini kullanabilirsiniz.
  • Standart HTML ve CSS'yi kullanarak özel menüler oluşturabilir ve birden fazla özel iletişim kutusu ve kenar çubuğu arayüzü tanımlayabilirsiniz.
  • Eklentinize özel işlev tanımları ekleyebilirsiniz.
  • Belirli tetikleyici etkinlikler gerçekleştiğinde belirli işlevleri çalıştıran eklenti tetikleyicilerini kullanabilirsiniz.

E-Tablolar eklentileri, Apps Komut Dosyası kullanılarak oluşturulur. Apps Script ile Google E-Tablolar'a erişme ve bu hizmeti yönetme hakkında daha fazla bilgi edinmek için Google E-Tablolar'ı genişletme başlıklı makaleyi inceleyin.

E-tablo yapısı

Google E-Tablolar e-tabloları bir veya daha fazla sayfadan oluşur. Her sayfa temelde metin, sayı, bağlantı veya başka değerlerin depolanabileceği 2D bir hücre ızgarasıdır. Bir veya daha fazla bitişik hücre grubuna aralık denir.

Apps Script E-Tablolar hizmeti, E-Tablolar'daki kuruluş yapılarını temsil etmek için çeşitli sınıflar (ör. Sheet ve Range) sağlar. E-Tablolar verilerini ve davranışını okumak ve değiştirmek için bu sınıfları kullanabilirsiniz.

Tetikleyiciler

Apps Komut Dosyası tetikleyicileri, bir komut dosyası projesinin belirli koşullar karşılandığında (ör. e-tablo açıldığında veya eklenti yüklendiğinde) belirli bir işlevi yürütmesine olanak tanır.

E-Tablolar eklentileriyle hangi tetikleyicilerin kullanılabileceği ve bu tetikleyicilerin kullanımına ilişkin kısıtlamalar hakkında daha fazla bilgi için eklenti tetikleyicileri bölümüne bakın.

Özel işlevler

Google E-Tablolar'da, Google E-Tablosu hücresinden çağrılabilecek SUM ve AVERAGE gibi çeşitli yerleşik işlevler bulunur. E-Tablolar eklentileri, bu yerleşik işlevleri desteklemek için ek özel işlevler tanımlayabilir. Kullanıcılar eklentiyi yüklediğinde, eklentiye dahil edilen tüm tanımlanmış özel işlevler hemen kullanılabilir hale gelir. Bir eklenti yalnızca özel işlev tanımlarından oluşabilir. Özel işlev tanımları, öncelikle tanımları içeren bir eklenti yayınlanarak diğer kullanıcılarla paylaşılır.

Eklenti özel işlevleri oluşturma

Eklenti komut dosyası projesinde tanımlanan tüm işlevler özel işlev olarak kullanılabilir. İşlev uygulandıktan ve eklenti yüklendikten sonra özel işlevi diğer tüm yerleşik E-Tablolar işlevleri gibi çağırabilirsiniz: Bir E-Tablolar hücresine =, ardından işlevin adını ve gerekli parametreleri girin. Hata yoksa işlev tarafından döndürülen sonuç, E-tablo hücresine yerleştirilir ve gerektiğinde komşu hücrelere taşınır.

Eklentide özel işlevler oluştururken genel özel işlev yönergelerine uymanız gerekir:

Ayrıca, eklentilerde tanımlanan özel işlevler için bazı özel hususlar vardır:

  • İşlevinizi adlandırırken eklentinizin adıyla ilgili olabilir, benzersiz bir ad oluşturmaya çalışın. Yüklü iki veya daha fazla eklenti aynı ada sahip özel işlevler tanımlarsa kullanıcılar bunlardan yalnızca birini kullanabilir.
  • Eklentiniz, sağladığı özel işlevleri net bir şekilde açıklamalıdır. Apps Script'in kullanıcıya otomatik tamamlama bilgileri sunabilmesi için özel işlevleriniz için doğru JSDoc yorumları sağladığınızdan emin olun. Ayrıca, özel işlevlerle ilgili ek dokümanları eklentinin kendisinde veya eklenti destek web sayfasında sağlayabilirsiniz.
  • 30 saniyeden kısa sürede tamamlanmayan özel işlevler Internal error executing the custom function hatasıyla başarısız olur. Özel bir işlevde yaptığınız işlem miktarını sınırlayarak iyi bir kullanıcı deneyimi oluşturun. Mümkün olduğunda işlevi optimize edin.
  • Özel işlevler, yetkilendirme gerektiren Apps Komut Dosyası hizmetlerini kullanamaz ve bu işlem denendiğinde You do not have permission to call X service hatasıyla başarısız olur. Özel işlevinizde yalnızca izin verilen hizmetleri kullanın.
  • Bir e-tablodaki her özel işlev, Apps Script sunucularına ayrı bir çağrı gönderir. Kullanıcı çok fazla hücrede özel işlev kullanmaya çalışırsa işlevler yavaş çalışabilir. Bu sorunu azaltmak için özel işlevlerinizi mümkün olduğunca basit tutun. İşlevin karmaşık veya genişletilmiş işlemler gerçekleştirmesi gerekiyorsa özel işlev kullanmayın. Bunun yerine, bu işlevi bir menü öğesi, iletişim kutusu veya kenar çubuğu etkileşimi aracılığıyla sağlayın.

E-Tablolar makroları

Makrolar, Google E-Tablolar'da yapılan işlemleri kaydetmenize ve daha sonra klavye kısayoluyla tekrarlamanıza olanak tanır. Bir e-tabloda oluşturulan makro, ilgili e-tabloya bağlı bir Apps Komut Dosyası projesine makro işlevi olarak eklenir. Makrolar hakkında daha fazla bilgi için Google E-Tablolar makroları başlıklı makaleyi inceleyin.

Maalesef E-Tablolar makroları eklentilerle dağıtılamaz. Bir eklentinin manifest dosyasına makro tanımı eklerseniz bu makro, söz konusu eklentinin kullanıcıları tarafından kullanılamaz.