Google Workspace Eklentileri, kullanıcı takvimleri ve Takvim etkinliklerini görüntülerken ya da düzenlerken özelleştirilmiş arayüzler sağlayabilir. Bu, kullanıcıya alakalı ek bilgiler sağlamanıza, görevleri otomatikleştirmenize ve Google Takvim'e üçüncü taraf sistemleri bağlamanıza olanak tanır.
Google Takvim için eklenti arayüzü oluştururken bir ana sayfa sağlayabilirsiniz. Aynı ana sayfayı birden fazla ana makine için kullanabilir veya Google Takvim için özel bir ana sayfa tasarlayabilirsiniz.
Eklentiniz, kullanıcı bir Takvim etkinliği açıkken görünecek bir arayüz de tanımlayabilir.
Eklenti kullanıcı arayüzüne erişme
Açılma şekline bağlı olarak bir Google Workspace eklentisi; bir ana sayfa arayüzü, Google Takvim etkinlik arayüzü, bir ek seçme arayüzü veya aşağıdaki üçünü birden tanımlayabilir:
- Kullanıcı, takvim görünümündeyken eklenti simgesini tıklarsa eklenti, ilgili
calendar.homepageTriggerişlevini (varsa) yürütür. Bu işlev, görüntülenmek üzere bir ana sayfa kartı oluşturur ve Takvim'e döndürür. Herhangi bir
calendar.homepageTriggerişlevi tanımlanmazsa bunun yerine genel bir ana sayfa kartı gösterilir.
- Kullanıcı bir Takvim etkinliğini açar ve ardından eklenti simgesini tıklarsa veya kullanıcı bir etkinliği açtığında eklenti açıksa, eklenti ilgili
eventOpenTriggerişlevini (varsa) çalıştırır. Bu işlev, eklentinin Takvim etkinlik arayüzünü oluşturur ve görüntülenmek üzere Google Takvim'e geri döner.
- Eklenti bir
eventAttachmentTriggerişlevi tanımlarsa kullanıcı, bir Takvim etkinliğini düzenlerken Ek ekle'yi tıkladığında eklenti bir ek sağlayıcı olarak görünür. Eklenti seçildiğinde
eventAttachmentTriggerişlevi, eklentinin ek seçme arayüzünü oluşturur ve görüntülenmek üzere Google Takvim'e döndürür.
Eklenti Takvim arayüzü oluşturma
Aşağıdaki adımları uygulayarak Google Takvim'in süresini bir Google Workspace eklentisiyle genişletebilirsiniz:
- Eklentinizin Takvim'e özel bir ana sayfaya sahip olmasını isteyip istemediğinize karar verin. Ayrıca, kullanıcı Takvim etkinliklerini düzenlerken özel bir arayüz sağlamak isteyip istemediğinize karar verin.
- Gerekli kapsamlar da dahil olmak üzere, eklenti komut dosyası projesi manifest'e uygun
addOns.commonve
addOns.calendaralanlarını ekleyin.
- Takvim'e özel bir ana sayfa sağlıyorsanız bu arayüzü oluşturmak için
calendar.homepageTriggerişlevini uygulayın.
common.homepageTriggerarayüzünü birden fazla Google Workspace ana makinesi için de kullanabilirsiniz.
- Takvim etkinliği arayüzü sağlıyorsanız bu arayüzü oluşturmak için bir
calendar.eventOpenTriggerişlevi uygulamanız gerekir. Ayrıntılar için Takvim etkinlik arayüzünü genişletme bölümüne bakın.
- Kullanıcının kullanıcı arayüzü etkileşimlerine (ör. düğme tıklamaları) yanıt vermek için gereken ilişkili geri çağırma işlevlerini uygulayın.
Takvim ana sayfaları
Google Takvim, Google Workspace eklentisi ana sayfalarının gösterilmesini destekler.
Eklentinizin ortak ana sayfasını Google Takvim'de göstermek için eklentinin manifest dosyasında bir
addOns.calendar alanı bulunduğundan emin olun.
Alternatif olarak, Takvim'e özel bir ana sayfa sağlamak için eklenti manifest dosyasına bir
calendar.homepageTrigger ekleyin.
Her iki durumda da eklentinizin komut dosyası projesinde bir ana sayfa tetikleyici işlevinin adını sağlamanız gerekir. Bu işlev, gerektiğinde Google Takvim ana sayfasını oluşturmak için otomatik olarak çağrılır. Ana sayfayı oluşturan tek bir
Card veya
Card nesne dizisi oluşturup döndürmek için bu işlevi uygulamanız gerekir. Ana sayfa tetikleyici işlevi, istemcinin platformu gibi bazı genel bilgileri içeren bir parametre olarak bir etkinlik nesnesine aktarılır. Etkinlik nesnesi verilerini, ana sayfanın yapısını özelleştirmek için kullanabilirsiniz.
Takvim etkinlik arayüzünü genişletme
Google Takvim, kullanıcı bir Takvim etkinliğini düzenlediğinde gösterilecek arayüzü (varsa) belirlemek için bağlamsal bir tetikleyiciden yararlanır. Tetikleyici etkinleştiğinde, eklenti manifest dosyasındaki
calendar.eventOpenTrigger alanında belirtilen bağlamsal tetikleyici işlevini yürütür.
calendar.eventOpenTrigger alanında adlandırılmış işlevi uygulamanız gerekir. Bu işlev, bir etkinlik nesnesini bağımsız değişken olarak kabul eder ve kullanıcı etkinlik açıkken Takvim'in görüntülemesi için tek bir
Card nesnesi veya
Card nesne dizisi döndürmelidir.
Etkinlik nesneleri
Bir kullanıcı Takvim etkinliğini açtığında, bir etkinlik nesnesi oluşturulur ve
calendar.eventOpenTrigger içeriğe dayalı tetikleyici işlevine iletilir. Tetikleyici işlevi, eklenti kartlarının nasıl oluşturulacağını veya eklenti davranışının nasıl kontrol edileceğini belirlemek için bu etkinlik nesnesindeki bilgileri kullanabilir. Bir eklenti ilk kez açıldığında ve kullanıcı etkileşimli widget'ları tıkladığında veya seçtiğinde de etkinlik nesneleri oluşturulur ve
homepageTrigger işlevlerine aktarılır.
Etkinlik nesnelerinin tam yapısı Etkinlik nesneleri bölümünde açıklanmıştır. Takvim, eklentinin vekil ana makine uygulaması olduğunda, bağlamsal tetikleyici ve widget etkileşim etkinliği nesneleri Takvim'e özel istemci bilgilerini içeren Takvim etkinliği nesnesi alanını içerir.
Takvim etkinliklerini güncelleme
Bir kullanıcı düzenleme amacıyla bir Takvim etkinliğini açtığında tetiklenen içeriğe
calendar.eventOpenTrigger ek olarak, kullanıcı bir Takvim etkinliğini güncelleyip kaydettiğinde tetiklenen bir
calendar.eventUpdateTrigger da tanımlayabilirsiniz. Bu tetikleyici yalnızca kullanıcı aşağıdaki düzenlemelerden birini veya daha fazlasını yaparsa etkinleşir:
- Bir veya daha fazla katılımcı ekler.
- Bir veya daha fazla katılımcıyı çıkarır.
- Farklı bir konferans çözümü ekler veya çözüme geçer.
Bu tetikleyici etkinleştiğinde,
calendar.eventUpdateTrigger manifest alanında belirtilen tetikleyici işlevini yürütür. İşlev, Takvim etkinliği düzenlemesi kaydedilmeden önce yürütülür.
calendar.eventUpdateTrigger genellikle aşağıdakilerden birini veya daha fazlasını yapmak için kullanılır:
- Takvim etkinliğinde yapılan kullanıcı değişikliklerine yanıt olarak eklentinin Takvim etkinlik arayüzünü güncelleyin.
- Takvim etkinlik verilerini, Google Takvim'e bağlı bir konferans sistemi gibi üçüncü taraf bir sistemle senkronize edin.
Eklentinizin, bir Takvim etkinliğinin verilerinde (ör. katılımcı listesi) ayarlamalar yapması gerekiyorsa eklentinin
calendar.currentEventAccess manifest alanını
WRITE veya
READ_WRITE olarak ayarlamanız gerekir. Bu, eklentinin
https://www.googleapis.com/auth/calendar.addons.current.event.write
kapsama sahip olmasını da gerektirir.
Konferans çözümleri ekleme
Konferans çözümleri, kullanıcıların Google Takvim etkinliklerine ekleyebileceği üçüncü taraf konferans seçeneklerini temsil eder. Üçüncü taraf konferansa genel bakış belgelerinde, yeni konferans çözümleri ekleyen bir eklentinin nasıl oluşturulacağı hakkında ayrıntılı bilgi verilmektedir. Bu uzantı türü için kullanıcı arayüzü oluşturmaya gerek yoktur; eklenen çözümler Google Takvim etkinlik kullanıcı arayüzünün açılır menüsünde seçenek olarak görünür.