Sözlük

Bu belgede aşağıdaki terimler kullanılmıştır.

Takvim konferans eklentisi

Konferans sağlayıcılarının Google Takvim etkinliklerinde konferans seçenekleri sunmasına olanak tanıyan özel bir eklenti türü. Bu eklentiler, eklentinin bağlanabilmesi için iyi geliştirilmiş bir konferans çözümü gerektirir. Bu gereksinim nedeniyle çoğu geliştiricinin bir Takvim konferans eklentisi oluşturmasına gerek yoktur.

Daha fazla bilgi için Takvim konferansı eklentileri başlıklı makaleye bakın. Bir Takvim konferans eklentisini Google Workspace Eklentisine dönüştürme hakkında bilgi edinmek için Yayınlanan eklentilerinizi yeni sürüme geçirme başlıklı makaleyi de inceleyin.

Kart

Bir 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ünü inceleyin.

Karta dayalı

Kullanıcı arayüzü kenar çubuğunda bölme olarak (veya mobil cihazlarda menüden erişilen başka bir etkinlik penceresi olarak) görünen eklenti. Eklentinin, eklentiyi tanımlayan bir üst araç çubuğu vardır ve bir kart (aslında eklentinin kullanıcı arayüzünün bir "sayfası") görüntülenir.

Google Workspace Eklentileri kart tabanlıdır.

Konferans verileri

Kullanıcıların bir Google Workspace eklentisi veya Takvim konferans eklentisi tarafından etkinleştirilen üçüncü taraf konferansları oluşturmasına ve bu konferanslara katılmasına izin vermek için Google Takvim'in ihtiyaç duyduğu bilgi grubudur.

Daha fazla bilgi için Konferans verileri bölümüne bakın.

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.

İçerik

Ana makine uygulamasının mevcut durumu. Örneğin, şu anda Gmail'de açık olan mesaj, düzenlediğiniz Takvim etkinliği veya seçtiğiniz Drive dosyaları, ana makine uygulamasının mevcut bağlamının bir parçasıdır. Diğer bilgilerle birlikte bağlam, tetikleyici işlevine parametre olarak aktarılan bir etkinlik nesnesinde toplanır.

Bağlamsal tetikleme

Kullanıcılar belirli bir bağlam girdiğinde (ör. Gmail'de bir e-posta ileti dizisini açtığında) tetiklenen tetikleyiciler tanımlama uygulaması. İçeriğe dayalı tetikleme, eklentinizin söz konusu bağlamla ilgili bir kullanıcı arayüzü sağlamasına olanak tanır. Bağlamsal tetikleyiciler, eklenti komut dosyası projesinin manifest dosyasında yapılandırılır ve bu nedenle bir tür manifest tetikleyicisidir.

Düzenleyici Eklentileri

Yalnızca Google Dokümanlar, E-Tablolar, Formlar veya Slaytlar'ın uzantılarına izin veren orijinal eklenti türleri grubu. Düzenleyici eklentileri kart tabanlı değildir. Daha ziyade, geliştiricinin ham HTML ve CSS'den bir kullanıcı arayüzü oluşturmasını gerektirirler. Her düzenleyici eklentisi yalnızca bir ana makine uygulamasını genişletebilir.

Daha fazla ayrıntı için Düzenleyici Eklentileri bölümüne bakın.

Etkinlik nesnesi

Ana sayfalar istendiğinde, eklenti yanıt vermesi gereken bağlamları girdiğinde veya kullanıcıların eklenti arayüzündeki widget'larla kurduğu etkileşimler sonucunda otomatik olarak oluşturulan JSON nesnesidir. Etkinlik nesneleri oluşturulduktan sonra belirli bir tetikleyici işlevine veya geri çağırma işlevine aktarılır. Etkinlik nesnelerinin amacı, kullanıcının istemci tarafı ortamından (eklenti arayüzü widget'larına girdikleri bilgiler gibi) eklentinin sunucu tarafı koduna bilgi iletmektir. Bunlar daha sonra bu bilgilere göre hareket edip uygun yanıtı döndürebilir.

Daha fazla bilgi için Etkinlik nesneleri bölümüne bakın.

Gmail eklentileri

Yalnızca Gmail'i kapsayan bir eklentidir. Gmail eklentileri kart tabanlıdır. Gmail eklentilerini oluşturmak için kullanılan işlev, davranış 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 edinmek için Gmail eklentileri sayfasına göz atın. Gmail eklentilerini Google Workspace Eklentisine dönüştürme hakkında bilgi için Yayınlanan eklentilerinizi yeni sürüme geçirme başlıklı makaleyi de inceleyin.

Ana sayfa

Bir eklentinin kök kullanıcı arayüzü kartı. Ana sayfalar, kullanıcılar eklentiyi açtığında ve eklentinizin belirli bir bağlamın dışında içerik göstermesine izin verdiğinde görüntülenir (örneğin, kullanıcı Gmail'de e-posta ileti dizilerini Gmail'de görüntülediğinde, ancak açmadığında). 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 sayfalara bakın.

Ana makine veya Ana makine uygulaması

Bir Google Workspace eklentisi olan Google Workspace uygulamasını (ör. Gmail veya Google Takvim) genişletir.

