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

Gmail veya Takvim'i genişletmek için daha önce oluşturduysanız ve yayınladıysanız bu eklentiyi Google Workspace eklentisine yükseltebilirsiniz. Bu sayfada, mevcut Gmail veya Takvim eklentilerinize Google Workspace işlevlerini nasıl ekleyeceğiniz ve ardından yükseltilen eklentinizi keşfedilip yüklenebileceği şekilde nasıl yayınlayacağınız ayrıntılı olarak açıklanmıştır.

Google Workspace Marketplace girişinizi, yüklemelerinizi ve kullanıcılarınızı korumak için yeni işlevi orijinal eklentinize aktarabilirsiniz. Yükseltme işlemi, ana sayfalar gibi yeni Google Workspace eklenti özelliklerinden de yararlanmanıza olanak tanır.

1. adım: Eklentinizin Apps Script projesinin bir kopyasını oluşturun

Yükseltilen eklentiniz, yayınlanan eklentinizle aynı Google Cloud projesini kullanır. Ancak, yükseltilen sürümü test ederken mevcut kullanıcılarınızın etkilenmemesi için temel Apps Komut Dosyası projesinin bir kopyasını oluşturup kullanmanız önemlidir. Orijinal komut dosyası projesinin bir kopyasını yükseltmek, orijinal koda her zaman erişebileceğiniz ve gerekirse daha sonra yeniden dağıtabileceğiniz anlamına da gelir.

  1. Mevcut Gmail eklentinizi veya Takvim konferansı eklentinizi içeren Apps Script projenizi açın.
  2. Sol tarafta Genel bakış'ı tıklayın.
  3. Sağ tarafta, Kopya oluştur'u tıklayın.
  4. Sol tarafta, Proje Ayarları > Projeyi değiştir'i tıklayın.
  5. GCP Proje Numarası'nı tıklayın.
  6. Mevcut, yayınlanmış Apps Komut Dosyası eklenti projenizle ilişkili proje numarasını girin.
  7. Proje ayarla'yı tıklayın.

2. adım: Google Workspace eklentisini entegre edin

Eklentinize eklemek istediğiniz Google Workspace eklentisi özelliklerini tasarlayıp uygulamanız gerekir.

  1. Eklentinizin ana sayfa kartlarında hangi içeriklerin gösterileceğini ve bu içeriklerin Gmail, Takvim, Drive'da veya bu üç ana makinenin herhangi bir kombinasyonunda gösterilip gösterilmeyeceğini planlayın. Birden fazla ana makinede ana sayfa kullanmak istiyorsanız aynı ana sayfanın kullanılıp kullanılamayacağına veya her ana makine için özel ana sayfa kartları kullanmak isteyip istemediğinize karar verin.
  2. Kopyalanan eklenti Apps Komut Dosyası projenizde, ana sayfa kartlarınızı homepageTrigger işlevleriyle oluşturun. Yeni ana sayfa arayüzlerinizi kontrol etmek için gereken tüm destekleyici işlevleri veya mantığı eklediğinizden emin olun.
  3. Kullanıcının yaptığı işlemler (ör. Gmail ileti dizisi veya Takvim etkinliği açma) tarafından tetiklenen bağlama dayalı kartlar ekleyebilirsiniz.

  4. Güncellenen etkinlik nesnesi yapısını kullanmak için eklentinizdeki etkinlik nesnelerine erişimi (widget geri çağırma işlevlerinde veya bağlama dayalı tetikleyici işlevlerinde) güncelleyin. Yeni yapıda, Gmail ve Takvim konferans eklentileri tarafından kullanılan etkinlik nesnesi alanları hâlâ mevcuttur ancak bu orijinal alanlar desteği sonlandırılmıştır ve zaman içinde kaldırılacaktır.

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

Google Workspace eklentilerinin manifest yapısında yapılandırma bilgilerinin depolanma şekli, Gmail eklentilerinin ve Takvim konferansı eklentilerinin kullandığı yapıdan önemli ölçüde farklıdır. Eklentinizi yeni sürüme geçirirken eklentinizin Apps Script projesinin manifest alanlarını aşağıdaki tablolara göre güncellemeniz gerekir. İlgili tüm alt mülkleri yeni addOns mülküyle güncellemeniz gerekir.

Güncellenen eklentinizin gerektirdiği izinleri yansıtmak için manifest'inizin oauthScopes alanını da gerektiği gibi güncellediğinizden emin olun.

Google Workspace eklentisi manifestleri hakkında daha fazla bilgi edinmek için Manifestler başlıklı makaleyi inceleyin.

Gmail eklentileri

Orijinal manifest alanı İşlem gerekli
gmail.composeTrigger addOns.gmail.composeTrigger konumuna gidin.
gmail.contextualTriggers[] Listeyi addOns.gmail.contextualTriggers[]'e taşıyın.
gmail.logoUrl addOns.common.logoUrl konumuna gidin.
gmail.name addOns.common.name konumuna gidin.
gmail.openLinkUrlPrefixes[] Listeyi addOns.common.openLinkUrlPrefixes[]'e taşıyın.
gmail.primaryColor addOns.common.layoutProperties.primaryColor konumuna gidin.
gmail.secondaryColor addOns.common.layoutProperties.secondaryColor konumuna gidin.
gmail.universalActions[] Listeyi addOns.common.universalActions[]'e taşıyın.
gmail.universalActions[].text Her gmail.universalActions[].text alanını ilgili addOns.common.universalActions[].label alanına taşıyın.
gmail.useLocalFromApp addOns.common.useLocaleFromApp konumuna gidin.

