Google Workspace eklentileri oluşturma

Google Workspace eklentilerini tasarlama, oluşturma ve yayınlama hakkında bilgi edinin:

  1. Eklentinizin kullanıcılar tarafından kullanılmasını istediğiniz Google Workspace uygulamalarını belirleyin.
  2. Eklentinizin projelerini oluşturun ve bir sahip ile ortak çalışanlar seçin.
  3. Eklentinizin görünümünü ve davranışını tasarlayıp yapılandırın.
  4. Eklentiyi oluşturun.
  5. Eklentinizin OAuth kapsamlarını doğrulayın.
  6. Eklentiyi bir veya daha fazla Google Workspace uygulamasında test edin.
  7. Eklentiyi yayınlayın.

Apps Komut Dosyası veya HTTP ile eklenti oluşturma İkisini karşılaştırmak için "Apps Komut Dosyası ve HTTP uç noktaları: Hangisini seçmelisiniz?" başlıklı videoyu izleyin. 🤔".

Google Workspace barındırılan uygulamalarını seçme

Google Workspace eklentilerini aşağıdaki Google Workspace barındırılan uygulamalarında görünecek şekilde yapılandırabilirsiniz:

  • Gmail
  • Google Takvim
  • Google Chat
  • Google Dokümanlar
  • Google Drive
  • Google Meet
  • Google E-Tablolar
  • Google Slaytlar

Google Workspace uygulamaları için geliştirme yapmak istiyorsanız Google Workspace kullanıcı arayüzünü genişletme başlıklı makaleyi inceleyin.

Eklentinizin projelerini oluşturma ve sahip ile ortak çalışanları seçme

Eklentinizi Apps Komut Dosyası'nda oluşturursanız hem bir Apps Komut Dosyası projesi hem de bir Google Cloud projesi oluşturursunuz. Eklentinizi Apps Komut Dosyası dışında bir dilde oluşturuyorsanız yalnızca bir Google Cloud projesi oluşturmanız gerekir.

Eklenti oluşturmak için hem bir komut dosyası projesi hem de bir Cloud projesi yapılandırmanız gerekir.

Eklenti geliştirmeye başlamadan önce projelerin sahibi olacak tek bir kullanıcı hesabı seçin ve hangi hesapların ortak çalışan olacağına karar verin. Projelerin sahibi, proje dosyalarını ve ilişkili ayarları oluşturup yönetirken ortak çalışanlar kodlama ve test etme konusunda yardımcı olabilir.

Apps Komut Dosyası projeleri

Eklentinizi oluşturmadan önce Apps Komut Dosyası kotalarını ve sınırlamalarını inceleyerek proje tasarımınızı bu yönergelere uygun hale getirin. Apps Komut Dosyası, küçük bir kullanıcı tabanına sahip kişisel veya dahili eklentilerin basit bir şekilde geliştirilmesi için en uygun çözümdür. Eklentiniz çok sayıda kullanıcı için destek, düşük gecikme süresi veya altyapınız üzerinde tam kontrol gerektiriyorsa farklı bir çalışma zamanı kullanmayı düşünebilirsiniz.

Eklentinizin Apps Komut Dosyası proje dosyalarını ortak Drive'da oluşturun. Böylece hiçbir hesap tek başına sahiplik sahibi olmaz. Eklenti komut dosyası dosyanızı ortak Drive'a yerleştirdiğinizde tüm ortak çalışanlar komut dosyası projesine erişebilir.

Bir eklenti yayınladığınızda yayıncı tek bir kullanıcı hesabı olur. Yayınlama hesabının, komut dosyası projesine düzenleme erişimi olmalıdır ancak hesabın sahibi olması gerekmez.

Apps Komut Dosyası projesi oluşturmak için Komut dosyası projeleri bölümüne bakın.

Google Cloud projeleri

Eklentinin Cloud projesine ortak çalışanlar ekleyin. Bu sayede ekibiniz, eklentinin bulut ayarlarına her zaman erişebilir.

Google Cloud projesi oluşturmak için Google Cloud projesi oluşturma başlıklı makaleye bakın.

Eklentinizin görünümünü ve davranışını tasarlama ve yapılandırma

Eklentiyi oluşturmadan önce nasıl görüneceğine ve nasıl çalışacağına karar verin. Eklentinin hangi kullanım alanlarına çözüm sunduğunu göz önünde bulundurun. Önce çalışmaya başlamak için temel bir tasarımla başlayın, ardından iyileştirmeler ekleyin.

Eklenti kullanıcı deneyiminizi tasarlama yönergeleri için Google Workspace eklenti stil kılavuzuna bakın.

Eklenti manifestini yapılandırma

Tasarımı eklenti manifestinde uygulayın. Eklentinin genişlettiği Google Workspace barındırılan uygulamaları da dahil olmak üzere, manifest dosyasında eklentinin görünümünü ve davranışını yapılandırın.

Ayrıntılar için Google Workspace eklentisi için manifestler başlıklı makaleyi inceleyin.

Kod ve özellik ekledikçe, gerekli eklenti görünümünü ve davranışını tanımlamak için manifesti gerektiği gibi güncelleyin.

