Google Workspace eklentileri, kullanıcı takvim ve Takvim etkinliklerini görüntülerken veya düzenlerken özelleştirilmiş arayüzler sağlayabilir. Bu sayede kullanıcıya daha fazla bilgi sağlayabilir, görevleri otomatikleştirebilir ve üçüncü taraf sistemlerini Google Takvim'e bağlayabilirsiniz.
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 belirli bir ana sayfa tasarlayabilirsiniz.
Eklentiniz, kullanıcı Takvim etkinliği açık olduğunda görünen bir arayüz de tanımlayabilir.
Eklenti kullanıcı arayüzüne erişme
Google Workspace Eklenti, nasıl açıldığına bağlı olarak bir ana sayfa arayüzü, bir Google Takvim etkinlik arayüzü, bir ek seçimi arayüzü veya üçünü birden tanımlayabilir:
- Kullanıcı bir takvim görünümünde eklenti simgesini tıklarsa eklenti, ilgili
calendar.homepageTriggerişlevini (varsa) yürütür. Bu işlev, görüntülenmek üzere Takvim için bir ana sayfa kartı oluşturup döndürür. Tanımlanmış bircalendar.homepageTriggerişlevi yoksa 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 söz konusu eklenti (varsa) ilgili
eventOpenTriggerişlevini yürütür. Bu işlev, eklentinin Takvim etkinliği arayüzünü oluşturur ve görüntülenmek üzere Google Takvim'e döner. - Eklenti bir
eventAttachmentTriggerişlevini tanımlıyorsa kullanıcı, bir Takvim etkinliğini düzenlerken Ek ekle'yi tıkladığında eklenti olarak görünür. Eklenti seçildiğindeeventAttachmentTriggerişlevi, eklentinin ek seçimi arayüzünü oluşturur ve gösterilmesi için Google Takvim'e döndürür.
Eklenti Takvim arayüzü oluşturma
Aşağıdaki adımları uygulayarak Google Takvim'i bir Google Workspace eklentisiyle genişletebilirsiniz:
- Eklentinizin Takvim'e özel bir ana sayfasına 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 komut dosyası projesine manifest'e uygun
addOns.commonveaddOns.calendaralanlarını (gerekli tüm kapsamları dahil) ekleyin. - Takvim'e özel bir ana sayfa sağlıyorsanız bu arayüzü oluşturmak için
calendar.homepageTriggerişlevini uygulayın. Ayrıca, birden fazla Google Workspace barındırıcısı içincommon.homepageTriggerarayüzünü kullanmayı da seçebilirsiniz. - 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 etkinliği arayüzünü genişletme başlıklı makaleye bakın. - Kullanıcının kullanıcı arayüzü etkileşimlerine (düğme tıklamaları gibi) 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örüntülenmesini 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 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şturmak ve döndürmek için bu işlevi uygulamanız gerekir. Ana sayfa tetikleyici işlevi, müşterinin platformu gibi bazı genel bilgileri içeren bir parametre olarak etkinlik nesnesi iletir. Ana sayfanın yapısını özelleştirmek için etkinlik nesnesi verilerini kullanabilirsiniz.
Takvim etkinliği arayüzü genişletiliyor
Kullanıcı bir Takvim etkinliğini düzenlediğinde, gösterilecek arayüzü (varsa) belirlemek için Google Takvim'in bağlama dayalı bir tetikleyicisi vardır. Tetikleyici etkinleştiğinde eklenti manifest'te calendar.eventOpenTrigger alanında 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 nesnesini kabul eder ve kullanıcı etkinliği açıkken Takvim'in göstermesi için tek bir Card nesnesi veya bir dizi Card nesnesi döndürmelidir.
Etkinlik nesneleri
Kullanıcı bir Takvim etkinliğini açtığında etkinlik nesnesi oluşturulur ve calendar.eventOpenTrigger bağlamsal tetikleme işlevine iletilir. Tetikleyici işlevi, eklenti kartlarının nasıl oluşturulacağını veya eklenti davranışını nasıl kontrol edeceğinizi belirlemek için bu etkinlik nesnesindeki bilgileri kullanabilir. Ayrıca, etkinlik nesneleri bir eklenti ilk kez açıldığında ve kullanıcı etkileşimli widget'ları tıkladığında veya seçtiğinde homepageTrigger işlevlerine oluşturulup aktarılır.
Etkinlik nesnelerinin tam yapısı Etkinlik nesneleri bölümünde açıklanmıştır. Takvim, eklentinin ana makine uygulaması olduğunda, bağlamsal tetikleyici ve widget etkileşimi etkinlik nesneleri Takvim'e özel istemci bilgilerini taşıyan Takvim etkinliği nesnesi alanını içerir.
Takvim etkinliklerini güncelleme
Kullanıcı bir Takvim etkinliğini düzenlemek üzere açtığında tetiklenen bağlamsal 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ı kaldırır.
- Farklı bir konferans çözümü ekler veya geçiş yapar.
Bu tetikleyici etkinleştiğinde calendar.eventUpdateTrigger manifest alanı tarafından 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 birkaçını yapmak için kullanılır:
- Kullanıcının Takvim etkinliğinde yaptığı 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 edebilirsiniz.
Eklentinizin bir Takvim etkinliğinin verileri (katılımcı listesi gibi) üzerinde düzenlemeler yapması gerekiyorsa 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ının olması da gerekir.
Konferans çözümleri ekleme
Konferans çözümleri, kullanıcıların Google Takvim etkinliklerine ekleyebileceği bir üçüncü taraf konferans seçeneği sunar. Üçüncü taraf konferans toplantısına genel bakış belgelerinde, yeni konferans çözümleri ekleyen bir eklentinin nasıl oluşturulacağı açıklanmaktadır. Bu tür uzantılar için bir 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.