Gmail veya Takvim'i genişletmek için daha önce oluşturduğunuz ve yayınladığınız bir eklentiyi Google Workspace eklentisine yükseltebilirsiniz. Bu sayfadaki talimatlarda, mevcut Gmail veya Takvim eklentilerinize Google Workspace işlevlerinin nasıl ekleneceği ve ardından yükseltilmiş eklentinizin keşfedilip yüklenebilmesi için nasıl yayınlanacağı ayrıntılı bir şekilde açıklanmaktadır.
Google Workspace Marketplace girişinizi, yüklemelerinizi ve kullanıcılarınızı korumak için yeni işlevleri orijinal eklentinize aktarabilirsiniz. Yeni sürüme geçtiğinizde ana sayfalar gibi yeni Google Workspace eklentisi özelliklerinden yararlanabilirsiniz.
1. Adım: Eklentinizin Apps Komut Dosyası projesinin bir kopyasını oluşturun.
Yükseltilmiş eklentiniz, yayınlanan eklentinizle aynı Google Cloud projesini kullanır ancak siz yükseltilmiş sürümü test ederken mevcut kullanıcılarınızın etkilenmemesi için temel Apps Komut Dosyası projesinin bir kopyasını oluşturmanız ve kullanmanız önemlidir. Orijinal komut dosyası projesinin bir kopyasının yükseltilmesi, orijinal koda her zaman erişebileceğiniz ve gerekirse daha sonra kodu yeniden dağıtabileceğiniz anlamına da gelir.
- Mevcut Gmail eklentinizi veya Takvim konferansı eklentisi Apps Komut Dosyası projesini açın.
- Solda, Genel Bakış'ı tıklayın .
- Sağda, Kopya oluştur'u tıklayın.
- Solda Proje Ayarları > Projeyi değiştir'i tıklayın.
- GCP Proje Numarası'nı tıklayın.
- Yayınlanmış mevcut eklenti Apps Komut Dosyası projenizle ilişkilendirilmiş proje numarasını girin.
- Proje ayarla'yı tıklayın.
2. adım: Google Workspace Eklentisini entegre edin
Eklentinize eklemek istediğiniz tüm Google Workspace Eklentisi özelliklerini tasarlamanız ve uygulamanız gerekir.
- Eklentinizin ana sayfa kartlarında hangi içeriğin gösterileceğini ve bunların Gmail, Takvim, Drive veya üç ana makinenin herhangi bir kombinasyonunda görünüp görünmeyeceğini planlayın. Bir ana sayfanın birden fazla ana makinede olmasını istiyorsanız, ana sayfanın aynı ana sayfa olup olmayacağına veya her bir ana makine için özel ana sayfa kartları mı istediğinize karar verin.
- Kopyaladığınız Apps Komut Dosyası eklentisinde ana sayfa kartlarınızı
homepageTriggerişlevleriyle oluşturun. Yeni ana sayfa arayüzlerinizi kontrol etmek için gereken destekleyici işlevleri veya mantığı eklediğinizden emin olun. Gmail ileti dizisi veya Takvim etkinliği açma gibi, kullanıcının işlemi tarafından tetiklenen içeriğe dayalı kartlar ekleyebilirsiniz.
Eklentinizdeki (widget geri çağırma işlevlerinde veya bağlamsal tetikleyici işlevlerinde) etkinlik nesnelerinin tüm erişimlerini, güncellenmiş etkinlik nesnesi yapısını kullanacak şekilde güncelleyin. Yeni yapı, Gmail ve Takvim konferans eklentileri tarafından kullanılan etkinlik nesnesi alanlarını yine içerir ancak bu orijinal alanlar kullanımdan kaldırılmıştır ve bir süre sonra kaldırılacaktır.
3. Adım: Eklentinizin manifest dosyasını güncelleyin
Yapılandırma bilgilerinin Google Workspace Eklentileri'nin manifest yapısında depolanma şekli, Gmail eklentilerinin ve Takvim konferans eklentilerinin kullandığı yapıdan önemli ölçüde değişti. Eklentinizi yeni sürüme geçirirken eklentinizin Apps Komut Dosyası projesinin manifest alanlarını aşağıdaki tablolara göre güncellemeniz gerekir. İlgili tüm alt mülkleri yeni addOns mülkünde güncellemeniz gerekir.
Güncellenen eklentinizin gerektirdiği izinleri yansıtmak için manifest dosyanızın oauthScopes alanını da gerektiği şekilde güncellediğinizden emin olun.
Google Workspace eklentisi manifest dosyaları hakkında daha fazla bilgi edinmek için Manifestler sayfasını inceleyin.
Gmail eklentileri
| Orijinal manifest alanı | İşlem Gerekli |
|---|---|
gmail.composeTrigger |
addOns.gmail.composeTrigger aboneliğine taşıyın. |
gmail.contextualTriggers[] |
Listeyi addOns.gmail.contextualTriggers[] hedefine taşıyın. |
gmail.logoUrl |
addOns.common.logoUrl aboneliğine taşıyın. |
gmail.name |
addOns.common.name aboneliğine taşıyın. |
gmail.openLinkUrlPrefixes[] |
Listeyi addOns.common.openLinkUrlPrefixes[] hedefine taşıyın.
|
gmail.primaryColor |
addOns.common.layoutProperties.primaryColor aboneliğine taşıyın. |
gmail.secondaryColor |
addOns.common.layoutProperties.secondaryColor aboneliğine taşıyın.
|
gmail.universalActions[] |
Listeyi addOns.common.universalActions[] hedefine taşıyın. |
gmail.universalActions[].text |
Her gmail.universalActions[].text alanını karşılık gelen bir addOns.common.universalActions[].label alanına taşıyın. |
gmail.useLocalFromApp |
addOns.common.useLocaleFromApp aboneliğine taşıyın. |
Takvim konferansı eklentileri
| Orijinal manifest alanı | İşlem Gerekli |
|---|---|
calendar.createSettingsUrlFunction |
addOns.calendar.createSettingsUrlFunction aboneliğine taşıyın. |
calendar.conferenceSolution[] |
addOns.calendar.conferenceSolution[] aboneliğine taşıyın. |
calendar.logoUrl |
addOns.common.logoUrl aboneliğine taşıyın. |
calendar.name |
addOns.common.name aboneliğine taşıyın. |
4. Adım: Yeni sürüme geçirilen eklentinizi test edin
Yükseltilmiş eklentinizi yayınlamadan önce test etmek için Google Workspace Eklentilerini Test Etme sayfasına göz atın.
5. Adım: Yeni sürüme geçirilen eklentinizin incelenmesini isteyin
İster yükseltilmiş ister sıfırdan oluşturulmuş olsun, tüm Google Workspace Eklentileri Google Workspace Marketplace'te listelenmeden önce onaylanmalıdır.
Eklentinizi incelemeye göndermek için şu adımları uygulayın:
Eklentinizin tüm eklenti yayınlama gereksinimlerini karşıladığından emin olun.
Yayınlamak istediğiniz kodun sürümünü kullanarak Google Workspace Eklentinizin (yeni Apps Komut Dosyası projesinde) sürümü olan bir dağıtımını oluşturun. Başlık dağıtımı kullanarak yayınlamayı denemeyin.
Eklentinizi yeni sürüme geçirirken yeni kapsamlar eklediyseniz OAuth doğrulaması istemeniz gerekir. Örneğin, Gmail eklentiniz, Google Workspace eklentisinde yeni Drive veya Takvim kapsamlarını kullanıyorsa bu yeni kapsamları doğrulama için göndermeniz gerekir. Doğrulamanın tamamlanması genellikle birkaç gün sürdüğünden süreci mümkün olduğunca erken başlatın. 6. Adım'a geçmeden önce eklentinizin doğrulandığından emin olun.
6. Adım: Yeni sürüme geçirilen eklentinizi kullanılabilir hale getirin
Google Workspace Marketplace SDK'sını açın.
Solda, Yapılandırma'yı tıklayın. Bu panelde eklentinizle ilgili bilgi sağlayabileceğiniz bir form bulunur.
Girişinizin kısa açıklamasını, ayrıntılı açıklamasını ve ekran görüntülerini, Google Workspace Eklentisi'nin yeni işlevlerini yansıtacak şekilde güncelleyin.
Uzantılar bölümünde Google Workspace Eklentisi'ne 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.
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.
Forma girdiğiniz bilgilerin doğru olduğunu onaylayı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 veya sorunla karşılaşırsanız bize ulaşın.
SSS
Eklenti yükseltmeleriyle ilgili sık sorulan sorular aşağıda verilmiştir:
Düzenleyici Eklentimi yükseltebilir miyim?
Çoğu düzenleyici eklentisi Google Workspace eklentilerine taşınabilir. Ancak, Google Workspace Eklentilerine geçiş, Gmail ve Takvim eklentileri kadar kolay bir şekilde gerçekleştirilemez.
Düzenleyici Eklentinizi bir 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şlemenizi Kart Hizmeti olarak güncellemeniz gerekir.
Mevcut Düzenleyici Eklentinizdeki bazı hizmetler, Kart Hizmeti'nde kullanılamayabilir. Örneğin, Düzenleyici Eklentinizde bir dosya seçici varsa Google Workspace için Kart Hizmeti'nde bunun eşdeğeri bulunmaz.
Ayrı bir Google Workspace Eklentisi oluşturup mevcut eklentimi kullanmaya devam edebilir 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. Sorularınız varsa veya istisna talebinde bulunmak istiyorsanız bizimle iletişime geçin.
Eklenti yeni sürüme geçirildikten sonra kullanıcılarımın eklentiyi yeniden yetkilendirmesi gerekir mi?
Google Workspace Eklentiniz, ilişkili bir OAuth istemci kimliğiyle birlikte 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, eklentinizin Google Workspace sürümünü ilk kez kullandıklarında bu yeni kapsamları yetkilendirmelidir.
Chrome uzantımı bir Google Workspace eklentisine yükseltip kullanıcıları aktarabilir miyim?
Hayır. Bir Chrome uzantısının kullanıcılarını, yüklemelerini ve girişlerindeki yorumları 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 haline getirebilir miyim?
Uygulama entegrasyonlarını birlikte listeleme konusuna bakın.