Google Takvim arayüzleri oluşturma

Google Workspace Eklentileri, müşterilerinize kullanıcı, takvimleri ve Takvim etkinliklerini görüntülerken veya düzenlerken arayüz oluşturur. Bu, kullanıcıya alakalı ek bilgiler sağlamanıza, otomatik görevleri yapabilir, üçüncü taraf sistemleri Google Takvim'e bağlayabilirsiniz.

Google Takvim için eklenti arayüzü oluştururken homepage. Aynı ana sayfanızı veya Google Takvim için ayrı bir tane tasarlayın.

Eklentiniz, kullanıcı bir işlem gerçekleştirdiğinde görünen bir arayüz de tanımlayabilir. açık bir takvim etkinliği vardır.

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 yürütülür ilgili calendar.homepageTrigger işlevini kullanın (varsa). Bu işlev bir ana sayfa kartı oluşturur ve döndürür Takvim'e ekleyin. Yanıt hayır ise: calendar.homepageTrigger işlevi tanımlanırsa bunun yerine genel bir ana sayfa kartı gösterilir.
  • Kullanıcı bir Takvim etkinliği açar ve eklenti simgesini tıklarsa veya Eklenti, kullanıcı bir etkinlik açtığında da ilgili reklam öğesini yürütür eventOpenTrigger işlevini kullanın (varsa). Bu işlev, eklentinin Takvim etkinliğini oluşturur arayüzü gösterilir ve görüntülemek için Google Takvim'e 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 ekini oluşturur seçim arayüzünü açar ve görüntülemek üzere bunu Google Takvim'e geri gönderir.

Takvim eklentisi arayüzü oluşturma

Google Takvim'i şununla genişletebilirsiniz: Google Workspace eklentisi için aşağıdaki adımları uygulayın:

  1. Eklentinizin Takvim'e özel bir takvime sahip olmasını isteyip istemediğinize karar verin. homepage. Ayrıca, kullanıcı sayfayı ziyaret ederken özel bir arayüz düzenleyebilirsiniz.
  2. Uygun addOns.common ve addOns.calendar eklenti komut dosyası proje manifest'indeki alanları doldurur. ve gerekli kapsamlar dahil.
  3. Takvime özel bir homepage calendar.homepageTrigger işlevini kullanmanız gerekir. Ayrıca, common.homepageTrigger birden fazla Google Workspace ana makinesine yönelik arayüz sağlar.
  4. Bir Takvim etkinliği arayüzü sağlıyorsanız calendar.eventOpenTrigger işlevini kullanmanız gerekir. Görüntüleyin Takvim etkinliği arayüzünü genişletme inceleyebilirsiniz.
  5. Kullanıcının Düğme tıklamaları gibi kullanıcı arayüzü etkileşimleri.

Takvim ana sayfaları

Google Takvim, Google Workspace eklentisi ana sayfalarının gösterilmesini destekler. Eklentinizin ortak ana sayfasının Google Takvim'de gösterilmesi için bir addOns.calendar alanına eklemeniz gerekir.

Alternatif olarak, calendar.homepageTrigger eklenti manifest dosyasını eklemeniz gerekir.

Her iki durumda da, eklentisinin komut dosyası projesidir. Bu fonksiyon, yeni bir istem oluşturmak için Gerektiğinde Google Takvim ana sayfası. Düzgün metinlerin yer aldığı tek bir Card veya bir dizi Card nesneleri içerir. Ana sayfa tetikleyici işlevi, etkinlik nesnesi gibi bazı genel bilgileri içeren bir parametre olarak gösterilir. platformu. Etkinlik nesnesi verilerini kullanarak, ana sayfa.

Takvim etkinliği arayüzünü genişletme

Google Takvim, hangi arayüzün kullanılacağını belirlemek için bağlamsal bir tetikleyici kullanır. (varsa) gösterilir. Tetikleyici etkinleştiğinde, JavaScript kodu tarafından belirtilen bağlamsal tetikleyici işlevini yürütür. calendar.eventOpenTrigger alanı, eklenti manifest dosyasında gösterilir.

calendar.eventOpenTrigger girin. Bu işlev, etkinlik nesnesini bağımsız değişkenine ve tek bir Card nesnesi veya bir dizisi Takvim'in kullanacağı Card nesne kullanıcı etkinlik açıkken görüntülenecektir.

Etkinlik nesneleri

Bir etkinlik nesnesi oluşturulur ve calendar.eventOpenTrigger Kullanıcı açıldığında bağlamsal tetikleyici işlevi Takvim etkinliği. Tetikleyici işlevi, bu etkinlikteki bilgileri kullanabilir eklenti kartlarının nasıl oluşturulacağını veya eklentinin nasıl kontrol edileceğini belirleyen nesne gösterir. Etkinlik nesneleri de oluşturulur ve homepageTrigger bir eklenti ilk açıldığında ve kullanıcı tıkladığında veya seçtiğinde işlevleri kullanıma sunuyoruz.

Etkinlik nesnelerinin tam yapısı aşağıda açıklanmıştır: Etkinlik nesneleri. Takvim, eklentinin işlem ana makine uygulaması olduğunda, bağlamsal tetikleyici ve widget etkileşimi etkinlik nesneleri Takvim etkinliği nesnesi alanına girilmelidir.

Takvim etkinliklerini güncelleme

İçeriğe dayalı reklamların yanı sıra calendar.eventOpenTrigger Kullanıcı reklamınızı açtığında tetiklenen bir Takvim etkinliği oluşturmak istiyorsanız, calendar.eventUpdateTrigger Kullanıcı bir Takvim etkinliğini güncelleyip kaydettiğinde etkinleşen bir etkinlik oluşturulur. Yalnızca bu tetikleyici 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 çözüme geçiş yapar.

Bu tetikleyici etkinleştiğinde, tarafından belirtilen tetikleyici işlevi calendar.eventUpdateTrigger manifesto bölümüdür. İşlev, Takvim etkinliği düzenleme işleminin tamamlanmasından önce yürütülür kaydedildi.

calendar.eventUpdateTrigger genellikle aşağıdakilerden birini veya daha fazlasını yapmak için kullanılır:

  • Kullanıcı değişikliklerine göre eklentinin Takvim etkinliği arayüzünü güncelleme gönderin.
  • Takvim etkinlik verilerini, konferans gibi üçüncü taraf bir sistemle senkronize etme bir sistem oluşturabilirsiniz.

Eklentinize, Takvim etkinliğinin verilerinde (ör. ) eklentisini eklemeniz gerekir. calendar.currentEventAccess manifest alanını WRITE veya READ_WRITE olarak ayarlayın. Bu ayrıca eklentinin https://www.googleapis.com/auth/calendar.addons.current.event.write. kapsamı hakkında daha fazla bilgi edinin.

Konferans çözümleri ekleme

Konferans çözümleri kullanıcıların ekleyebilecekleri üçüncü taraf konferans seçeneklerini temsil eder Google Takvim etkinlikleri. İlgili içeriği oluşturmak için kullanılan Üçüncü taraf konferanslarına genel bakış dokümanlarda yeni ve benzersiz işlevlere sahip bir eklentinin nasıl konferans çözümü. Bu tür reklamlar için kullanıcı arayüzü oluşturmanıza gerek yoktur. uzantı; eklenen çözümler, açılır menüde seçenekler olarak görünür Google Takvim etkinliği kullanıcı arayüzünü açın.