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.homepageTrigger
iş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 bircalendar.homepageTrigger
iş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
eventOpenTrigger
iş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
eventAttachmentTrigger
iş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ğindeeventAttachmentTrigger
iş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.common
veaddOns.calendar
alanlarını ekleyin. - Takvim'e özel bir ana sayfa sağlıyorsanız bu arayüzü oluşturmak için
calendar.homepageTrigger
işlevini uygulayın.common.homepageTrigger
arayü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.eventOpenTrigger
iş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.