Bu sayfada, Google Workspace eklentilerinin nasıl tasarlanacağı, oluşturulacağı ve yayınlanacağı hakkında genel bilgiler verilmektedir. Bu genel bakışta aşağıdaki adımlar açıklanmaktadır:
- Eklentinizin kullanıcıların kullanımına sunulmasını istediğiniz Google Workspace uygulamalarını belirleyin.
- Eklentinizin projelerini oluşturun, bir sahip ve ortak çalışan seçin.
- Eklentinizin görünümünü ve davranışını tasarlayın.
- Eklentinin proje manifestini veya dağıtım kaynağını yapılandırın.
- Eklentinin görünümünü ve davranışını tanımlayacak kod yazın.
- Eklentinizin OAuth kapsamlarını doğrulayın.
- Eklentiyi bir veya daha fazla Google Workspace uygulamasında test edin.
- Eklentiyi yayınlayın.
Google Workspace ana makine uygulamalarını seçme
Google Workspace eklentilerini aşağıdaki Google Workspace ana makine uygulamalarında görünecek şekilde yapılandırabilirsiniz:
- Gmail
- Google Takvim
- Google Dokümanlar
- Google Drive
- Google E-Tablolar
- Google Slaytlar
Google Workspace uygulamaları için nasıl geliştirme yapacağınız hakkında bilgi edinmek istiyorsanız Google Workspace kullanıcı arayüzünü genişletme başlıklı makaleyi inceleyin.
Eklentinizin projelerini oluşturun, sahip ve ortak çalışan seçin
Eklentinizi Apps Komut Dosyası'nda oluşturursanız hem Apps Komut Dosyası projesi hem de Google Cloud projesi oluşturursunuz. Eklentinizi Apps Komut Dosyası dışında bir dilde oluşturursanız yalnızca bir Google Cloud projesi oluşturmanız gerekir.
Eklenti geliştirmeye başlamadan önce, projelerin sahibi olacak tek bir kullanıcı hesabı seçin ve diğer hangi hesapların ortak çalışan olacağını belirleyin. Proje sahibi, proje dosyalarını ve ilişkili ayarları oluşturup yönetirken ortak çalışanlar kodlama ve test konusunda yardımcı olabilir.
Apps Komut Dosyası projeleri
Eklentinizin Apps Komut Dosyası proje dosyalarını, tek bir hesabın tek başına sahip olmayacağı şekilde ortak bir Drive'da oluşturabilirsiniz. Eklenti komut dosyası dosyanızı ortak bir Drive'a yerleştirdiğinizde, birden fazla ortak çalışanın komut dosyası projesine erişimi olur.
Bir eklentiyi yayınladığınızda tek bir kullanıcı hesabı yayıncı olarak çalışır. 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 başlıklı makaleye göz atın.
Google Cloud projeleri
Eklentinin Cloud projesine ortak çalışanlar eklemenizi öneririz. Bu sayede, ekibinizdeki bir kullanıcı eklentinin Cloud ayarlarına her zaman erişebilir.
Google Cloud projesi oluşturmak için Google Cloud projesi oluşturma başlıklı makaleyi inceleyin.
Eklentinizin görünümünü ve davranışını tasarlama
Eklentinizi oluşturmaya başlamadan önce nasıl görünmesini ve nasıl davranmasını istediğinize karar verin. Eklentinin hangi kullanım alanları için çözüm sağlamaya çalışması gerektiğini düşünün. İşe basit bir tasarımla başlayıp daha fazla ayrıntı ekleyin.
Eklenti kullanıcı deneyiminizin nasıl tasarlanacağıyla ilgili yönergeler için Google Workspace eklentisi stil kılavuzuna bakın.
Eklenti projesi manifestini yapılandırma
Apps Komut Dosyası projelerinde proje manifesti özel bir JSON dosyasıdır. Projeyle ilgili kitaplık bağımlılıkları gibi çeşitli ayrıntıları belirtir. Google Workspace eklentileri için manifest, ana makine uygulamasının eklentiyi doğru şekilde görüntülemesi için ihtiyaç duyduğu temel bilgileri de sağlar.
Apps Komut Dosyası'nda eklentinizin manifestini nasıl yapılandıracağınızla ilgili ayrıntılar için Manifest'ler bölümüne bakın.
Eklentinize kod ve özellikler eklerken, gerekli eklenti görünümünü ve davranışını üretmek için manifesti gerektiği şekilde düzenleyin.
Eklentiyi kodlama
Eklenti için kart tabanlı bir arayüz uygulamanız gerekir. Apps Script'in Kart hizmetini kullanın veya başka bir kod dilinde yazıyorsanız arayüzün kart olarak oluşturulması için düzgün biçimlendirilmiş JSON döndürün.
Eklenti manifestinde belirtilen tüm tetikleyici işlevleri de uygulamanız gerekir. Eklentiniz OAuth'u kullanarak Google dışı bir üçüncü taraf hizmetine bağlanıyorsa bu hizmet için OAuth'u da yapılandırmanız gerekir.
Kart oluşturma
Card nesneleri oluşturup bunları widget'larla doldurarak eklenti kullanıcı arayüzünü tanımlarsınız. Manifest'inizde belirtilen tetikleyici işlevleri, tek bir Card nesnesi veya eklenti arayüzünün farklı "sayfalarını" temsil eden bir Card nesneleri dizisi döndürmelidir. Eklentiniz, kullanıcı işlemlerine yanıt olarak yeni kartlar da oluşturabilir ve gösterebilir.
Apps Komut Dosyası'nda, CardBuilder sınıfını kullanarak kartlar oluşturursunuz. Her kart için bir CardHeader ve bir veya daha fazla CardSections gerekir. Her kart bölümünü, eklenti arayüzünü oluşturan widget'larla doldurmanız gerekir. Etkileşim widget'ları, etkileşim davranışlarını tanımlamak için genellikle işlemlere bağlanır.
Kartınıza tüm bölümleri ve widget'ları CardBuilder aracılığıyla ekledikten sonra, karşılık gelen Card nesnesini oluşturmak için CardBuilder.build() yöntemini çağırmanız gerekir.
Oluşturduğunuz eklenti kartlarında gösterilecek bilgileri almak için CalendarApp gibi diğer yerleşik Apps Script hizmetlerini kullanabilirsiniz.
Google dışı hizmetlerden getirilen verileri kullanabilirsiniz.
Eklentinizin OAuth gerektiren Google dışı API'lere erişmesi gerekiyorsa bu hizmeti yapılandırmanız ve bu hizmete bağlanmanız gerekir. Daha fazla bilgi için Google Dışı Hizmetlere Bağlanma kılavuzuna bakın.
Yapım siparişi
Kart oluştururken baştan sona oluşturmanız gerekir. Yani şu oluşturma sırasını kullanmanız gerekir:
- Widget'ı oluşturun.
- Widget'ı kart bölümüne ekleyin.
- Kart bölümündeki tüm widget'lar eklenene kadar işlemi tekrarlayın.
- Kart bölümünü karta ekleyin.
Bir karta veya kart bölümüne widget eklediğinizde aslında o widget'ın kopyasını eklemiş olursunuz. Bu nedenle bu işlem gereklidir. Ekledikten sonra widget nesnesinde yaptığınız değişiklikler nihai karta yansıtılmaz.
Evrensel işlemler
Bağlama bağlı olmayan işlevler sağlamak için evrensel işlemleri kullanabilirsiniz. Evrensel işlemler, hangi kartın görüntülendiğine bakılmaksızın eklenti kullanıcı arayüzünde bulunan menü öğeleridir. Tanımlanmış tüm evrensel işlemler, eklentinin kart menüsünde her zaman görünür.
Daha fazla bilgi için Evrensel işlemler bölümüne bakın.
Eklenti OAuth kapsamlarını doğrulama
Kapsamlar, eklentinin kullanıcı adına hangi işlemleri yapmasına izin verildiğini tanımlar. Eklentilerin, yalnızca çalışması için gerekli olan işlemlere yönelik kapsamlara sahip olması en iyi uygulamadır.
Eklenti projelerinde, eklentinin mümkün olan en dar kapsamlı izinlere sahip kapsam grubunu kullanmasını sağlamak için eklenti kapsamlarını açık bir şekilde ayarlayın. Eklentinizin hangi kapsamları kullandığını, manifest eklentisinde tanımlarsınız.
Daha ayrıntılı bilgi için Kapsamlar bölümüne bakın.
Eklentiyi test etme
Önce yayınlanmamış eklentiyi yükleyerek yayınlanmamış eklentileri test edebilirsiniz. Yüklenip yetkilendirildikten sonra eklentiyi hesabınızda kullanabilir ve genişlettiği ana uygulamalarda görünümünü ve davranışını test edebilirsiniz. Eklentinin bağlamlar ve kullanıcı işlemleri için beklendiği gibi davrandığını doğrulamanız gerekir.
Daha fazla bilgi için Google Workspace Eklentilerini test etme başlıklı makaleyi inceleyin.
Eklentiyi yayınlayın
Eklentinizi yayınladığınızda, herkese açık olarak veya yalnızca alanınızdaki kullanıcılara sunulur. Yayınlama sürecine başlamadan önce yayınlamaya genel bakış bölümünü inceleyin. Yayınlama, hazırlık ve zaman gerektiren karmaşık bir süreçtir.
Google Workspace Eklentileri, Google Workspace Marketplace'te yayınlanır. Herkese açık eklentiler yayınlanmadan önce uygulama incelemesinden geçmelidir.
Daha fazla bilgi için Google Workspace eklentisi yayınlama başlıklı makaleyi inceleyin.