Google Takvim arayüzleri oluşturma

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 bir calendar.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ğinde eventAttachmentTrigger 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:

  1. 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.
  2. Gerekli kapsamlar da dahil olmak üzere, eklenti komut dosyası projesi manifest'e uygun addOns.common ve addOns.calendar alanlarını ekleyin.
  3. 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.
  4. 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.
  5. 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.