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 Takvim'e bağlayabilirsiniz.
Takvim için Google Workspace eklenti arayüzü oluştururken ana sayfa sağlayabilirsiniz. Birden fazla sunucu için aynı ana sayfayı kullanabilir veya 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
Kullanıcı arayüzünüz bağlama bağlı olarak çeşitli şekillerde görünebilir. Örneğin, bir eklenti ana sayfa arayüzü, takvim etkinliği arayüzü, ek seçme arayüzü veya üçünü de tanımlayabilir:
- Kullanıcı bir takvim görünümündeyken eklenti simgesini tıklarsa eklenti, varsa ilgili
calendar.homepageTriggerişlevini yürütür. Bu işlev, Takvim için bir ana sayfa kartı oluşturur ve 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, 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 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, ek sağlayıcı olarak görünür. Eklenti seçildiğindeeventAttachmentTriggerişlevi, eklentinin ek seçimi arayüzünü oluşturur ve görüntülenmesi için Takvim'e döndürür.
Eklenti Takvim arayüzünü oluşturma
Kullanıcı arayüzünüzü oluşturmak için aşağıdaki adımları uygulayın. Aşağıdaki adımları uygulayarak Google Workspace eklentisiyle Takvim'in işlevlerini 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.
- Gerekli kapsamlar da dahil olmak üzere, eklenti komut dosyası projesi manifestine uygun
addOns.commonveaddOns.calendaralanlarını ekleyin. - 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 ana makine uygulaması 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 uygulayın. 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ı
eklentiler, Google Workspace eklentisi ana sayfalarının gösterilmesini destekler. Eklentinizin ortak ana sayfasını Takvim'de göstermek için eklentinin manifest dosyasında addOns.calendar alanı olduğundan emin olun.
Alternatif olarak, Takvim'e ö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 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 uygulayın. Ana sayfa tetikleyici işlevine, parametre olarak istemcinin platformu gibi bazı genel bilgileri içeren bir etkinlik nesnesi iletilir. Ana sayfanın yapısını özelleştirmek için etkinlik nesnesi verilerini kullanın.
Takvim etkinliği arayüzünü genişletme
Takvim, kullanıcının Takvim etkinliğini düzenlediğinde hangi arayüzün (varsa) gösterileceğini belirlemek için bağlamsal bir tetikleyiciye dayanır. Tetikleyici etkinleştiğinde, eklenti manifestosundaki calendar.eventOpenTrigger alanı tarafından belirtilen bağlamsal tetikleyici işlevi yürütülür.
calendar.eventOpenTrigger alanında belirtilen işlevi uygulayın. 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östermesi için tek bir Card nesnesi veya bir Card nesneleri dizisi döndürmelidir.
Etkinlik nesneleri
Kullanıcı bir Takvim etkinliğini 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ı veya eklenti davranışının nasıl kontrol edileceğini belirlemek için bu etkinlik nesnesindeki bilgileri kullanabilir. Eklenti ilk kez açıldığında ve kullanıcı etkileşimli widget'ları tıkladığında veya seçtiğinde etkinlik nesneleri 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 taşıyan 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
olayına ek olarak, kullanıcı bir Takvim etkinliğini güncelleyip kaydettiğinde tetiklenen bir
calendar.eventUpdateTrigger
olayı 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 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ıların Takvim etkinliğinde yaptığı değişikliklere yanıt olarak eklentinin Takvim etkinliği arayüzünü güncelleyin.
- Takvim etkinliği verilerini, 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) düzenleme yapması gerekiyorsa eklenti
calendar.currentEventAccess
manifest alanını WRITE veya READ_WRITE olarak ayarlayın. Bunun için eklentinin https://www.googleapis.com/auth/calendar.addons.current.event.write
kapsamına sahip olması da gerekir.
Konferans çözümleri ekleme
Üçüncü taraf bir konferans sistemi kullanıyorsanız konferans çözümleri ekleyerek bu sistemi Takvim ile entegre edebilirsiniz. Bu özellik daha önce Takvim konferans eklentileri olarak beta sürümündeydi.
Konferans çözümleri, kullanıcıların Takvim etkinliklerine ekleyebileceği üçüncü taraf konferans seçeneklerini temsil eder. Üçüncü taraf konferansına genel bakış belgelerinde, 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 gerekli değildir. Eklenen çözümler, Takvim etkinliği kullanıcı arayüzünün açılır menüsünde seçenek olarak gösterilir.