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 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ğı 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. Planınızı yükselttiğ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 yeni sürüme geçirilen sürümü test ettiğiniz sırada 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ı yükselttiğinizde, orijinal koda her zaman erişebilir ve gerekirse kodu yeniden dağıtabilirsiniz.
- Mevcut Gmail eklentinizi veya Takvim konferans eklentisi Apps Komut Dosyası projenizi 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ınlanan 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 tasarlayıp uygulamanız gerekir.
- Eklentinizin ana sayfa kartlarında hangi içeriğin gösterileceğini ve bunların Gmail'de, Takvim'de, Drive'da veya bu üç 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 ana makine için özel ana sayfa kartları isteyip istemediğinize karar verin.
- Kopyalanan Apps Komut Dosyası projenizde ana sayfa kartlarınızı
homepageTriggerişlevleriyle oluşturun. Yeni ana sayfa arayüzlerinizi kontrol etmek için gereken destekleyici işlevleri veya mantiği dahil ettiğinizden emin olun. Bir kullanıcının işlemi tarafından tetiklenen bağlamsal kartlar ekleyebilirsiniz (ör. Gmail ileti dizisi veya Takvim etkinliği açma).
Güncellenen etkinlik nesnesi yapısını kullanmak için eklentinizdeki (Widget geri çağırma işlevlerindeki veya bağlamsal tetikleyici işlevlerindeki) etkinlik nesnelerinin erişimini güncelleyin. Yeni yapı, Gmail ve Takvim konferansı eklentileri tarafından kullanılan etkinlik nesnesi alanlarını içerir ancak bu orijinal alanlar kullanımdan kaldırılmıştır ve sonunda tamamen 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ıya göre ö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üyle güncellemeniz gerekir.
Ayrıca, güncellenmiş eklentinizin gerektirdiği izinleri yansıtmak için manifest dosyanızdaki oauthScopes alanını da gerektiği şekilde güncelleyin.
Google Workspace eklentisi manifest dosyaları hakkında daha fazla bilgi edinmek için Manifest'ler başlıklı makaleyi inceleyin.
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ı karşılık gelen bir addOns.common.universalActions[].label alanına taşıyın. |
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 konusuna bakın.
5. Adım: Yükseltilmiş eklentinizin incelenmesini isteyin
İster yükseltilmiş bir eklenti ister sıfırdan oluşturulmuş bir eklenti olsun, 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:
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ümlü bir dağıtımını oluşturun. Head dağıtımı kullanarak yayınlamayı denemeyin.
Eklentinizi yükseltirken yeni kapsamlar eklediyseniz OAuth doğrulaması istemeniz gerekir. Örneğin, Gmail eklentiniz Google Workspace Eklentisi sürümünde yeni Drive veya Takvim kapsamları kullanıyorsa bu yeni kapsamları doğrulanmak üzere göndermeniz gerekir. Doğrulamanın tamamlanması genellikle birkaç gün sürer. Bu nedenle, işlemi 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: Yükseltilmiş eklentinizi kullanılabilir hale getirin
Google Workspace Marketplace SDK'sını açın.
Solda, Yapılandırma'yı tıklayın. Bu panelde, eklentiniz hakkında bilgi sağladığınız 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şlevini yansıtacak şekilde 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 manifestinde 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.
Google Workspace eklentisine yükseltme işlemi sırasında sorularınız olursa veya herhangi 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 Google Workspace Eklentileri'ne yükseltilemez. Bu işlem, Gmail ve Takvim eklentileri kadar kolaydır.
Düzenleyici Eklentinizi bir Google Workspace Eklentisine taşımak istiyorsanız eklentinin kullanıcı arayüzünü HTML'den kart tabanlı bir arayüze dönüştürmeniz 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 Eklentiniz bir dosya seçici içeriyorsa Google Workspace Eklentileri için Kart Hizmeti'nde bunun bir eşdeğeri yoktur.
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 bir istisna talebinde bulunmak istiyorsanız 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) projesini, ilişkili bir OAuth istemci kimliğiyle birlikte 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 kullandıklarında bu yeni kapsamları yetkilendirmesi gerekir.
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 giriş 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 halinde sunabilir miyim?
Uygulama entegrasyonlarını birlikte listeleme başlıklı makaleye göz atın.