Yeni bir Google Workspace eklentisi oluşturmak istediğinizde şu genel prosedürü uygulayın:
- Eklentinizin projelerini oluşturun, bir sahip ve ortak çalışanlar 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, genişlettiği ana makine uygulamalarında test edin.
- Eklentiyi yayınlayın.
Eklenti projelerinizi oluşturun, sahip ve ortak çalışanları seçin
Eklentinizi Apps Komut Dosyası'nda derlerseniz hem Apps Komut Dosyası projesi hem de Google Cloud projesi oluşturursunuz. Eklentinizi Apps Komut Dosyası dışında bir dilde derlerseniz yalnızca bir Google Cloud projesi oluşturmanız gerekir.
Eklenti geliştirmeye başlamadan önce projelerin sahibi olmak için tek bir kullanıcı hesabı seçin ve diğer hangi hesapların ortak çalışan olduğuna karar verin. Projelerin sahibi proje dosyalarını ve ilişkili ayarları oluşturur ve yönetir. Ortak çalışanlar ise kodlama ve test yapma konusunda yardımcı olabilir.
Apps Komut Dosyası projeleri
Eklentinizin Apps Komut Dosyası proje dosyalarını ortak Drive'da oluşturabilirsiniz. Böylece tek bir hesabın sahibi tek bir hesap olmaz. Eklenti komut dosyası dosyanızı ortak Drive'a yerleştirmek, birden fazla ortak çalışanın komut dosyası projesine erişmesini sağlar.
Bir eklenti yayınladığınızda, tek bir kullanıcı hesabı yayıncı olarak işlev görür. Yayınlama hesabının, komut dosyası projesi için düzenleme erişimine sahip olması gerekir ancak bu hesabın sahip 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ışan eklemenizi öneririz. Bu sayede ekibinizdeki biri, 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ı tasarlayın
Oluşturmaya başlamadan önce eklentinizin nasıl görünmesini istediğinize ve nasıl davranması gerektiğine 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ı deneyiminizi nasıl tasarlayacağınızla 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. Manifest, Google Workspace Eklentileri için ana makine uygulamasının eklentiyi doğru şekilde görüntülemek 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 Komut Dosyası'nın Kart hizmetini kullanın veya başka bir kod dilinde yazıyorsanız arayüzün kart olarak oluşturulması için doğru biçimlendirilmiş JSON döndürün.
Eklenti manifestinde belirtilen tüm tetikleyici işlevlerini de uygulamanız gerekir. Eklentiniz OAuth kullanarak Google dışı bir üçüncü taraf hizmetine bağlanırsa OAuth'u bu hizmet için de yapılandırmanız gerekir.
Kart oluşturma
Eklenti kullanıcı arayüzünü, Card nesneleri oluşturarak ve bunları widget'larla doldurarak 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şturup gösterebilir.
Apps Komut Dosyası'nda, CardBuilder sınıfını kullanarak kartlar oluşturursunuz. Her kart bir CardHeader ve bir veya daha fazla CardSections gerektirir. 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ğlıdı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 Komut Dosyası hizmetlerini kullanabilirsiniz.
Google dışı hizmetlerden getirilen verileri kullanabilirsiniz.
Google Workspace Eklentilerinizin 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ışı Hizmetler'e 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'ı karta ekle bölümüne ekleyin.
- Kart bölümünde tüm widget'ları olana kadar işlemi tekrarlayın.
- Kart bölümünü karta ekleyin.
Bir karta veya kart bölümüne widget eklediğinizde gerçekte ilgili widget'ın kopyasını eklediğiniz için bu gereklidir. Widget nesnesini ekledikten sonra onda yaptığınız değişiklikler son karta yansıtılmaz.
Evrensel işlemler
Bağlamdan bağımsız işlevler sunmak için evrensel işlemleri kullanabilirsiniz. Evrensel işlemler, hangi kartın gösterildiğine bakılmaksızın eklenti kullanıcı arayüzünde bulunan menü öğeleridir. Tanımlanan tüm evrensel işlemler her zaman eklentinin kart menüsünde görünür.
Daha fazla ayrıntı 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 belirli bir sırayla işlemeleri gereken işlemler için kapsamlara sahip olmaları ve başka hiçbir şeye sahip olmamaları 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. Eklentiyi yükleyip yetkilendirdikten sonra hesabınızda kullanabilir ve genişlettiği ana makine uygulamalarında 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
Eklentiniz yayınlandığında, diğer kullanıcılara ya da herkese açık olarak veya yalnızca alanınızdaki kullanıcılara sunulur. Yayınlama sürecine başlamadan önce yayına genel bakış bölümünü incelediğinizden emin olun. Yayınlama, hazırlık ve tamamlamak için 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 incelemesini tamamlamalıdır.
Daha fazla bilgi için Google Workspace Eklentisini yayınlama bölümüne bakın.