Sözlük

Bu dokümanda aşağıdaki terimler kullanılmaktadır.

Takvim konferans görüşmesi eklentisi

Konferans sağlayıcıların Google Takvim etkinliklerinde konferans seçenekleri sunmasına olanak tanımak için kullanılan özel bir eklenti türü. Bu eklentilerin bağlanabilmesi 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. Takvim konferans eklentisini 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

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 bir panel olarak görünen (veya mobil cihazlarda menüden erişilen başka bir etkinlik penceresi olarak görünen) bir eklenti. Eklentinin üst kısmında, eklentiyi tanımlayan ve bir kart (temel olarak eklentinin kullanıcı arayüzünün bir "sayfası") gösteren bir araç çubuğu bulunur.

Google Workspace eklentileri kart tabanlı olduğundan

Konferans verileri

Kullanıcıların Google Workspace eklentisi veya Takvim konferans görüşmesi eklentisi tarafından etkinleştirilen üçüncü taraf konferansları oluşturup bunlara katılmasına izin vermek için Google Takvim'in ihtiyaç duyduğu bilgi grubu.

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

Konferans çözümü

Google Workspace eklentisi veya Takvim konferans görüşmesi eklentisi kullanılarak Google Takvim'den oluşturulabilen üçüncü taraf konferansın temsili.

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

Bağlam

Barındırıcı 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ı, barındıran uygulamanın mevcut bağlamının bir parçasıdır. Bağlam, diğer bilgilerle birlikte bir etkinlik nesnesine toplanır ve tetikleyici işlevine parametre olarak iletilir.

Bağlama dayalı tetikleme

Kullanıcı belirli bir bağlama girdiğinde (ör. Gmail'de bir e-posta ileti dizisini açtığında) tetiklenen tetikleyicileri tanımlama işlemi. Bağlama dayalı tetikleme, eklentinizin bağlamla alakalı bir kullanıcı arayüzü sunmasına olanak tanır. Bağlamsal tetikleyiciler, eklenti komut dosyası projesinin manifest dosyasında yapılandırılır ve bu nedenle manifest tetikleyicisi türündedir.

Düzenleyici eklentileri

Yalnızca Google Dokümanlar, E-Tablolar, Formlar veya Slaytlar uzantılarına izin veren orijinal eklenti türü grubu. 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ıtlaması gereken bağlamlara girdiğinde veya kullanıcının eklenti arayüzündeki widget'larla etkileşimi sonucunda otomatik olarak oluşturulan JSON nesnesi. Oluşturulan 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ından (ör. eklenti arayüzü widget'larına girdikleri bilgiler) eklentinin sunucu tarafı koduna bilgi aktarmaktır. Bu kod, daha sonra bu bilgilere göre işlem yapabilir ve 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 genişleten bir eklenti. Gmail eklentileri kart tabanlı olduğundan Gmail eklentileri oluşturmak için kullanılan işlevsellik, 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 için Gmail eklentileri başlıklı makaleyi inceleyin. Gmail eklentilerinin Google Workspace eklentilerine dönüştürülmesi 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 ve eklentinizin belirli bir bağlamın dışında içerik göstermesine izin verdiğinde (örneğin, kullanıcı Gmail'de e-posta ileti dizilerini görüntülerken ancak bir ileti dizisi açmamışken) gösterilir. 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 başlıklı makaleyi inceleyin.

Barındırıcı veya barındırıcı uygulaması

Google Workspace eklentisinin genişlettiği Google Workspace uygulaması (ör. Gmail veya Google Takvim).

HTML tabanlı

Kullanıcı arayüzü, Apps Script'in yerleşik Kart Hizmeti yerine HTML ve CSS kullanılarak tanımlanan bir eklenti. Yalnızca eski Düzenleyici eklentileri HTML tabanlı.

Bağlantı önizlemesi, kullanıcılar Google Dokümanlar gibi bir Google ana uygulama içinde üçüncü taraf veya Google dışı bir URL ile etkileşime geçtiğinde tetiklenir. Bağlantı önizlemesini tetikleme, 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 manifest dosyasında yapılandırılır ve 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

Apps Komut Dosyası projesine eklenen bir JSON dosyası. Manifest, komut dosyasının düzgün şekilde çalışması için gereken proje bilgilerini tanımlamak için 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 bağlama dayalı tetikleyici). Manifest tetikleyicileri, yalnızca bir eklenti ana sayfası istendiğinde veya eklenti, ekran 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 Script komut dosyası hizmeti ile programatik olarak oluşturulamadıkları (yüklenebilir tetikleyiciler gibi) için Apps Script'teki 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 ileti dizilerini görüntülerken ancak bir ileti dizisi açmamışken). Ana sayfalar, bağlam dışı bir kart türüdür.

Barındırıcı kullanıcı arayüzünün sağ tarafında, Google Workspace eklentisinin 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, Google Workspace uygulamasında bir kişi, dosya, takvim etkinliği veya başka bir öğeye yapılan referanstır. 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 Google Slaytlar sunumunun çipinin üzerine geldiğinde slaytın ekran görüntüsünü, sunumun sahibini ve sunumu 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ı çipleri kullanacak şekilde yapılandırabilirsiniz. Google Dokümanlar'da bağlantıları önizleme başlıklı makaleyi inceleyin.

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) tetiklenir ve belirtilen bir Apps Script 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österileceğini kontrol etmek için genellikle yeni kartlar oluşturur. Yalnızca belirli etkinlik türleri tetikleyiciye sahip olabilir.

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

Tetikleyici işlevi

Bir projede, tetikleyicinin etkinleştirilmesine yanıt olarak yürütülen bir Apps Komut Dosyası işlevi.

Widget

Düğme, metin alanı veya onay kutusu gibi bir kullanıcı arayüzü öğesi. Kartlar, Apps Script'in yerleşik kart hizmeti tarafından tanımlanan bir widget nesnesi dizisinden 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 tanımlanmış bir widget işleyici işlevi grubu vardır. Widget işleyici işlevleri, ortaya çıkan işlemin ne tür bir kullanıcı etkileşimiyle tetiklendiğ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.