Google Workspace eklentileri oluşturma

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:

1. Eklentinizin kullanıcılara sunulması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ın ve 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şturabilirsiniz. Karşılaştırma için "Apps Komut Dosyası ve HTTP uç noktaları: Hangisini seçmelisiniz?" başlıklı videoyu izleyin. 🤔".

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 Chat
• Google Dokümanlar
• Google Drive
• Google Meet
• Google E-Tablolar
• Google Slaytlar

Google Workspace uygulamaları için geliştirme yapma hakkında bilgi edinmek 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ş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 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.

Uyarı: Eklenti projelerinize ortak çalışan eklemezseniz, sahibin hesabı kapatılmadan veya kaldırılmadan önce bu projelerin sahipliğini devretmeniz gerekir. Aksi takdirde, eklenti koduna ve ayarlarına erişiminizi tamamen kaybedebilirsiniz.

Apps Komut Dosyası projeleri

Eklentinizi oluşturmadan önce Apps Script kotalarını ve sınırlamalarını inceleyerek proje tasarımınızın bu yönergelere uygun olduğundan emin olun. 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 seçenektir. Çok sayıda kullanıcıyı desteklemesi gereken, düşük gecikme süresi gerektiren veya altyapınız üzerinde tam kontrol sağlamanız gereken büyük ölçekli bir eklenti oluşturmayı planlıyorsanız farklı bir çalışma zamanı ortamında geliştirme yapmayı düşünebilirsiniz.

Eklentinizin Apps Komut Dosyası proje dosyalarını ortak bir Drive'da oluşturabilirsiniz. Böylece tek bir hesap, tek başına sahiplik hakkına sahip olmaz. Eklenti komut dosyası dosyanızı ortak bir sürücüye yerleştirmek, birden fazla katılımcının komut dosyası projesine erişmesini sağlar.

Bir eklentiyi yayınladığınızda tek bir kullanıcı hesabı yayıncı olarak hareket eder. 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ı makaleyi inceleyin.

Google Cloud projeleri

Eklentinin Cloud projesine ortak çalışanlar eklemenizi öneririz. Bu sayede, ekibinizden 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ı tasarlama ve yapılandırma

Eklentinizin nasıl görünmesini ve nasıl çalışmasını istediğinize karar verin. Eklentinin hangi kullanım alanlarında çözüm sunmaya çalışması gerektiğini düşünün. Önce çalışmaya başlamak için basit bir tasarımla başlayın, ardından daha fazla ayrıntı ekleyin.

İpucu: Basit bir ana sayfa kartıyla başlayın, ardından daha fazla widget, kart, gezinme ve başka davranışlar ekleyin. Ayrıca, ana makine uygulamasında kullanıcının yaptığı işlemlerle (ör. Gmail ileti dizisi veya Takvim etkinliği açma) tetiklenen bağlamsal kartları da düşünebilirsiniz.

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

Eklenti manifestini yapılandırma

Eklentinizi tasarladıktan sonra tasarımı eklenti manifestinde uygulamaya başlayabilirsiniz. Manifest, eklentinin Google Workspace ana makine uygulamaları da dahil olmak üzere görünüm ve davranışının büyük bir kısmını yapılandırdığınız yerdir.

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

Eklentinize kod ve özellikler eklerken gerekli eklenti görünümünü ve davranışını oluşturmak için manifesti gerektiği gibi düzenleyin.

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

Google Chat'i genişleten bir eklenti tasarladıysanız Chat uygulamasının görünümünü ve davranışını yapılandırmak için Google Chat API'yi kullanmanız gerekir. Adımlar için Google Chat uygulamasını yapılandırma başlıklı makaleye bakın.

Eklentiyi oluşturma

Eklenti için karta dayalı bir arayüz uygulamanız gerekir. Apps Komut Dosyası'nın Card hizmetini kullanın veya başka bir kod dilinde yazıyorsanız arayüzün kart olarak oluşturulması için uygun şekilde biçimlendirilmiş JSON döndürün.

