Yeni bir Google Workspace eklentisi derlemek isterseniz aşağıdaki genel adımları uygulayın: prosedür:
- Eklentinizin projelerini oluşturun ve bir sahip seçin ve ortak çalışanlar.
- Eklentinizin görünümünü ve davranışını tasarlayın.
- Eklentinin proje manifestini yapılandırın veya dağıtım kaynağıdır.
- Eklentinin görünümünü tanımlayan ve gösterir.
- Eklentinizin OAuth kapsamlarını doğrulayın.
- Eklentiyi barındırma uygulamaları kapsamı genişliyor.
- 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şturmalısınız. Eklentinizi bir Google Cloud projesi oluşturmanız yeterlidir.
Eklenti geliştirmeye başlamadan önce tek bir projeleri sahipliği yapmak ve başka hangi hesapların 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ı'nı oluşturabilirsiniz. paylaşılan bir Drive'ı kullanarak tek bir hesabın sahibidir. Eklentiniz yerleştiriliyor komut dosyası, ortak Drive'ların birden çok ortak Drive'a erişmesini sağlar. komut dosyası projesidir.
Bir eklenti yayınladığınızda tek bir kullanıcı hesabı şu işlemleri yapar: sizin görevinizdir. Yayınlama hesabının, komut dosyası için 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ı makaleye göz atın.
Google Cloud projeleri
eklentisi Cloud projesi Bu sayede ekibinizdeki bir kişinin her zaman eklentinin Cloud ayarlarına gidin.
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
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? Hangi kullanım alanlarının çözüm sağlamaya çalışması gerekir. Başlat sade bir tasarıma sahip olduğundan emin olun.
Google Workspace eklentisi stil kılavuzuna göz atın. için talimatları izleyin. 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. Manifest, Google Workspace eklentileri için görüntülemek için ihtiyaç duyduğu bilgileri doğru şekilde yükleyin.
Apps Komut Dosyası'ndaki eklenti manifest'ini inceleyebilirsiniz.
Eklentinize kod ve özellik eklerken manifest'i gerektiği şekilde güncelleyin. görünüm ve davranış.
Eklentiyi kodlama
ekleyebilirsiniz. Apps Komut Dosyası'nın Kart hizmeti veya başka bir kod dilinde yazıyorsanız arayüzün kart olarak oluşturulması için doğru şekilde biçimlendirilmiş JSON.
Ayrıca, Google Etiket Yöneticisi'nde işlevleri manifest'ini kullanabilirsiniz. Eğer eklenti üçüncü taraf, Google dışı bir hizmete bağlandığında OAuth kullanıyorsanız bunun için OAuth'u yapılandırmanız gerekir hizmet de dahil edilecektir.
Kart oluşturma
Eklenti kullanıcı arayüzünü,
Card nesne ve bunları
Widget'lar. Şurada belirtilen tetikleme işlevleri:
manifest dosyanız, tek bir
Card nesnesi veya bir dizisi
Temsil edilen Card nesne
farklı "sayfalar" kontrol edebilirsiniz. Sizin
ayrıca, yeni kartlar da oluşturup
(kullanıcı işlemlerine yanıt)
Apps Komut Dosyası'nda, kartları oluşturmak için
CardBuilder sınıfı. Her biri
kart için CardHeader gerekiyor
ve bir veya daha fazla
CardSections. Şunları yapmalısınız:
her kart bölümünü, o kartı oluşturan widget'larla doldurmak
ekleyebilirsiniz. Etkileşim
widget'ları
genellikle eylemlerle bağlantılıdır;
nasıl empatiyle yaklaşıldığını gösterir.
Kartınız aracılığıyla kartınıza tüm bölümleri ve widget'ları ekledikten sonra
CardBuilder, şu numarayı aramalısınız:
CardBuilder.build()
kullanarak ilgili Card nesnesini oluşturun.
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.
Google Workspace Eklentilerinizin, OAuth gerektiren Google dışı API'lere erişmesi gerekiyorsa: ilgili hizmeti yapılandırmalı ve ona bağlanmalıdır; bkz. için Google Dışı Hizmetler rehberini inceleyebilirsiniz.
Yapım siparişi
Kart oluştururken baştan sona oluşturmanız gerekir. Yani, dönüşüm izleme amacıyla inşaat siparişi:
- 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.
Bu gereklidir çünkü bir karta veya kart bölümüne widget eklediğinizde aslında söz konusu widget'ın bir kopyasını ekliyor. 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 menü öğeleridir eklenti kullanıcı arayüzünde, hangi kartın görüntülenir. Tanımlanan tüm evrensel işlemler her zaman kart menüsünden erişebilirsiniz.
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 sıralı işlevi olmalı, başka hiçbir şey olmamalı.
Eklenti projelerinde, eklenti kapsamları Eklenti, en dar kapsamlı izinleri kullanan kapsamları kullanır yapmasını sağlar. Eklentinizin kullandığı kapsamları tanımlarsınız eklenti manifest dosyası için de kullanılabilir.
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 kullanabilirsiniz. incelendiği ana makine uygulamalarındaki görünümü ve davranışını uzatılır. 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ın, birtakım revizyonlar için ve tamamlaması gereken zaman dilimleridir.
Google Workspace Eklentileri, Google Workspace Marketplace'te yayınlanır. Herkese açık eklentiler önce uygulama incelemesini tamamlamalıdır olarak nitelendirilirler.
Google Workspace eklentisini yayınlama başlıklı makaleyi inceleyebilirsiniz.