Sözlük

Bu dokümanın tamamı boyunca aşağıdaki terimler kullanılmaktadır.

Takvim konferansı eklentisi

Konferans sağlayıcılarının, Google Takvim etkinliklerinde konferans seçenekleri sunmasına izin vermek için kullanılan özel bir eklenti türüdür. Bu eklentilerin bağlanabilmesi için iyi geliştirilmiş bir konferans çözümü gerekir. Bu gereksinimden dolayı, çoğu geliştirici hiçbir zaman Takvim konferans eklentisi oluşturmaya ihtiyaç duymaz.

Daha fazla bilgi için Takvim konferans eklentileri başlıklı makaleyi inceleyin. Ayrıca Takvim konferansı eklentilerini bir Google Workspace eklentisine dönüştürme hakkında bilgi edinmek için Yayınlanan eklentilerinizi yükseltme 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 başlıklı makaleyi inceleyin.

Karta dayalı

Kullanıcı arayüzü, kenar çubuğundaki bir bölme olarak (veya mobil cihazda, menüden erişilen başka bir etkinlik penceresi olarak) görünen bir eklenti. Eklentiyi tanımlayan ve aslında eklentinin kullanıcı arayüzünün "sayfası" olan bir kart gösteren bir üst araç çubuğu bulunur.

Google Workspace eklentileri kart tabanlıdır.

Konferans verileri

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

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 temsili.

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

Bağlam

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

Bağlamsal tetikleme

Kullanıcı belirli bir bağlam girdiğinde (ör. Gmail'de bir e-posta ileti dizisi açtığında) tetiklenen tetikleyicileri tanımlama. Bağlamsal tetikleme, eklentinizin bu bağlamla alakalı 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. Bu nedenle, bir manifest tetikleyicisi türüdür.

Düzenleyici Eklentileri

Yalnızca Google Dokümanlar, E-Tablolar, Formlar veya Slaytlar'daki uzantılara izin veren orijinal eklenti türleri grubu. Düzenleyici eklentileri kart tabanlı değildir. Bu eklentiler, geliştiricinin ham HTML ve CSS'den 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'ne göz atın.

Etkinlik nesnesi

Ana sayfalar istendiğinde, eklenti yanıt vermesi gereken bağlamları girdiğinde veya eklenti arayüzündeki widget'larla kullanıcı etkileşimlerinin sonucu olarak otomatik olarak oluşturulan JSON nesnesi. Oluşturulduktan sonra etkinlik nesneleri, belirtilen bir tetikleyici işlevine veya geri çağırma işlevine iletilir. Etkinlik nesnelerinin amacı, kullanıcının istemci tarafı ortamından (eklenti arayüzü widget'larına girdikleri bilgiler gibi) bilgileri eklentinin sunucu tarafı koduna geçirmektir. Bu kod daha sonra bu bilgiler doğrultusunda işlem yapabilir ve uygun yanıtı döndürebilir.

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

Gmail eklentileri

Yalnızca Gmail'i destekleyen bir eklenti. 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 eklentilerini oluşturmak için kullanılan ayrıntılarla aynıdır.

Daha fazla bilgi için Gmail eklentilerine göz atın. Ayrıca Gmail eklentilerini Google Workspace Eklentilerine dönüştürme hakkında bilgi edinmek için Yayınlanan eklentilerinizi yükseltme 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 gösterilir ve eklentinizin belirli bir bağlamın dışında içerik göstermesine izin verir (örneğin, kullanıcı Gmail'de e-posta ileti dizilerini görüntülüyorsa ancak hiç ileti dizisi açmadığında). Eklenti ana sayfanızın görünümünü ve davranışını diğer kartlar gibi siz tanımlarsınız.

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

Ana makine veya ana makine uygulaması

Gmail veya Google Takvim gibi bir Google Workspace eklentisi olan Google Workspace uygulaması,

HTML tabanlı

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

Kullanıcılar Google Dokümanlar gibi bir Google barındırma uygulamasında üçüncü taraf veya Google olmayan bir URL ile etkileşimde bulunduğunda bağlantı önizleme tetikleyicileri tetiklenir. Bağlantı önizleme tetiklemesi, hizmetiniz veya API'nizden önizleme yapmak için URL kalıpları tanımlamanıza ve akıllı çip ile önizleme kartı dahil ö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. Bu nedenle, bir tür manifest tetikleyicisidir.

Daha fazla bilgi için Akıllı çiplerle bağlantıları önizleme bölümüne bakın.

Manifest

Bir Apps Komut Dosyası projesine ekli 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, 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

Projenin manifest dosyasında tanımlanan bir tetikleyici (ör. ana sayfa tetikleyicisi veya içeriğe dayalı tetikleyici). Manifest tetikleyicileri, bir eklenti ana sayfası istendiğinde veya eklenti, ekran güncellemesi gerektiren bir bağlam girdiğinde yeni kartlar oluşturmak ve görüntülemek için özel olarak kullanılır.

Manifest tetikleyicileri, yerleşik olmadıklarından (basit tetikleyiciler gibi) ve Apps Komut Dosyası Komut Dosyası hizmetiyle (ör. yüklenebilir tetikleyiciler) 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ışındayken içerik gösteren kartlar; örneğin, Gmail'de e-posta ileti dizilerini görüntülerken ancak e-posta açmamış olduğunda. Ana sayfalar, bir tür bağlam bilgisi olmayan karttır.

Ana makine kullanıcı arayüzünün sağ tarafında, Google Workspace eklentisi 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ındaki bir kişiden, dosyadan, takvim etkinliğinden veya başka bir varlıktan bahsedilmesidir. Kullanıcılar bir çipin üzerine geldiklerinde dosya veya bağlantıyla ilgili ek içerikleri de önizleyebilir. Örneğin, kullanıcılar bir Google Slaytlar sunusunun üzerine fareyle geldiklerinde bir slaytı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ünü inceleyin.

Tetikleyici

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

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

Tetikleme işlevi

Bir tetikleyicinin etkinleşmesine yanıt olarak yürütülen bir projedeki 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 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 işlem nesnesine bağlayan işlev. Her widget türünün, işlemlere bağlanmak için kullanabileceği bir dizi tanımlanmış widget işleyici işlevi vardır. Widget işleyici işlevleri ne tür kullanıcı etkileşiminin sonuç işlemini tetiklediğini tanımlar ve widget etkileşiminin önemli bir bileşenidir.

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