Google Workspace Eklentileri oluşturun

Yeni bir Google Workspace eklentisi derlemek isterseniz aşağıdaki genel adımları uygulayın: prosedür:

  1. Eklentinizin projelerini oluşturun ve bir sahip seçin ve ortak çalışanlar.
  2. Eklentinizin görünümünü ve davranışını tasarlayın.
  3. Eklentinin proje manifestini yapılandırın veya dağıtım kaynağıdır.
  4. Eklentinin görünümünü tanımlayan ve gösterir.
  5. Eklentinizin OAuth kapsamlarını doğrulayın.
  6. Eklentiyi barındırma uygulamaları kapsamı genişliyor.
  7. Eklentiyi yayınlayın.

Eklentinizin projelerini oluşturun, sahip ve ortak çalışan seçin

Eklentinizi Apps Komut Dosyası'nda derlerseniz hem Apps Komut Dosyası projesi hem de Google Cloud projesi oluşturmalısınız. Eklentinizi bir Google Cloud projesi oluşturmanız yeterlidir.

Eklenti geliştirmeye başlamadan önce tek bir ve başka hangi hesapların sahipleneceğini birlikte çalışır. Projelerin sahibi proje dosyalarını oluşturur ve yönetir ve ilişkilendirilmiş ayarlara erişimi vardır. Ortak çalışanlar ise 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 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, 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

Eklentinizin nasıl görünmesini istediğinize ve nasıl görünmesini istediğinize karar verin oluşturmaya başlamadan önce nasıl davranması gerekir? Eklentinin hangi kullanım alanlarına çözüm sunmaya çalışması gerektiğini düşünün. Başlatın sade bir tasarıma sahip olduğundan emin olun.

Google Workspace eklentisi stil kılavuzuna göz atın. hakkında daha fazla bilgi için sunmaktır.

Eklenti projesi manifestini yapılandırma

Apps Komut Dosyası projelerinde proje manifesti, özel bir JSON dosyasıdır. dosyası olarak kaydedebilirsiniz. Projeyle ilgili çeşitli ayrıntıları belirtir (örneğin, projenin kitaplığı gibi) ve bildirmeyi konuştuk. 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.

Eklentinizin Apps Script'teki manifestini yapılandırmayla ilgili ayrıntılar için Manifestler başlıklı makaleyi inceleyin.

Eklentinize kod ve özellik eklerken manifest'i gerektiği şekilde güncelleyin. görünüm ve davranış.

Eklentiyi kodlama

ekleyebilirsiniz. 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.

Ayrıca, Google Etiket Yöneticisi'nde işlevleri manifest'ini kullanabilirsiniz. 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 dosyanızda belirtilen tetikleyici işlevler, tek bir Card nesnesi veya eklenti arayüzünün farklı "sayfalarını" temsil eden bir Card nesnesi 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ı genellikle eylemlerle bağlantılıdır; gösterip göstermediğini görebilirsiniz.

Tüm bölümleri ve widget'ları kartınızın CardBuilder aracılığıyla ekledikten sonra, ilgili Card nesnesini oluşturmak için CardBuilder.build() işlevini çağırmanız gerekir.

Diğer yerleşik Apps Komut Dosyası'nı kullanabilirsiniz. çeşitli hizmetler Almak için CalendarApp kartlarınızda gösterilmesi gereken bilgilerdir. Google dışı hizmetlerden getirilen verileri kullanabilirsiniz.

Eklentinizin 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ışı hizmetlere bağlanma kılavuzuna bakın.

İnşaat siparişi

Kart oluştururken baştan sona oluşturmanız gerekir. Yani şu oluşturma sırasını kullanmanız gerekir:

  1. Widget'ı oluşturun.
  2. Widget'ı karta ekle bölümüne ekleyin.
  3. Kart bölümündeki tüm widget'lar eklenene kadar işlemi tekrarlayın.
  4. 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. Widget'ta yaptığınız tüm değişiklikler bu nesne son karta yansıtılmaz.

Evrensel işlemler

Evrensel işlemleri kullanabilirsiniz bağlamdan bağımsız işlevler sunmaktır. 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 konusuna bakın bolca fırsat sunuyor.

Eklenti OAuth kapsamlarını doğrulama

Kapsamlar, kullanıcı adına işlem yapmasına izin verildiğini varsayalım. Bu bir en iyi uygulama olarak, eklentilerin yalnızca kendi düzgün çalışması gerekir.

Eklenti projelerinde, eklenti kapsamlarının Eklenti, en dar kapsamlı izinleri kullanan kapsamları kullanır yapmasını sağlar. Eklentinizin kullandığı kapsamları eklenti manifestinde tanımlarsınız.

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

Eklentiyi test etme

Yayınlanmamış eklentileri, ilk önce yayından kaldırıldı ekleyebilirsiniz. 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 aşağıdaki gibi davrandığını doğrulamanız gerekir: beklenen sonucu verir.

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ılarla paylaşabilirsiniz. Yayınlamaya başlamadan önce yayına genel bakış makalesini incelemeyi unutmayın. 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.