Kullanıcıların bir eklentiyi açıp kullanabilmeleri için önce yüklemeleri ve yetkilendirmeleri gerekir. Bu adımlar, eklenti kullanıcı deneyiminin ilk kısmı olduğundan kendi eklentilerinizi oluşturmaya başlamadan önce bunları anlamanız gerekir.
Bu doküman bölümünde, kullanıcıların eklentileri nasıl yükleyebileceği, yetkilendirebileceği ve kullanmaya başlayabileceği açıklanmaktadır.
Eklentileri yükleme
Bir eklentiyi kullanabilmek için önce yüklemeniz gerekir. Yüklenen eklenti, genişlettiği Google Workspace ana uygulamasında kullanılabilir hale gelir.
Yayınlanan eklentileri Google Workspace ana uygulamasından veya Google Workspace Marketplace'ten yükleyebilirsiniz. Alan yöneticileri, Google Workspace Marketplace'ten kullanıcıları adına da eklenti yükleyebilir. Geliştirdiğiniz yayınlanmamış eklentileri de yükleyebilirsiniz. Böylece, bunları test edebilirsiniz. Yüklü bir eklentiyi ilk kez kullanabilmek için yetkilendirmeniz gerekir.
Daha fazla bilgi için Eklenti yayınlama başlıklı makaleyi inceleyin.
Eklentilere yetki verme
Yüklenen eklentiler, genişlettikleri Google Workspace ana uygulamasında kullanılabilir hale gelir. Kullanıcı eklentiyi ilk kez kullanmaya çalıştığında, barındıran uygulama kullanıcıya bir yetkilendirme kartı veya iletişim kutusu gösterir. Bu kartta, eklentinin kullanıcı için yapması gereken işlemler (ör. mevcut Google E-Tablosu'nun içeriğine erişme) açıklanır. Kullanıcı bu izinleri verebilir ve eklentinin devam etmesine izin verebilir. Kullanıcı, eklenti yetkilendirmesini reddederse eklentiyi kullanamaz.
Düzenleyici eklentileri, Google Workspace eklentilerinden farklı bir yetkilendirme modeli kullanır. Düzenleyici eklentileri Google Drive dosyalarında çalıştığından düzenleyici yetkilendirme modeli, eklentilerin tek tek dosyalarla kullanıldığında ortaya çıkan çeşitli yetkilendirme modlarını tanımlar. Düzenleyici eklentileri geliştirirken farklı modları ve bir eklentinin bunlar arasında nasıl geçiş yaptığını anlamak önemlidir.
Yayınlanan eklentilere yetki verme
Yayınlanan bir eklentiyi yükledikten sonra yetkilendirme akışı hemen başlar:
- Eklentiyi yüklemek için bir hesap seçmeniz istenir.
- Ardından, eklentinin çalışması için ihtiyaç duyduğu yetkilendirmelerin listesi gösterilir. Böylece, eklentinin ne yapmaya çalıştığını anlayabilirsiniz. Bu listeyi dikkatlice inceleyin ve yine de yetkilendirme vermek istiyorsanız İzin ver'i tıklayın. Bu işlem, eklentinin kullanılmasını sağlar.
- Artık genişlettiği ana uygulamadan çalıştırabilirsiniz. Uygulama, tarayıcı sekmesinde zaten açıksa eklenti kullanılabilir hale gelmeden önce sekmeyi yenilemeniz gerekebilir.
Yüklediğiniz eklenti daha sonra güncellenirse ve henüz vermemiş olduğunuz ek yetkilendirmeler gerektirirse eklentiyi bir sonraki sefer kullandığınızda bu izinleri vermeniz istenir.
Yayınlanmamış Google Workspace eklentilerine yetki verme
Henüz Google Workspace Marketplace'te listelenmediği için yayınlanmamış eklentilerin yetkilendirme akışı, yayınlanmış eklentilerle aynı değildir. Yayınlanmamış bir eklentiyi yükledikten sonra hemen yetkilendirme yapmanız istenmez. Bunun yerine, yetkilendirme akışı eklentiyi ilk kez kullanmaya çalıştığınızda başlar.
Bir eklenti çalıştırıldığında kullanıcı yetkilendirmesi gerekip gerekmediğini belirler. Yetkilendirme gerekiyorsa eklenti bir yetkilendirme kartı gösterir. Yetkilendirme, bir eklentinin ilk kez çalıştırıldığı her zaman gereklidir ve eklentinin yeni bir sürümü daha önce yetkilendirilmemiş bir hizmet kullanıyorsa da gerekebilir. Erişim için yetki ver düğmesi, kullanıcının eklenti için yetki vermesi veya vermemesi gereken bir iletişim kutusu sağlar.
Google dışı hizmetlerin Google Workspace eklentisi için yetkilendirilmesi
Bir Google Workspace eklentisinin, kendisi için yetkilendirme gerektiren bir üçüncü taraf hizmetine bağlanması mümkündür. Bu tür hizmetlere bağlanan Google Workspace eklentileri, kullanıcıdan iki ayrı işlem yapılmasını gerektirir:
- Eklenti yüklendiğinde veya ilk kez başlatıldığında eklentinin kendisi için yetkilendirme.
- Google dışı hizmete ilk kez erişildiğinde yetkilendirme.
Geliştirdiğiniz bir Google Workspace eklentisinin OAuth'u kullanarak Google dışı bir hizmete erişmesi gerekiyorsa eklentiyi oluştururken söz konusu hizmet için bağlantıyı yapılandırmanız gerekir.
Daha fazla bilgi için Google Workspace eklentinizi üçüncü taraf hizmetine bağlama başlıklı makaleyi inceleyin.
Üçüncü taraf konferans sistemleri
Google Takvim'i genişleten Google Workspace eklentileri, kullanıcıların Google Takvim etkinliklerini düzenlerken üçüncü taraf bir konferans sistemi seçmesine olanak tanıyan ek konferans çözümleri de ekleyebilir. Eklentiniz, kullanıcının oturum açmasını gerektiren konferans seçenekleri sunuyorsa kullanıcıya bunu yapma olanağı sağlamalıdır.
Bir kullanıcı, gerekli oturum açma işlemini yapmadan eklentinizle konferans oluşturmaya çalışırsa konferans çözümlerinin onCreateFunction yöntemi, kimlik doğrulama URL'si içeren bir ConferenceError öğesi döndürmelidir.ConferenceData
Google Takvim, bu nesneyi aldıktan sonra etkinlik düzenleme kullanıcı arayüzünde, eklentinin sağladığı kimlik doğrulama URL'sine bağlantı veren bir GİR düğmesi oluşturur. Kullanıcılar, eklentiyi daha fazla kullanmadan önce bu düğmeyi kullanarak üçüncü taraf sistemine giriş yapabilir.
ConferenceError kullanarak yetkilendirmeyi işleme hakkında daha fazla bilgi için Üçüncü taraf konferansları oluşturma başlıklı makaleyi inceleyin.
Yayından kaldırılan Düzenleyici eklentilerini yetkilendirme
Düzenleyici eklentilerini geliştirirken test etmek en iyi uygulamadır. Yetkilendirme akışı, yayınlanan Düzenleyici eklentileri ile aynıdır. Tek fark, akışın eklentiyi ilk kez test etmeye çalıştığınızda başlamasıdır. Daha sonra aynı eklentiyi yeniden test ederseniz sizden tekrar yetkilendirme istenir.
Eklentilerin yetkisini kaldırma
Eklenti geliştirirken yetkilendirme akışını yeniden test edebilmek için eklentilerin yetkisini iptal edebilirsiniz.
Bir eklentinin yetkisini aşağıdaki adımları uygulayarak kaldırabilirsiniz:
- Hesap güvenliği konsolunuzu açın.
- Yetkisini iptal etmek istediğiniz eklentiyi bulup tıklayın.
- Erişimi Kaldır'ı tıklayın.
Yetkilendirmesini kaldırdıktan sonra eklentiyi tekrar çalıştırdığınızda yetkilendirme akışı tekrar gösterilir.
Eklentileri kaldırma
Google Workspace Marketplace'ten yüklediğiniz bir eklentiyi kaldırmak için Marketplace uygulamalarını veya eklentilerini kaldırma başlıklı makaleyi inceleyin.
Apps Komut Dosyası'na yerleşik olarak bulunan ve yayınlanmamış bir eklentiyi kaldırmak için Yayınlanmamış bir eklentiyi kaldırma başlıklı makaleyi inceleyin.