Google Chat uygulamasının görünümünü ve davranışını yapılandırma

Google Chat'i genişleten bir eklenti tasarlıyorsanız Chat uygulamasının görünümünü ve davranışını yapılandırmak için Google Chat API'yi kullanın. Adımlar için Google Chat API'yi kullanma başlıklı makaleyi inceleyin.

Eklentiyi oluşturma

Eklenti için kart tabanlı bir arayüz uygulayın. Card service'i kullanın veya başka bir kod dili kullanıyorsanız arayüzün kart olarak oluşturulması için biçimlendirilmiş JSON döndürün.

Eklenti manifestinde belirtilen tetikleyici işlevleri uygulayın. Eklentiniz OAuth kullanarak üçüncü taraf hizmetine bağlanıyorsa bu hizmet için OAuth'u yapılandırın.

Kart oluşturma

Card nesneleri oluşturup widget ekleyerek bir eklenti kullanıcı arayüzü tanımlayın. Manifestinizde belirtilen tetikleyici işlevler, eklenti arayüzünün farklı "sayfalarını" temsil eden tek bir Card nesnesi veya Card nesneleri dizisi döndürmelidir. Eklenti, kullanıcı işlemlerine yanıt olarak yeni kartlar da oluşturup gösterebilir.

Apps Komut Dosyası'nda CardBuilder sınıfını kullanarak kart oluşturun. Her kart için CardHeader ve bir veya daha fazla CardSections gerekir. Her kart bölümünü arayüzü oluşturan ayrı widget'larla doldurun. Etkileşim widget'ları, etkileşim davranışlarını tanımlamak için genellikle işlemlere bağlanır.

Kartınıza CardBuilder aracılığıyla tüm bölümleri ve widget'ları ekledikten sonra, ilgili Card nesnesini oluşturmak için CardBuilder.build çağrısını yapın.

Eklenti kartlarında gösterilecek bilgileri almak için CalendarApp gibi yerleşik Apps Komut Dosyası hizmetlerini kullanın. Google dışı hizmetlerden alınan verileri kullanma

Eklentinizin OAuth gerektiren Google API'leri dışındaki API'lere erişmesi gerekiyorsa bu hizmete bağlanıp hizmeti yapılandırın. Google Dışı Hizmetlere Bağlanma Kılavuzu'na bakın.

Yapım sırası

Kart oluştururken yukarıdan aşağıya doğru oluşturun. Şu yapıyı kullanın:

  1. Widget'ı oluşturun.
  2. Widget'ı kart bölümüne ekleyin.
  3. Kart bölümünde tüm widget'lar görünene kadar işlemi tekrarlayın.
  4. Kart bölümünü karta ekleyin.

Bunun nedeni, bir karta veya kart bölümüne widget eklediğinizde aslında o widget'ın kopyasını eklemenizdir. Eklendikten sonra widget nesnesinde yaptığınız değişiklikler nihai karta yansıtılmaz.

Evrensel işlemler

Bağlamdan bağımsız işlevsellik sağlamak için evrensel işlemleri kullanın. Evrensel işlemler, karttan bağımsız olarak eklenti kullanıcı arayüzünde kullanılabilen menü öğeleridir. Tanımlanan tüm evrensel işlemler, eklentinin kart menüsünde görünür.

Daha fazla bilgi için Evrensel işlemler başlıklı makaleyi inceleyin.

Eklenti OAuth kapsamlarını doğrulama

Kapsamlar, eklentinin kullanıcı adına gerçekleştirebileceği işlemleri tanımlar. Eklentiler yalnızca çalışmak için gereken kapsamları içermelidir.

Eklenti projelerinde, eklentinin kapsamlarını ayarlayarak eklentinin mümkün olan en az izinli kapsam kümesini kullandığından emin olun. Eklenti manifest dosyasında kapsamları tanımlayın.

Daha fazla bilgi için Kapsamlar bölümüne bakın.

Eklentiyi test etme

Yayınlanmamış eklentileri test etmek için önce yayınlanmamış eklentiyi yüklemeniz gerekir. Eklenti yüklendikten ve yetkilendirildikten sonra, uzantı sağladığı barındırılan uygulamalardaki görünümünü ve davranışını test etmek için hesabınızda kullanın. Eklentinin bağlamlar ve kullanıcı işlemleri için beklendiği gibi çalıştığını doğrulayın.

Eklentinizi test etmeye başlamak için aşağıdaki kılavuzlara bakın:

Eklentiyi yayınlama

Yayınlama, eklentinizi diğer kullanıcıların kullanımına sunar. Yayınlamadan önce yayın özetini inceleyin. Yayınlama, hazırlık gerektiren karmaşık bir süreçtir.

Google Workspace eklentileri, Google Workspace Marketplace'te yayınlanır. Herkese açık olarak kullanılabilen eklentilerin yayınlanmadan önce uygulama incelemesinden geçmesi gerekir.

Daha fazla bilgi için Google Workspace eklentilerini yayınlama başlıklı makaleyi inceleyin.