Eski Gmail ve Takvim eklentilerini yeni sürüme geçirme

.

Not: Düzenleyici eklentilerini, şu an için doğrudan Google Workspace Eklentilerine yükseltmek mümkün değildir. Daha fazla bilgi için Düzenleyici Eklentimi yükseltebilir miyim? başlıklı makaleyi inceleyin.

Gmail veya Takvim'i genişletmek için daha önce bir eklenti oluşturup yayınladıysanız bunu bir Google Workspace eklentisine yükseltebilirsiniz. Bu sayfadaki talimatlar, Google Workspace işlevlerini mevcut Gmail veya Takvim eklentilerinize Ardından, keşfedilebilmesi ve yüklenebilmesi için yeni sürüme geçirilmiş eklentinizi yayınlayın.

Yeni işlevleri orijinal cihazınıza aktarabilirsiniz eklentisidir. Planınızı yükselttiğinizde, Google Workspace Eklentisi'nin yeni özelliklerinden yararlanabilirsiniz. ana sayfalar gibi.

Not: Gmail eklentilerinizi ve Takvim konferansı eklentilerinizi yükseltmezseniz genel bir ana sayfaya sahip olan Google Workspace Eklentileri'ne otomatik olarak yükseltilecekler. Girişinizde veya geliştirici kodunuzda herhangi bir değişiklik gerekmez. Eklenti, yalnızca orijinal sürümünde kullanılabilir. barındırma uygulamasına gidin. Google Workspace Marketplace'te, sürüm otomatik olarak yeni sürüme geçirildi Eklentiler "Gmail ile çalışır" veya "Takvim ile çalışır" bölümlerinde listelenir %30'un üzerinde artış gösterdi.

1. Adım: Eklentinizin Apps Komut Dosyası projesinin bir kopyasını oluşturun

Yükseltilmiş eklentiniz, yayınladığınız Google Cloud projesini kullanır ancak burada kullandığınız Google Apps'ın bir kopyasını oluşturup Test sırasında mevcut kullanıcılarınızın etkilenmemesi için komut dosyası projesi yükseltilmiş sürüm. Orijinal komut dosyası projesinin bir kopyasını da yeni sürüme geçirme Böylece her zaman orijinal koda erişebilir ve dilerseniz daha sonra yeniden dağıtabilirsiniz. gerekir.

1. Mevcut Gmail eklentinizi veya Takvim konferans eklentisi Apps Komut Dosyası'nı açın. belirler.
2. Solda Genel bakış'ı tıklayın. .
3. Sağda Kopya oluştur'u tıklayın.
4. Solda Proje Ayarları > Projeyi değiştir.
5. GCP Proje Numarası'nı tıklayın.
6. Aynısını girin proje numarası mevcut, yayınlanmış eklentiniz olan Apps Komut Dosyası projenizle ilişkilendirilir.
7. Proje ayarla'yı tıklayın.

Uyarı: Herkese açık eklentilerin Apps Komut Dosyası projesini doğrudan yükseltmeyin. İhtiyacınız olanlar yeni sürüme geçirilen sürümü herkese açık sürümden ayrı tutmak için bir kopya oluşturmak inşaat ve test aşamasında rol oynar.

2. Adım: Google Workspace eklentisini entegre edin

Eklemek istediğiniz tüm Google Workspace eklentisi özelliklerini tasarlayıp uygulamanız gerekir ekleyebilirsiniz.

1. Eklentinizde hangi içeriğin gösterileceğini planlayın ana sayfa kartlarının ve bu kartların Gmail, Takvim, Drive veya bu üçünün herhangi bir kombinasyonunda görünür ana makineler. Bir ana sayfanın birden fazla ana makinede olmasını istiyorsanız ana makinenin Aynı ana sayfa olabilir veya her ana makine için özel ana sayfa kartları istiyorsanız özel ana sayfa kartları kullanabilirsiniz.
2. Kopyaladığınız Apps Komut Dosyası eklentisi projenizde ana sayfanızı oluşturun. homepageTrigger içeren kartlar işlevlerine dahildir. Projeyi tamamlamak için gereken destekleyici fonksiyonları veya mantığı yeni ana sayfa arayüzlerinizi denetleyin.

