Yeni bir Google Workspace Eklentisi oluşturmak istediğinizde şu genel prosedürü uygulayın:
- Eklentinizin projelerini ayarlayın ve bir sahip ile 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ımlamak için kod yazın.
- Eklentinizin OAuth kapsamlarını doğrulayın.
- Eklentiyi, genişlettiği ana makine uygulamalarında test edin.
- Eklentiyi yayınlayın.
Eklentinizin projelerini ayarlayın ve bir sahip ile 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, projelere sahip olacak 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şturup yönetir. Ortak çalışanlar ise kodlama ve test konusunda yardımcı olabilir.
Apps Komut Dosyası projeleri
Eklentinizin Apps Komut Dosyası proje dosyalarını paylaşılan sürücüde derleyerek tek bir hesabın tek sahiplik sahibi olmamasını sağlayabilirsiniz. Eklenti komut dosyası dosyanızı ortak Drive'a yerleştirmek, birden fazla ortak çalışanın komut dosyası projesine erişebilmesini sağlar.
Bir eklenti yayınladığınızda, tek bir kullanıcı hesabı yayıncı olarak hareket eder. Yayınlama hesabının, komut dosyası projesinde düzenleme erişimine sahip olması gerekir ancak sahip olması gerekmez.
Apps Komut Dosyası projesi oluşturmak için Komut dosyası projeleri başlıklı makaleyi inceleyin.
Google Cloud projeleri
Eklentinin Cloud projesine ortak çalışanlar eklemenizi öneririz. Bu sayede ekibinizden birinin her zaman eklentinin Cloud ayarlarına erişebilmesini sağlayabilirsiniz.
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 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. Çalışmaya başlamak için basit bir tasarımla başlayın, ardından daha fazla ayrıntı ekleyin.
Eklenti kullanıcı deneyiminizi nasıl tasarlayacağınıza ilişkin yönergeler için Google Workspace Eklentisi stil kılavuzuna bakın.
Eklenti proje manifestini yapılandırma
Apps Komut Dosyası projelerinde proje manifesti, özel bir JSON dosyasıdır. Projenin kitaplık bağımlılıkları gibi çeşitli ayrıntılarını belirtir. Manifest, Google Workspace eklentilerinde 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 Manifests sayfasını inceleyin.
Eklentinize kod ve özellikler eklerken, gerekli eklenti görünümünü ve davranışını oluşturmak için manifest'i 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 şekilde biçimlendirilmiş JSON hatası döndürün.
Eklenti manifestinde belirtilen tüm tetikleyici işlevlerini de uygulamanız gerekir. Eklentiniz, OAuth kullanarak Google dışı üçüncü taraf bir hizmete bağlanırsa OAuth'u bu hizmet için de yapılandırmanız gerekir.
Yapı kartları
Eklenti kullanıcı arayüzünü, Card nesneleri oluşturup bunları widget'larla doldurarak tanımlarsınız. Manifest'inizde belirtilen tetikleyici işlevleri, eklenti arayüzünün farklı "sayfalarını" temsil eden tek bir Card nesnesini veya Card nesneleri dizisi döndürmelidir. Eklentiniz, kullanıcı işlemlerine yanıt olarak yeni kartlar da oluşturabilir ve görüntüleyebilir.
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 gereklidir. Her kart bölümünü, eklenti arayüzünü oluşturan bağımsız widget'larla doldurmanız gerekir. Etkileşim widget'ları, etkileşim davranışlarını tanımlamak için genellikle eylemlerle bağlantılıdır.
CardBuilder aracılığıyla kartınıza tüm bölümleri ve widget'ları ekledikten sonra ilgili Card nesnesini oluşturmak için CardBuilder.build() yöntemini çağırmanız gerekir.
Derlediğiniz eklenti kartlarında görüntülenecek 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 bağlamanız gerekir. Daha fazla bilgi için Google Dışı Hizmetler'e bağlanma rehberini inceleyin.
İnşaat siparişi
Kart oluştururken en üstten 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ü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, aslında bu widget'ın bir kopyasını eklemiş olursunuz. Widget nesnesini ekledikten sonra 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ımlanmış 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 çalışması için gereken işlemler için kapsamlarının olması ve başka hiçbir şeyin olmaması en iyi uygulamadır.
Eklenti projelerinde, eklentinin mümkün olan en dar kapsamlı kapsam grubunu kullanmasını sağlamak için eklenti kapsamlarını açık bir şekilde ayarlayın. Eklentinizin hangi kapsamları kullandığını eklenti manifestinde tanımlarsınız.
Daha ayrıntılı bilgi için Kapsamlar bölümüne bakın.
Eklentiyi test etme
Önce yayından kaldırılmış eklentiyi yükleyerek yayınlanmamış eklentileri test edebilirsiniz. Eklentiyi yüklenip yetkilendirildikten 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
Eklentinizi yayınlamak, herkesin veya yalnızca alanınızdaki kullanıcıların kullanımına sunar. Yayınlama sürecine başlamadan önce yayına genel bakış bölümünü incelediğinizden emin olun. Yayın, hazırlık ve tamamlanması 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.