Gmail veya Takvim'i genişletmek için bir eklenti oluşturup yayınladıysanız bu eklentiyi Google Workspace eklentisine yükseltebilirsiniz. Bu sayfadaki talimatlarda, Google Workspace işlevlerini mevcut Gmail veya Takvim eklentilerinize nasıl ekleyeceğiniz ve ardından yükseltilmiş eklentinizi nasıl yayınlayacağınız açıklanmaktadır. Böylece eklentiniz bulunup yüklenebilir.
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 yararlanmanıza da olanak tanır.
1. adım: Eklentinizin Apps Komut Dosyası projesinin bir kopyasını oluşturun
Yükseltilmiş eklentiniz, yayınlanmış eklentinizle aynı Google Cloud projesini kullanır. Ancak, yükseltilmiş sürümü test ederken mevcut kullanıcılarınızın etkilenmemesi için temel alınan 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.
- Mevcut Gmail eklentinizi veya Takvim konferans eklentisi Apps Komut Dosyası projenizi açın.
- Sol tarafta Genel bakış'ı tıklayın .
- Sağ tarafta, Kopya oluştur'u tıklayın.
- Sol tarafta Proje Ayarları > Projeyi değiştir'i tıklayın.
- GCP Proje Numarası'nı tıklayın.
- Mevcut, yayınlanmış eklenti Apps Komut Dosyası projenizle ilişkili aynı proje numarasını girin.
- Projeyi ayarla'yı tıklayın.
2. adım: Google Workspace eklentisini entegre edin
Eklentinize eklemek istediğiniz tüm Google Workspace eklenti özelliklerini tasarlayıp uygulamanız gerekir.
- Eklentinizin ana sayfa kartlarında hangi içeriğin gösterileceğini ve bu kartların Gmail, Takvim, Drive veya üç ana makinenin herhangi bir kombinasyonunda görünüp görünmeyeceğini planlayın. Birden fazla ana makinede ana sayfa kullanmak istiyorsanız aynı ana sayfayı kullanıp kullanamayacağınıza veya her ana makine için özel ana sayfa kartları kullanmak isteyip istemediğinize karar verin.
- Kopyalanan eklenti Apps Komut Dosyası projenizde,
homepageTriggerişlevleriyle ana sayfa kartlarınızı oluşturun. Yeni ana sayfa arayüzlerinizi kontrol etmek için gereken destekleyici işlevleri veya mantığı eklediğinizden emin olun. Kullanıcının yaptığı işlemlerle (ör. Gmail ileti dizisini veya Takvim etkinliğini açma) tetiklenen bağlamsal kartlar eklemeyi düşünebilirsiniz.
Eklentinizde (widget geri çağırma işlevlerinde veya bağlamsal tetikleyici işlevlerinde) etkinlik nesnelerine erişimi, güncellenmiş etkinlik nesnesi yapısını kullanacak şekilde güncelleyin. Yeni yapıda, Gmail ve Takvim konferans eklentileri tarafından kullanılan aynı etkinlik nesnesi alanları yer almaya devam eder ancak bu orijinal alanlar kullanımdan kaldırılmıştır ve sonunda 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 eklentileri ve Takvim konferans eklentilerinin kullandığı yapıdan önemli ölçüde farklıdır. Eklentinizi yükseltirken 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üne 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 eklenti 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 aboneliğine taşıyın. |
gmail.contextualTriggers[] |
Listeyi addOns.gmail.contextualTriggers[] konumuna 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[] konumuna 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[] konumuna taşıyın. |
gmail.universalActions[].text |
Her gmail.universalActions[].text alanı, ilgili 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: Yükseltilen eklentinizi test edin
Yükseltilen 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
İster yükseltilmiş ister sıfırdan oluşturulmuş olsun, tüm Google Workspace eklentilerinin Google Workspace Marketplace'te listelenmeden önce onaylanması gerekir.
Eklentinizi incelemeye göndermek için aşağıdaki adımları uygulayın:
Eklentinizin tüm eklenti yayınlama şartlarını karşıladığından emin olun.
Yayınlamak istediğiniz kod sürümünü kullanarak Google Workspace eklentinizin (yeni Apps Komut Dosyası projesinde) sürüm oluşturulmuş bir dağıtımını oluşturun. Baş dağıtımı kullanarak yayınlamaya çalışmayın.
Eklentinizi yükseltirken yeni kapsamlar eklediyseniz OAuth doğrulaması isteğinde bulunmanız gerekir. Örneğin, Gmail eklentiniz Google Workspace eklenti 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, süreci 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ükseltilmiş eklentinizi kullanıma sunun
Google Workspace Marketplace SDK'sını açın.
Sol tarafta Yapılandırma'yı tıklayın. Bu panelde, eklentinizle ilgili bilgileri sağlayabileceğiniz bir form bulunur.
Google Workspace eklentisinin yeni işlevini yansıtacak şekilde girişinizin kısa açıklamasını, ayrıntılı açıklamasını ve ekran görüntülerini güncelleyin.
Uzantılar bölümünde Google Workspace eklentisine yükselt düğmesini tıklayın. Görünen 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 doğrulayın. Ardından Değişiklikleri kaydet'i tıklayın.
Bu Google Workspace eklentisi yükseltme işlemi sırasında sorunuz olursa veya bir sorunla karşılaşırsanız bize ulaşın.
SSS
Eklenti yükseltmeleriyle ilgili sık sorulan soruları aşağıda bulabilirsiniz:
Editor eklentimi yükseltebilir miyim?
Çoğu Doküman Düzenleyici eklentisi, Google Workspace eklentilerine taşınabilir. Ancak bu eklentiler, Gmail ve Takvim eklentileri kadar kolay bir şekilde Google Workspace eklentilerine yükseltilemez.
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şleme kodunuzu Card Service'e 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 eklentileri için kart hizmetinde eşdeğeri yoktur.
Ayrı bir Google Workspace eklentisi oluşturabilir ve 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 bize ulaşın.
Eklenti yükseltildikten 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 yetkilendirmeleri 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 kullandıklarında 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 eklentime birden fazla eklenti ekleyebilir miyim?
Uygulama entegrasyonlarını birlikte listeleme başlıklı makaleyi inceleyin.