3. Kullanıcının işlemi tarafından tetiklenen bağlamsal kartlar ekleyebilirsiniz. Örneğin, Gmail ileti dizisi veya Takvim etkinliği.

   Dikkat: Yeni sürüme geçirilen eklentiler, Gmail iletileri için farklı bir kimlik değeri alır. daha fazla satış elde edebilirsiniz. Bu değişiklik yalnızca messageId öğesini kalıcı depolama alanlarında anahtar olarak kullanın. Gerekirse, Gmail API ile eski kimlik değerlerini alma. Gmail API'si messages().get() yöntem hem yeni hem de eski kimlik değerlerini kabul eder ancak yalnızca eski kimlik değerlerini döndürür.

4. Etkinlik nesnelerinin erişimlerini güncelleme eklentinizde (Widget geri çağırma işlevlerinde veya bağlamsal tetikleyicide) işlevleri) etkinlik nesne yapısı hakkında daha fazla bilgi edinin. Yeni yapı, hâlâ Gmail ve Takvim konferans eklentileri, ancak bu orijinal alanlar desteği sonlandırılmış ve bir süre sonra tamamen kaldırılacak.

3. Adım: Eklentinizin manifest dosyasını güncelleyin

Yapılandırma bilgilerinin manifest yapısını Google Workspace Eklentileri, Gmail eklentilerinin yapısına göre önemli ölçüde değişti ve Takvim konferansı eklentilerinin kullanımı. Eklentinizi yeni sürüme geçirirken eklentinizin Apps Komut Dosyası projesinin manifest alanlarını, özetleyelim. İlgili tüm alt mülkleri addOns mülkündeki her mülk.

Manifest dosyanızı güncelleyerek oauthScopes alanını gereken izinleri yansıtması için gereken izinleri vermelisiniz.

Google Workspace eklentisi manifest dosyaları hakkında daha fazla bilgi edinmek için: Manifestler bölümüne bakın.

Gmail eklentileri

Orijinal manifest alanı	İşlem gerekli
gmail.composeTrigger	addOns.gmail.composeTrigger adlı cihaza taşıyın.
gmail.contextualTriggers[]	Listeyi addOns.gmail.contextualTriggers[] hedefine taşıyın.
gmail.logoUrl	addOns.common.logoUrl adlı cihaza taşıyın.
gmail.name	addOns.common.name adlı cihaza taşıyın.
gmail.openLinkUrlPrefixes[]	Listeyi addOns.common.openLinkUrlPrefixes[] hedefine taşıyın.
gmail.primaryColor	addOns.common.layoutProperties.primaryColor adlı cihaza taşıyın.
gmail.secondaryColor	addOns.common.layoutProperties.secondaryColor adlı cihaza taşıyın.
gmail.universalActions[]	Listeyi addOns.common.universalActions[] hedefine taşıyın.
gmail.universalActions[].text	Her gmail.universalActions[].text alanını bir karşılık gelen addOns.common.universalActions[].label girin.
gmail.useLocalFromApp	addOns.common.useLocaleFromApp adlı cihaza taşıyın.

Takvim konferansı eklentileri

Orijinal manifest alanı	İşlem gerekli
calendar.createSettingsUrlFunction	addOns.calendar.createSettingsUrlFunction adlı cihaza taşıyın.
calendar.conferenceSolution[]	addOns.calendar.conferenceSolution[] adlı cihaza taşıyın.
calendar.logoUrl	addOns.common.logoUrl adlı cihaza taşıyın.
calendar.name	addOns.common.name adlı cihaza taşıyın.

4. Adım: Yükseltilmiş eklentinizi test edin

Yükseltilmiş eklentinizi yayınlamadan önce test etmek için Google Workspace Eklentilerini test etme başlıklı makaleyi inceleyin.

5. Adım: Yükseltilmiş eklentinizin incelenmesini isteyin

Tüm Google Workspace eklentileri, ister yükseltilmiş bir eklenti ister sıfırdan oluşturulmuş bir eklenti olsun, Google Workspace Marketplace'te listelenmeden önce onaylanmaları gerekir.

Eklentinizi incelemeye göndermek için aşağıdaki adımları uygulayın:

1. Eklentinizin tüm gereksinimleri karşıladığından emin olun eklenti yayınlama gereksinimlerini inceleyin.

2. Sürümü olan dağıtım oluşturma eklentinizin (yeni Apps Komut Dosyası projesinde) kodu girin. Başlık kullanarak yayınlamaya çalışmayın dağıtım.