Ayrıca, eklenti manifestinde belirtilen tetikleyici işlevleri de uygulamanız gerekir. Eklentiniz OAuth kullanarak üçüncü taraf bir Google dışı hizmete bağlanıyorsa bu hizmet için de OAuth'u yapılandırmanız gerekir.

Kart oluşturma

Card nesneleri oluşturup bunları widget'larla doldurarak bir eklenti kullanıcı arayüzü tanımlarsınız. Manifest dosyanızda belirtilen tetikleyici işlevler, 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 kart oluşturursunuz. Her kart için CardHeader ve bir veya daha fazla CardSections gerekir. Her kart bölümünü, eklenti arayüzünü oluşturan ayrı 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 CardBuilder aracılığıyla tüm bölümleri ve widget'ları ekledikten sonra, ilgili Card nesnesini oluşturmak için CardBuilder.build()'ı aramanız gerekir.

Not: Kart hizmetinde oluşturucu sınıfları kullanıldıktan sonra build() çağrılmaması tür hatalarına neden olur. Örneğin, tetikleyici işlevleri Card nesneleri döndürmelidir. Bunun yerine CardBuilder nesneleri döndürmek hataya neden olur.

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 alınan verileri kullanabilirsiniz.

Eklentinizin OAuth gerektiren Google dışı API'lere erişmesi gerekiyorsa bu hizmeti yapılandırıp hizmete bağlanmanız gerekir. Daha fazla bilgi için Google Dışı Hizmetlere Bağlanma Kılavuzu'na bakın.

İnşaat siparişi

Kart oluştururken yukarıdan aşağıya doğru oluşturmanız gerekir. Yani şu yapım sırasını kullanmanız gerekir:

1. Widget'ı oluşturun.
2. Widget'ı kart bölümüne ekleyin.
3. Kart bölümünde tüm widget'lar yer alana 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.

Uyarı: Bir widget'ı yalnızca oluşturma işlemini tamamladıktan sonra karta veya kart bölümüne ekleyin. Bir karta yalnızca widget'larıyla tamamen doldurulduktan sonra kart bölümü ekleyin. Eklendikten sonra widget'ları veya bölümleri değiştirmeyin. Eklenen bir widget'ta değişiklik yapmak istiyorsanız widget'ın eklendiği bölümü veya kartı yeniden oluşturmanız gerekir.

Evrensel işlemler

Bağlamdan bağımsız 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 kullanılabilen menü öğeleridir. Tanımlanan tüm evrensel işlemler, eklentinin kart menüsünde her zaman 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 hangi işlemleri yapmasına izin verildiğini tanımlar. Eklentilerin yalnızca çalışmak için gerekli olan kapsamları içermesi ve başka kapsam içermemesi en iyi uygulamadır.

Eklenti projelerinde, eklentinin mümkün olan en az izinli kapsam kümesini kullandığından emin olmak için eklenti kapsamlarını açıkça ayarlayın. Eklentinizin hangi kapsamları kullandığını eklenti manifestinde tanımlarsınız.

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. Yüklenip yetkilendirildikten sonra eklentiyi hesabınızda kullanabilir ve genişlettiği ana makine uygulamalarındaki görünümünü ve davranışını test edebilirsiniz. Eklentinin bağlamlar ve kullanıcı işlemleri için beklendiği gibi çalıştığını doğrulamanız gerekir.

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

• Apps Komut Dosyası Google Workspace eklentilerini test etme ve hatalarını ayıklama
• HTTP Google Workspace eklentilerini test etme ve hatalarını ayıklama
• Google Chat uygulamaları için etkileşimli özellikleri test etme

Eklentiyi yayınlama

Eklentinizi yayınladığınızda, herkese açık olarak veya yalnızca alanınızdaki kullanıcılar tarafından kullanılabilir. Yayınlama sürecine başlamadan önce yayınlamaya genel bakış bölümünü incelediğinizden emin olun. Yayınlama, tamamlanması için 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 olarak kullanılabilen eklentilerin yayınlanmadan önce uygulama incelemesini tamamlaması gerekir.

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