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 ek alakalı bilgiler sağlayabilir, görevleri otomatikleştirebilir ve üçüncü taraf sistemlerini Google Takvim'e bağlayabilirsiniz.
Google Takvim için bir eklenti arayüzü oluştururken ana sayfa sağlayabilirsiniz. Birden fazla ana makine 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 eklentisi, açılma şekline bağlı olarak bir ana sayfa arayüzü, bir Google Takvim etkinliği arayüzü, bir ek seçme arayüzü veya üçünü de tanımlayabilir:
- Kullanıcı, takvim görünümündeyken eklenti simgesini tıklarsa eklenti, varsa ilgili
calendar.homepageTriggerişlevini yürütür. Bu işlev, Takvim'de gösterilecek bir ana sayfa kartı oluşturup döndürür.calendar.homepageTriggerişlevi tanımlanmamışsa bunun yerine genel bir ana sayfa kartı gösterilir. - Kullanıcı bir Takvim etkinliğini açıp eklenti simgesini tıkladığında veya kullanıcı bir etkinliği açtığında eklenti açıksa eklenti, ilgili
eventOpenTriggerişlevini (varsa) 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 geri döner. - Eklenti bir
eventAttachmentTriggerişlevi tanımlarsa kullanıcı bir Takvim etkinliğini düzenlerken Eklenti ekle'yi tıkladığında eklenti, ek sağlayıcı olarak görünür. Eklenti seçildiğindeeventAttachmentTriggerişlevi, eklentinin ek seçme arayüzünü oluşturur ve görüntülenmesi için Google Takvim'e döndürür.
Eklenti Takvim arayüzünü oluşturma
Aşağıdaki adımları uygulayarak Google Takvim'i Google Workspace eklentisiyle genişletebilirsiniz:
- Eklentinizin takvime özel bir ana sayfası olmasını isteyip istemediğinize karar verin. Ayrıca, kullanıcı Takvim etkinliklerini düzenlerken özel bir arayüz sağlamak isteyip istemediğinize de karar verin.
- Eklenti komut dosyası projesi manifestine uygun
addOns.commonveaddOns.calendaralanlarını ekleyin. Gerekli kapsamlar da dahil edilmelidir. - Takvime ö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 ana makinesi 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
calendar.eventOpenTriggerişlevini uygulamanız gerekir. Ayrıntılar için Takvim etkinliği 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 eklentisi ana sayfalarının gösterilmesini destekler.
Eklentinizin ortak ana sayfasını Google Takvim'de göstermek için eklentinin manifest dosyasında addOns.calendar alanının bulunduğundan emin olmanız yeterlidir.
Alternatif olarak, takvimle ilgili özel bir ana sayfa sağlamak için eklenti manifestine
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 nesneleri dizisi oluşturup 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 etkinlik nesnesi iletilir. Ana sayfanın oluşturulmasını özelleştirmek için etkinlik nesnesi verilerini kullanabilirsiniz.
Takvim etkinliği arayüzünü genişletme
Google Takvim, kullanıcının bir Takvim etkinliğini düzenlediğinde hangi arayüzün (varsa) gösterileceğini belirlemek için bağlamsal bir tetikleyiciye dayanır. Tetikleyici tetiklendiğinde, eklenti manifest dosyasındaki calendar.eventOpenTrigger alanı tarafından belirtilen bağlamsal tetikleyici işlevi yürütülür.
calendar.eventOpenTrigger alanında belirtilen işlevi uygulamanız gerekir. Bu işlev, bağımsız değişken olarak bir event object kabul eder ve kullanıcının etkinliği açıkken Takvim'in görüntülemesi için tek bir Card nesnesi veya bir Card nesneleri dizisi döndürmelidir.
Etkinlik nesneleri
Bir kullanıcı Takvim etkinliği açtığında etkinlik nesnesi oluşturulur ve calendar.eventOpenTrigger bağlamsal 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 nesnesindeki bilgileri kullanabilir. Etkinlik nesneleri, eklenti ilk açıldığında ve kullanıcı etkileşimli widget'ları tıkladığında veya seçtiğinde de oluşturulup homepageTrigger işlevlerine iletilir.
Etkinlik nesnelerinin tam yapısı Etkinlik nesneleri bölümünde açıklanmaktadır. Takvim, eklentinin etkin ana makine uygulaması olduğunda bağlamsal tetikleyici ve widget etkileşimi etkinlik nesneleri, Takvim'e özgü istemci bilgilerini içeren Takvim etkinlik 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'e ek olarak, kullanıcı bir Takvim etkinliğini güncelleyip kaydettiğinde tetiklenen bir calendar.eventUpdateTrigger de tanımlayabilirsiniz. Bu tetikleyici yalnızca kullanıcı aşağıdaki düzenlemelerden birini veya daha fazlasını yaparsa 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 bu çö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:
- 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 etme.
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. 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 ekleyebileceği üçüncü taraf konferans seçeneklerini ifade eder. Üçüncü taraf konferans genel bakışı dokümanında, yeni konferans çözümleri ekleyen bir eklenti oluşturma hakkında ayrıntılı bilgi verilmektedir. Bu tür bir uzantı için kullanıcı arayüzü oluşturmak gerekmez. Eklenen çözümler, Google Takvim etkinliği kullanıcı arayüzünün açılır menüsünde seçenek olarak gösterilir.