HTML tabanlı

Kullanıcı arayüzü, Apps Komut Dosyası'ndaki yerleşik Kart hizmeti yerine HTML ve CSS kullanılarak tanımlanan eklentidir. Yalnızca eski Düzenleyici Eklentileri HTML tabanlıdır.

Kullanıcılar Google Dokümanlar gibi bir Google ana makine uygulamasında üçüncü taraf veya Google dışı bir URL ile etkileşimde bulunduğunda bağlantı önizleme tetikleyicileri etkinleşir. Bağlantı önizleme tetikleyicisi, hizmetinizden veya API'nizden önizlenecek URL kalıpları tanımlamanıza ve akıllı çip ile önizleme kartı dahil olmak üzere önizleme içeriğini yapılandırmanıza olanak tanır. Bağlantı önizleme tetikleyicileri, eklenti komut dosyası projesinin manifest dosyasında yapılandırılır ve bu nedenle bir tür manifest tetikleyicisidir.

Daha fazla bilgi için Google Dokümanlar'da bağlantıları önizleme bölümüne bakın.

Manifest

Apps Komut Dosyası projesine ekli bir JSON dosyası. Manifest, komut dosyasının doğru çalışması için gereken proje bilgilerini tanımlamak amacıyla kullanılır. Google Workspace eklentilerinde, manifest dosyası, eklentinin hangi ana makineleri genişletebileceğini belirtmek ve belirli kullanıcı arayüzü kontrol ayarlarını sağlamak için kullanılır.

Manifest tetikleyicisi

Ana sayfa tetikleyicisi veya bağlamsal tetikleyici gibi projenin manifest dosyasında tanımlanan bir tetikleyici. Manifest tetikleyicileri, yalnızca bir eklenti ana sayfası istendiğinde veya eklenti, görüntü güncellemesi gerektiren bir bağlam girdiğinde yeni kartlar oluşturmak ve görüntülemek için kullanılır.

Manifest tetikleyicileri yerleşik olmadıklarından (basit tetikleyiciler gibi) ve Apps Komut Dosyası Komut Dosyası hizmetiyle (yüklenebilir tetikleyiciler gibi) programatik olarak oluşturulamadığından, Apps Komut Dosyası'ndaki diğer tetikleyicilerden farklıdır.

İçeriğe dayalı olmayan kartlar

Kullanıcı belirli bir bağlamın dışında olduğunda (örneğin, Gmail'de kullanıcının e-posta ileti dizilerini görüntülediğinde, ancak ileti dizisi açmadığında) içerik gösteren kartlar. Ana sayfalar, bağlamsal olmayan bir kart türüdür.

Ana makine kullanıcı arayüzünün sağ tarafında, Google Workspace Eklentisi'nin kullanıcı arayüzünün göründüğü bölüm. Gmail ve Düzenleyici Eklentileri de kenar çubukları tanımlayabilir.

Akıllı çip

Akıllı çip, bir Google Workspace uygulamasında bir kişiden, dosyadan, takvim etkinliğinden veya başka bir varlıktan bahsedilmesidir. Kullanıcılar fareyle bir çipin üzerine geldiğinde dosya veya bağlantıyla ilgili ek içeriği de önizleyebilir. Örneğin kullanıcılar, fareyle bir çipin üzerine gelerek Google Slaytlar sunusunun üzerine geldiğinde bir slaydın ekran görüntüsünü, sununun sahibini ve sunuyu daha önce görüntüleyip görüntülemediklerini görürler.

Eklentinizi, üçüncü taraf veya Google dışı bir hizmetin bağlantılarını önizlemek için akıllı çipler kullanacak şekilde yapılandırabilirsiniz. Google Dokümanlar'da bağlantıları önizleme bölümüne bakın.

Tetikleyici

Bir Apps Komut Dosyası projesi veya eklentisi tarafından tanımlanan bir koşul ve otomatik etkinlik yanıtıdır. Tetikleyiciler, ilişkili etkinlikleri gerçekleştiğinde (örneğin, bir eklenti açıldığında) etkinleşir ve belirtilen bir Apps Komut Dosyası işlevinin (tetikleyici işlevi) otomatik olarak yürütülmesine neden olur. Google Workspace eklentilerinde, tetikleyici işlevleri genellikle eklenti kullanıcı arayüzünün hangi bölümünün görüntüleneceğini kontrol etmek için yeni Kartlar oluşturur. Yalnızca belirli etkinlik türlerinde tetikleyici olabilir.

Daha fazla bilgi için eklenti tetikleyicilerine bakın.

Tetikleyici işlevi

Bir projede, tetiklenen tetikleyiciye yanıt olarak 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ı'ndaki yerleşik Kart 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 eylem nesnesine bağlayan işlev. Her widget türü, eylemlere bağlanmak için kullanabileceği bir dizi tanımlanmış widget işleyici işlevine sahiptir. Widget işleyici işlevleri, sonuçta ortaya çıkan işlemi ne tür bir kullanıcı etkileşiminin tetiklediğini tanımlar ve widget etkileşiminin çok önemli bir bileşenidir.

Daha fazla bilgi için Widget işleyici işlevleri bölümüne bakın.