Bu belgede aşağıdaki terimler kullanılmıştır.
Takvim konferans eklentisi
Konferans sağlayıcıların Google Takvim etkinliklerinde konferans seçenekleri sunmasına olanak tanıyan özel bir eklenti türü. Bu eklentilerin bağlanması için iyi geliştirilmiş bir konferans görüşmesi çözümü gerekir. Bu şart nedeniyle çoğu geliştiricinin Takvim konferansı eklentisi oluşturması gerekmez.
Daha fazla bilgi için Takvim konferans eklentileri başlıklı makaleyi inceleyin. Ayrıca, Takvim konferans eklentisini Google Workspace eklentisine dönüştürme hakkında bilgi edinmek için Yayınlanmış eklentilerinizi yükseltme başlıklı makaleyi inceleyin.
Kart
Eklenti kullanıcı arayüzünün tek bir "sayfası". Kartlar, farklı widget nesnelerinden (düğmeler, metin alanları, başlıklar vb.) oluşur.
Daha fazla bilgi için Kartlar bölümüne bakın.
Kart tabanlı
Kullanıcı arayüzü kenar çubuğunda (veya mobil cihazlarda menüden erişilen başka bir etkinlik penceresi olarak) bir bölme şeklinde görünen eklentiler. Eklentinin üst kısmında, eklentiyi tanımlayan ve bir kart (temelde eklentinin kullanıcı arayüzünün bir "sayfası") gösteren bir araç çubuğu bulunur.
Google Workspace eklentileri kart tabanlıdır.
Konferans verileri
Google Takvim'in, kullanıcıların Google Workspace eklentisi veya Takvim konferans görüşmesi eklentisi tarafından etkinleştirilen üçüncü taraf konferansları oluşturmasına ve bu konferanslara katılmasına izin vermek için ihtiyaç duyduğu bilgiler.
Daha fazla bilgi için Konferans verileri başlıklı makaleyi inceleyin.
Konferans çözümü
Google Workspace eklentisi veya Takvim konferans eklentisi kullanılarak Google Takvim'den oluşturulabilen üçüncü taraf konferansının temsili.
Daha fazla bilgi için Konferans çözümleri bölümüne bakın.
Bağlam
Barındıran uygulamanın mevcut durumu. Örneğin, Gmail'de şu anda açık olan ileti, düzenlediğiniz Takvim etkinliği veya seçtiğiniz Drive dosyaları, ana uygulamanın mevcut bağlamının bir parçasıdır. Bağlam, diğer bilgilerle birlikte tetikleyici işleve parametre olarak iletilen bir etkinlik nesnesinde toplanır.
Bağlama dayalı tetikleme
Kullanıcı belirli bir bağlama girdiğinde (ör. Gmail'de bir e-posta yazışmasını açtığında) tetiklenen tetikleyicileri tanımlama uygulaması. Bağlama dayalı tetikleme, eklentinizin bağlamla alakalı bir kullanıcı arayüzü sağlamasına olanak tanır. Bağlamsal tetikleyiciler, eklenti komut dosyası projesinin manifestinde yapılandırılır ve bu nedenle bir manifest tetikleyicisi türüdür.
Düzenleyici eklentileri
Yalnızca Google Dokümanlar, E-Tablolar, Formlar veya Slaytlar uzantılarına izin veren orijinal eklenti türleri. Düzenleyici eklentileri kart tabanlı değildir. Bunun yerine, geliştiricinin ham HTML ve CSS'den bir kullanıcı arayüzü oluşturmasını gerektirir. Her düzenleyici eklentisi yalnızca bir ana makine uygulamasını genişletebilir.
Daha fazla bilgi için Düzenleyici eklentileri başlıklı makaleyi inceleyin.
Etkinlik nesnesi
Ana sayfalar istendiğinde, eklenti yanıt vermesi gereken bağlamlara girdiğinde veya kullanıcıların eklenti arayüzündeki widget'larla etkileşimleri sonucunda otomatik olarak oluşturulan JSON nesnesi. Oluşturulduktan sonra etkinlik nesneleri, belirtilen bir tetikleyici işlevine veya geri çağırma işlevine aktarılır. Etkinlik nesnelerinin amacı, kullanıcının istemci tarafı ortamındaki bilgileri (ör. eklenti arayüzü widget'larına girilen bilgiler) eklentinin sunucu tarafı koduna aktarmaktır. Bu kod daha sonra bu bilgiler üzerinde işlem yapabilir ve uygun yanıtı döndürebilir.
Daha fazla bilgi için Etkinlik nesneleri başlıklı makaleyi inceleyin.
Gmail eklentileri
Yalnızca Gmail'i genişleten bir eklenti. Gmail eklentileri kart tabanlıdır. Gmail eklentileri oluşturmak için kullanılan işlevlerin, davranışların ve geliştirme ayrıntılarının çoğu, Google Workspace eklentileri oluşturmak için kullanılan ayrıntılarla aynıdır.
Daha fazla bilgi için Gmail eklentileri başlıklı makaleyi inceleyin. Gmail eklentilerini Google Workspace eklentilerine dönüştürme hakkında bilgi edinmek için Yayınlanmış eklentilerinizi yükseltme başlıklı makaleyi de inceleyin.
Ana sayfa
Bir eklentinin kök kullanıcı arayüzü kartı. Kullanıcılar eklentiyi açtığında ana sayfalar gösterilir ve eklentinizin belirli bir bağlamın dışındaki içerikleri göstermesine olanak tanır (örneğin, kullanıcı Gmail'de e-posta yazışmalarını görüntülerken ancak birini açmamışsa). Eklenti ana sayfanızın görünümünü ve davranışını diğer kartlar gibi tanımlarsınız.
Daha fazla bilgi için Ana Sayfalar'a bakın.
Ana makine veya ana makine uygulaması
Google Workspace eklentisinin genişlettiği Google Workspace uygulaması (ör. Gmail veya Google Takvim).
HTML tabanlı
Kullanıcı arayüzü, Apps Komut Dosyası'nın yerleşik Card hizmeti yerine HTML ve CSS kullanılarak tanımlanan bir eklenti. Yalnızca eski Editor eklentileri HTML tabanlıdır.
Bağlantı önizlemesi tetikleyicisi
Bağlantı önizleme tetikleyicileri, kullanıcılar Google Dokümanlar gibi bir Google ana makine uygulamasında üçüncü taraf veya Google dışı bir URL ile etkileşime girdiğinde etkinleşir. Bağlantı önizleme tetikleme özelliği, hizmetinizden veya API'nizden önizlenecek URL kalıplarını tanımlamanıza ve akıllı çip ile önizleme kartı da dahil olmak üzere önizleme içeriğini yapılandırmanıza olanak tanır. Bağlantı önizleme tetikleyicileri, eklenti komut dosyası projesinin manifestinde yapılandırılır ve bu nedenle bir manifest tetikleyicisi türüdür.
Daha fazla bilgi için Akıllı çipleri kullanarak bağlantıları önizleme başlıklı makaleyi inceleyin.
Manifest
Bir Apps Komut Dosyası projesine eklenmiş bir JSON dosyası. Manifest, komut dosyasının doğru şekilde çalışması için gereken proje bilgilerini tanımlamak amacıyla kullanılır. Google Workspace eklentilerinde, eklentinin hangi ana bilgisayarlara genişletilebileceğini ve belirli kullanıcı arayüzü kontrol ayarlarını sağlamak için manifest kullanılır.
Manifest tetikleyici
Bir projenin manifest dosyasında tanımlanan tetikleyici (ör. ana sayfa tetikleyicisi veya bağlamsal tetikleyici). Manifest tetikleyicileri yalnızca bir eklenti ana sayfası istendiğinde veya eklenti, görüntüleme güncellemesi gerektiren bir bağlama girdiğinde yeni kartlar oluşturmak ve görüntülemek için kullanılır.
Manifest tetikleyicileri, yerleşik olmadıkları (basit tetikleyiciler gibi) ve Apps Komut Dosyası Script hizmeti ile programatik olarak oluşturulamadıkları (yüklenebilir tetikleyiciler gibi) için Apps Komut Dosyası'ndaki diğer tetikleyicilerden farklıdır.
İçeriğe dayalı olmayan kartlar
Kullanıcı belirli bir bağlamın dışındayken içerik gösteren kartlar (ör. Gmail'de e-posta yazışmalarını görüntülerken ancak birini açmamışsa). Ana sayfalar, bağlam dışı kart türüdür.
Kenar çubuğu
Bir Google Workspace eklentisinin kullanıcı arayüzünün göründüğü, ana makine kullanıcı arayüzünün sağ tarafındaki bölüm. Gmail ve Editor eklentileri de kenar çubukları tanımlayabilir.
Akıllı çip
Akıllı çip, Google Workspace uygulamasında bir kişiden, dosyadan, takvim etkinliğinden veya başka bir öğeden bahsetmektir. Kullanıcılar, fareyle bir çipin üzerine geldiğinde dosya veya bağlantıyla ilgili ek içerikleri de önizleyebilir. Örneğin, kullanıcılar fare imlecini Google Slaytlar sunusunun çipinin üzerine getirdiğinde slaytın ekran görüntüsünü, sununun sahibini ve sunuyu daha önce görüntüleyip görüntülemediklerini görür.
Eklentinizi, üçüncü taraf veya Google dışı bir hizmetin bağlantılarını önizlemek için akıllı çipleri kullanacak şekilde yapılandırabilirsiniz. Google Dokümanlar'da bağlantıları önizleme başlıklı makaleye göz atın.
Tetikleyici
Bir Apps Komut Dosyası projesi veya eklentisi tarafından tanımlanan koşul ve otomatik etkinlik yanıtı. Tetikleyiciler, ilişkili etkinlikleri gerçekleştiğinde (ör. bir eklenti açıldığında) etkinleşir ve belirtilen Apps Komut Dosyası işlevinin (tetikleyici işlevi) otomatik olarak yürütülmesine neden olur. Google Workspace eklentilerinde tetikleyici işlevler, eklenti kullanıcı arayüzünün hangi bölümünün görüntüleneceğini kontrol etmek için genellikle yeni kartlar oluşturur. Yalnızca belirli etkinlik türlerinde tetikleyiciler olabilir.
Daha fazla bilgi için eklenti tetikleyicileri başlıklı makaleyi inceleyin.
Tetikleyici işlevi
Bir projede, tetikleyici etkinleştirildiğinde yürütülen Apps Komut Dosyası işlevi.
Widget
Düğme, metin alanı veya onay kutusu gibi bir kullanıcı arayüzü öğesi. Kartlar, Apps Komut Dosyası'nın yerleşik Card hizmeti tarafından tanımlanan bir dizi widget nesnesinden oluşturulur.
Daha fazla bilgi için Widget'lar bölümüne bakın.
Widget işleyici işlevi
Belirli bir widget'ı belirli bir işlem nesnesine bağlayan bir işlevdir. Her widget türünün, işlemlere bağlanmak için kullanabileceği bir dizi tanımlı widget işleyici işlevi vardır. Widget işleyici işlevleri, hangi tür kullanıcı etkileşiminin sonuçlanan işlemi tetiklediğini tanımlar ve widget etkileşiminin önemli bir bileşenidir.
Daha fazla bilgi için Widget işleyici işlevleri başlıklı makaleyi inceleyin.