Google Takvim arayüzleri oluşturma

Google Workspace Eklentileri, kullanıcılar 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. Aynı ana sayfayı birden fazla ana makine için kullanabilir veya Google Takvim için belirli bir ana makine 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

Nasıl açıldığına bağlı olarak Google Workspace eklentisi; ana sayfa arayüzü, Google Takvim etkinlik arayüzü, ek seçme arayüzü veya üçü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 bir ana sayfa kartı oluşturur ve gösterilmesi için Takvim'e geri gönderir. Herhangi bir calendar.homepageTrigger işlevi tanımlanmamışsa bunun yerine genel bir ana sayfa kartı gösterilir.
  • Kullanıcı bir Takvim etkinliğini açar ve eklenti simgesini tıklarsa veya kullanıcı bir etkinliği açtığında eklenti açıksa eklenti, ilgili eventOpenTrigger işlevini (varsa) yürütür. Bu işlev, eklentinin Takvim etkinlik arayüzünü oluşturur ve görüntülemek üzere Google Takvim'e geri döner.
  • Eklenti bir eventAttachmentTrigger işlevi tanımlıyorsa 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ğinde eventAttachmentTrigger işlevi, eklentinin ek seçimi arayüzünü oluşturur ve gösterilmesi için Google Takvim'e geri gönderir.

Takvim eklentisi arayüzü oluşturma

Aşağıdaki adımları uygulayarak Google Takvim'i 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ğlayıp sağlamayacağınıza da karar verin.
  2. Gerekli kapsamlar dahil olmak üzere eklenti komut dosyası projesi manifest'ine uygun addOns.common ve addOns.calendar alanlarını ekleyin.
  3. Takvim'e özgü 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. Bir Takvim etkinlik 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 etkinliği arayüzünü genişletme bölümüne bakın.
  5. Düğme tıklamaları gibi kullanıcının kullanıcı arayüzü etkileşimlerine 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ı bulunması yeterlidir.

Alternatif olarak, Takvim'e özel bir ana sayfa sağlamak için eklenti manifest dosyasına bir calendar.homepageTrigger ekleyebilirsiniz.

Her iki durumda da eklentinizin komut dosyası projesinde bir ana sayfa tetikleyici işlevi adı 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 derleyip döndürmek için bu işlevi uygulamanız gerekir. Ana sayfa tetikleyici işlevi, istemcinin platformu gibi bazı genel bilgileri içeren parametre olarak bir etkinlik 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ğlamsal bir tetikleyiciden yararlanır. Tetikleyici etkinleştiğinde, manifest eklentisindeki calendar.eventOpenTrigger alanında belirtilen içeriğe dayalı tetikleyici işlevini yürütür.

calendar.eventOpenTrigger alanında adlandırılmış işlevi uygulamanız gerekir. Bu işlev, bağımsız değişken olarak bir etkinlik nesnesini kabul eder ve kullanıcı etkinlik açıkken Takvim'in görüntülemesi için tek bir Card nesnesi veya bir Card nesne 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. Etkinlik nesneleri de bir eklenti ilk açıldığında ve kullanıcı etkileşimli widget'ları tıkladığında veya seçtiğinde homepageTrigger işlevlerine aktarılır.

Etkinlik nesnelerinin tam yapısı Etkinlik nesneleri bölümünde açıklanmaktadır. Takvim, eklentinin işlem ana makine uygulaması olduğunda, bağlamsal tetikleyici ve widget etkileşim etkinliği nesneleri Takvim'e özgü istemci bilgilerini taşıyan Takvim etkinliği nesnesi alanını içerir.

Takvim etkinliklerini güncelleme

Kullanıcılar, düzenlemek üzere bir Takvim etkinliğini açtığında tetiklenen bağlamsal calendar.eventOpenTrigger özelliğine 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 çözüme geçiş yapar.

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ğindeki kullanıcı değişikliklerine yanıt olarak eklentinin Takvim etkinliği arayüzünü güncelleme.
  • Takvim etkinlik verilerini, Google Takvim'e bağlı bir konferans sistemi gibi üçüncü taraf bir sistemle senkronize edebilirsiniz.

Eklentinizin bir Takvim etkinliğinin verilerinde (katılımcı listesi gibi) ayarlamalar yapması gerekiyorsa 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 da sahip olması gerekir.

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 konferanslara 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ş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örünür.