Google Workspace eklentileri, kullanıcı takvimleri ve Takvim etkinliklerini görüntülerken veya düzenlerken özelleştirilmiş arayüzler sağlayabilir. Bu sayede kullanıcıya alakalı ek bilgiler sağlayabilir, görevleri otomatikleştirebilir ve üçüncü taraf sistemleri Google Takvim'e bağlayabilirsiniz.
Google Takvim için eklenti arayüzü oluştururken bir ana sayfa sağlayabilirsiniz. Birden fazla ev sahibi için aynı ana sayfayı kullanabilir veya Google Takvim için özel bir ana sayfa tasarlayabilirsiniz.
Eklentiniz, kullanıcı bir Takvim etkinliğini açtığında görünen bir arayüz de tanımlayabilir.
Eklenti kullanıcı arayüzüne erişme
Google Workspace eklentileri, nasıl açıldıklarına bağlı olarak bir ana sayfa arayüzü, Google Takvim etkinliği arayüzü, ek seçim arayüzü veya bunların üçünü de 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ülenmesi için Takvim'e bir ana sayfa kartı oluşturur ve döndürür.calendar.homepageTriggerişlevi tanımlanmazsa bunun yerine genel bir ana sayfa kartı gösterilir. - Kullanıcı bir Takvim etkinliğini açıp eklenti simgesini tıklarsa veya kullanıcı bir etkinliği açarken eklenti açıksa eklenti, ilgili
eventOpenTriggerişlevini (varsa) yürütür. Bu işlev, eklentinin Takvim etkinlik arayüzünü oluşturur ve görüntüleme için Google Takvim'e döner. - Eklenti bir
eventAttachmentTriggerişlevi tanımlarsa kullanıcı bir Takvim etkinliğini düzenlerken Ek ekle'yi tıkladığında eklenti ek sağlayıcı olarak görünür. Eklenti seçildiğindeeventAttachmentTriggerişlevi, eklentinin ek seçim arayüzünü oluşturur ve görüntülenmesi için Google Takvim'e döndürür.
Takvim eklentisi arayüzünü oluşturma
Aşağıdaki adımları uygulayarak Google Takvim'i bir Google Workspace eklentisiyle genişletebilirsiniz:
- Eklentinizin Takvim'e özel bir ana sayfası olmasını isteyip istemediğinize karar verin. Ayrıca, kullanıcı takvim etkinliklerini düzenlerken özel bir arayüz sunmak isteyip istemediğinize karar verin.
- Gerekli kapsamlar dahil olmak üzere, eklenti komut dosyası projesi manifest dosyasına uygun
addOns.commonveaddOns.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. Birden fazla Google Workspace ana makinesi içincommon.homepageTriggerarayüzünü 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 başlıklı makaleyi inceleyin. - 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 eklenti ana sayfalarının gösterilmesini destekler.
Eklentinizin genel ana sayfasını Google Takvim'de göstermek için eklentinin manifest dosyasında bir addOns.calendar alanı bulunduğundan emin olmanız yeterlidir.
Alternatif olarak, Takvim'e özel bir ana sayfa sağlamak için eklenti manifest dosyasına 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 öğesi dizisini oluşturmak ve döndürmek için bu işlevi uygulamanız gerekir. Ana sayfa tetikleyici işlevine, istemcinin platformu gibi bazı genel bilgileri içeren bir parametre olarak bir olay nesnesi iletilir. Ana sayfanın yapısını özelleştirmek için etkinlik nesnesi verilerini kullanabilirsiniz.
Takvim etkinliği arayüzünü genişletme
Google Takvim, kullanıcı bir Takvim etkinliğini düzenlediğinde hangi arayüzün (varsa) gösterileceğini belirlemek için bağlama dayalı bir tetikleyici kullanır. Tetikleyici etkinleştirildiğinde, eklenti manifest dosyasında calendar.eventOpenTrigger alanı tarafından belirtilen içeriğe dayalı tetikleyici işlevini yürütür.
calendar.eventOpenTrigger alanında belirtilen işlevi uygulamanız gerekir. Bu işlev, bağımsız değişken olarak bir etkinlik nesnesi kabul eder ve kullanıcı etkinlik açıkken Takvim'in görüntülemesi için tek bir Card nesnesi veya Card nesnesi dizisi döndürmelidir.
Etkinlik nesneleri
Kullanıcı bir Takvim etkinliğini açtığında bir etkinlik nesnesi oluşturulur ve calendar.eventOpenTrigger bağlama dayalı tetikleyici işlevine iletilir. Tetikleyici işlevi, eklenti kartlarının nasıl oluşturulacağını belirlemek veya eklenti davranışını kontrol etmek için bu etkinlik nesnesinde bulunan bilgileri kullanabilir. Etkinlik nesneleri, bir eklenti ilk açıldığında ve kullanıcı etkileşimli widget'ları tıkladığında veya seçtiğinde de oluşturulur ve homepageTrigger işlevlerine iletilir.
Etkinlik nesnelerinin tam yapısı Etkinlik nesneleri bölümünde açıklanmıştır. Takvim, eklentinin geçerli ana uygulaması olduğunda bağlama dayalı tetikleyici ve widget etkileşimi etkinlik nesneleri, Takvim'e özgü istemci bilgilerini taşıyan Takvim etkinliği nesnesi alanını içerir.
Takvim etkinliklerini güncelleme
Kullanıcı bir takvim etkinliğini düzenlemek için açtığında tetiklenen bağlamsal calendar.eventOpenTrigger etkinliğine ek olarak, kullanıcı bir takvim etkinliğini güncelleyip kaydettiğinde tetiklenen bir calendar.eventUpdateTrigger etkinliği de tanımlayabilirsiniz. Bu tetikleyici yalnızca kullanıcı aşağıdaki düzenlemelerden birini veya daha fazlasını yaptığında tetiklenir:
- Bir veya daha fazla katılımcı ekler.
- Bir veya daha fazla katılımcıyı kaldırır.
- Farklı bir konferans çözümü ekler veya mevcut çözümden farklı bir çözüme geçer.
Bu tetikleyici etkinleştirildiğ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 kullanıcı tarafından yapılan değişikliklere yanıt olarak eklentinin Takvim etkinliği arayüzünü güncelleyin.
- Takvim etkinliği verilerini Google Takvim'e bağlı bir konferans sistemi gibi üçüncü taraf bir sistemle senkronize etme.
Takvim etkinliğinin verilerinde (ör. katılımcı listesi) ayarlamalar yapması için eklentinizin gerekli olması durumunda eklenti calendar.currentEventAccess manifest alanını WRITE veya READ_WRITE olarak ayarlamanız gerekir. Bunun için eklentinin https://www.googleapis.com/auth/calendar.addons.current.event.write
kapsamına sahip olması da gerekir.
Konferans çözümleri ekleme
Konferans çözümleri, kullanıcıların Google Takvim etkinliklerine ekleyebildiği üçüncü taraf konferans seçeneklerini temsil eder. Üçüncü taraf konferanslara genel bakış dokümanında, yeni konferans çözümleri ekleyen bir eklentinin nasıl oluşturulacağıyla ilgili ayrıntılı bilgi verilmektedir. Bu tür bir uzantı için kullanıcı arayüzü oluşturmanız gerekmez. Eklenen çözümler, Google Takvim etkinlik kullanıcı arayüzünün açılır menüsünde seçenek olarak gösterilir.