Google Takvim arayüzleri oluşturma

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

Açılma şekline bağlı olarak, Google Workspace eklentisi 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ı bir takvim görünümündeyken eklenti simgesini tıklarsa eklenti, ilgili calendar.homepageTrigger işlevini (varsa) yürütür. Bu işlev, Takvim'de gösterilecek bir ana sayfa kartı oluşturup döndürür. calendar.homepageTrigger iş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 eventOpenTrigger iş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 eventAttachmentTrigger iş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ğinde eventAttachmentTrigger iş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:

  1. 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.
  2. Eklenti komut dosyası projesi manifestine uygun addOns.common ve addOns.calendar alanlarını ekleyin. Gerekli kapsamlar da dahil edilmelidir.
  3. Takvime özel bir ana sayfa sağlıyorsanız bu arayüzü oluşturmak için calendar.homepageTrigger işlevini uygulayın. Ayrıca birden fazla Google Workspace ana makinesi için common.homepageTrigger arayüzünü kullanmayı da seçebilirsiniz.
  4. Takvim etkinliği arayüzü sağlıyorsanız bu arayüzü oluşturmak için calendar.eventOpenTrigger işlevini uygulamanız gerekir. Ayrıntılar için Takvim etkinliği arayüzünü genişletme başlıklı makaleyi inceleyin.
  5. Kullanıcının düğme tıklamaları gibi 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 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 etkinlik nesnesi 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) düzenleme 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.