Takvim konferans görüşmesi eklentileri

Orijinal manifest alanı İşlem gerekli
calendar.createSettingsUrlFunction addOns.calendar.createSettingsUrlFunction'e gidin.
calendar.conferenceSolution[] addOns.calendar.conferenceSolution[] konumuna gidin.
calendar.logoUrl addOns.common.logoUrl konumuna gidin.
calendar.name addOns.common.name konumuna gidin.

4. Adım: Yükseltilen eklentinizi test edin

Yükselttiğiniz eklentiyi yayınlamadan önce test etmek için Google Workspace eklentilerini test etme başlıklı makaleyi inceleyin.

5. Adım: Yükseltilen eklentinizin incelenmesini isteyin

Yükseltilmiş eklentiler veya sıfırdan oluşturulan tüm Google Workspace eklentileri, Google Workspace Marketplace'te listelenmeden önce onaylanmalıdır.

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

  1. Eklentinizin tüm eklenti yayınlama şartlarını karşıladığından emin olun.

  2. Yayınlamak istediğiniz kod sürümünü kullanarak Google Workspace eklentinizin (yeni Apps Komut Dosyası projesinde) sürümlü bir dağıtımı oluşturun. Baş dağıtım kullanarak yayınlamaya çalışmayın.

  3. Eklentinizi yükseltirken yeni kapsamlar eklediyseniz OAuth doğrulaması isteğinde bulunmanız gerekir. Örneğin, Gmail eklentiniz Google Workspace eklentisi sürümünde yeni Drive veya Takvim kapsamları kullanıyorsa bu yeni kapsamları doğrulama için göndermeniz gerekir. Doğrulama işleminin tamamlanması genellikle birkaç gün sürer. Bu nedenle, işlemi mümkün olduğunca erken başlatın. 6. adıma geçmeden önce eklentinizin doğrulandığından emin olun.

6. Adım: Yükselttiğiniz eklentiyi kullanıma sunun

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

  2. Sol tarafta Yapılandırma'yı tıklayın. Bu panelde, eklentinizle ilgili bilgi vereceğiniz bir form bulunur.

  3. Girişinizin kısa açıklamasını, ayrıntılı açıklamasını ve ekran görüntülerini Google Workspace eklentisinin yeni işlevini yansıtacak şekilde güncelleyin.

  4. Uzantılar bölümünde Google Workspace eklentisine yükselt düğmesini tıklayın. Görüntülenen metin kutusuna, önceki adımda Google Workspace eklentiniz için oluşturduğunuz yeni dağıtım kimliğini girin. Dağıtım kimliğiniz geçerliyse desteklenen ana makinelerin listesi gösterilir.

  5. Google Workspace eklentinize yeni kapsamlar eklediyseniz bunları Yapılandırma sayfasındaki OAuth 2.0 kapsamları bölümüne eklediğinizden emin olun. Bu bölümde listelenen kapsamlar, eklentinizin manifest dosyasında listelenen kapsamlarla tam olarak eşleşmelidir.

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

Bu Google Workspace eklentisi yükseltme işlemi 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?

Düzenleyici eklentilerinin çoğu Google Workspace eklentilerine taşınabilir. Ancak bu eklentiler, Gmail ve Takvim eklentileri kadar kolay bir şekilde Google Workspace eklentilerine yükseltilemez.

Düzenleyici eklentinizi Google Workspace eklentisine taşımak istiyorsanız eklentinin kullanıcı arayüzünü HTML'den kart tabanlı bir arayüze yeniden yazmanız ve JavaScript'i işleme yönteminizi Card Service ile güncellemeniz gerekir.

Mevcut Düzenleyici eklentinizdeki bazı hizmetler Kart Hizmeti'nde kullanılamayabilir. Örneğin, Düzenleyici eklentiniz bir dosya seçici içeriyorsa Google Workspace eklentileri için Kart Hizmeti'nde eşdeğer bir seçenek yoktur.

Ayrı bir Google Workspace eklentisi oluşturup mevcut eklentiyi saklayabilir miyim?

Farklı marka adları altında ek Google Workspace eklentileri oluşturabilirsiniz ancak Google Workspace eklentinizle aynı marka adı altında ayrı Gmail veya Takvim konferans eklentilerine izin verilmez. Sorunuz varsa veya istisna talebinde bulunmak istiyorsanız bize ulaşın.

Yükseltme işleminden sonra kullanıcılarımın eklentiyi yeniden yetkilendirmesi gerekir mi?

Google Workspace eklentiniz, ilişkili bir OAuth istemci kimliğiyle aynı temel Cloud Platform (GCP) projesini kullandığı sürece kullanıcılarınızın, orijinal eklentiniz için daha önce yetkilendirdikleri izinleri yeniden yetkilendirmesi gerekmez. Ancak yükseltme işlemi sırasında yeni kapsamlar eklerseniz kullanıcılarınızın, eklentinizin Google Workspace sürümünü ilk kez kullanırken bu yeni kapsamları yetkilendirmesi gerekir.

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

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

Google Workspace eklentimle birden fazla eklentiyi paket hâline getirebilir miyim?

Uygulama entegrasyonlarını birlikte listeleme başlıklı makaleyi inceleyin.