3. Eklentinizi yükseltirken yeni kapsamlar eklediyseniz OAuth doğrulaması isteme. Örneğin, Gmail eklentiniz Google Workspace eklentisi sürümünü kullanıyorsanız bu yeni kapsamları doğrulanmak üzere göndermeniz gerekir. Doğrulamanın tamamlanması genellikle birkaç gün sürer. Bu nedenle, işlemi erkenden belirleyin. Devam etmeden önce eklentinizin doğrulandığından emin olun 6. Adım'a geçin.

6. Adım: Yükseltilmiş eklentinizi kullanılabilir hale getirin

1. Google Workspace Marketplace SDK'sını açın.

2. Solda, Yapılandırma'yı tıklayın. Bu panelde, ve eklentiniz hakkında bilgi verir.

3. Google Workspace Eklentisi'nin yeni işlevlerini yansıtacak şekilde düzenleyin.

4. Uzantılar'ın altında Şuna yükselt: Google Workspace Eklentisi düğmesi. Görüntülenen metin kutusuna, için oluşturduğunuz yeni dağıtım kimliğini girin Google Workspace Eklentinizi gözden geçirin. Dağıtım kimliğiniz geçerliyse desteklenen ana makinelerin listesi görünür.

   Dikkat: Eklentinizi bu şekilde bir Google Workspace eklentisine yükseltmek, tek seferlik bir işlemdir bu işlem geri alınamaz.

5. Google Workspace Eklentinize yeni kapsamlar eklediyseniz bunları Yapılandırma sayfasındaki OAuth 2.0 kapsamları bölümüne gidin. Listelenen kapsamlar Bu bölümdeki, eklentinizin manifest'ini kullanabilirsiniz.

6. Forma girdiğiniz bilgilerin doğru olduğunu onaylayın. Ardından, Değişiklikleri kaydet'i tıklayın.

Google Workspace eklentisine yönelik bu yükseltme sırasında sorularınız olursa veya bir sorunla karşılaşırsanız bize ulaşın.

SSS

Eklenti yükseltmeleriyle ilgili sık sorulan soruları aşağıda bulabilirsiniz:

Düzenleyici eklentimi yükseltebilir miyim?

Çoğu Düzenleyici eklentisi, Google Workspace Eklentilerine taşınabilir. Ancak her halükarda Google Workspace Eklentileri'ne yükseltilen Google eklentilerini, Gmail ve Takvim.

Düzenleyici Eklentinizi bir Google Workspace eklentisine taşımak istiyorsanız: Eklentinin kullanıcı arayüzünü HTML'den Kart tabanlı arayüzünü ve JavaScript kodunuzu güncelleyin Kart Hizmeti'ne ileteceksiniz.

Mevcut Düzenleyici Eklentinizdeki bazı hizmetler Kart Hizmeti. Örneğin, Düzenleyici Eklentiniz bir dosya seçici içeriyorsa Google Workspace Eklentileri için Kart Hizmeti'nde sunulan bir eşdeğeri değildir.

Ayrı bir Google Workspace eklentisi oluşturup mevcut eklentimi kullanmaya devam edebilir miyim?

Dilerseniz farklı marka adları, Ancak Google Workspace Eklentinizle aynı marka adına sahip olmalıdır. Sorularınız varsa veya bize ulaşın.

Eklenti yeni sürüme geçirildikten sonra kullanıcılarımın yeniden yetkilendirmesi gerekir mi?

Google Workspace Eklentiniz, aynı temel Cloud Platform (GCP) projesi bir OAuth istemci kimliği kullanıyorsanız kullanıcılarınızın yeniden yetkilendirme yapması gerekmez. orijinal eklentiniz için daha önce yetki verdikleri izinler bulunmalıdır. Ancak, yükseltme işlemi sırasında yeni kapsamlar eklerseniz, kullanıcılarınızın bu kapsamları yetkilendirmesi ilk kez kullandıklarında yeni kapsamları sürümünü kullandığınızdan emin olun.

Chrome uzantımı Google Workspace eklentisine yükseltebilir ve kullanıcıları aktarabilir miyim?

Hayır. Bir Chrome uzantısının kullanıcılarını, yüklemelerini ve listelemesini aktaramazsınız inceleme. Yeni bir Google Workspace eklentisi oluşturmanız ve Chrome'unuzun kullanıcılarını yönlendirmeniz gerekir. Google Workspace Marketplace'e genişletildi.

Google Workspace Eklentimle birden fazla eklentiyi paket halinde sunabilir miyim?

Uygulama entegrasyonlarını birlikte listeleme başlıklı makaleye göz atın.