Kullanıcıların bir eklentiyi açıp kullanılabilmesi için önce yükleyip yetkilendirmesi gerekir. Bu adımlar eklenti kullanıcı deneyiminin ilk bölümü olduğundan kendi eklentilerinizi oluşturmaya başlamadan önce bunları anlamanız gerekir.
Bu belge bölümünde kullanıcıların eklentileri nasıl yükleyebileceği, yetkilendirebileceği ve kullanmaya nasıl başlayabileceği açıklanmaktadır.
Eklenti yükleme
Bir eklentiyi kullanabilmek için öncelikle yüklemeniz gerekir. Eklenti yüklendikten sonra, genişletildiği Google Workspace ana makine uygulamasında kullanılabilir hale gelir.
Yayınlanan eklentileri Google Workspace ana makine uygulamasından veya Google Workspace Marketplace'ten yükleyebilirsiniz. Ayrıca, alan yöneticileri Google Workspace Marketplace'ten kullanıcıları adına eklentiler yükleyebilir. Ayrıca, geliştirdiğiniz yayınlanmamış eklentileri yükleyerek test edebilirsiniz. Yüklü bir eklentiyi ilk kez kullanabilmeniz için öncelikle eklentiyi yetkilendirmeniz gerekir.
Daha fazla bilgi için Eklentileri yayınlama bölümüne bakın.
Eklentileri yetkilendirin
Yüklenen bir eklenti, genişletildiği Google Workspace ana makine uygulamasında kullanılabilir hale gelir. Bir kullanıcı, ana makine uygulamasında eklentiyi ilk kez kullanmayı denediğinde bir yetkilendirme kartı veya iletişim kutusu gösterir. Bu kartta, eklentinin kullanıcı için hangi işlemleri (ör. mevcut Google E-Tablosu'nun içeriğine erişmek) yapması gerektiği açıklanmıştır. Daha sonra kullanıcı bu izinleri 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, eklentiler tek tek dosyalarla kullanıldığında ortaya çıkan çeşitli yetkilendirme modları tanımlar. Düzenleyici Eklentileri geliştirirken farklı modları ve bir eklentinin bunlar arasında nasıl hareket ettiğini anlamak önemlidir.
Yayınlanan eklentileri yetkilendirme
Yayınlanan bir eklentiyi yüklemenizin ardından yetkilendirme akışı hemen başlar:
- Eklentiyi yükleyeceğiniz bir hesap seçin istemini görürsünüz.
- Ardından, eklentinin çalışması gereken yetkilendirmelerin listesi sunulur. Böylece, ne yapmaya çalıştığını bilirsiniz. Bu listeyi dikkatlice inceleyin ve yine de yetkilendirme vermek istiyorsanız İzin ver'i tıklayın. Bu işlem, eklentiyi kullanmak üzere etkinleştirir.
- Artık bu uzantıyı, genişletildiği ana makine uygulamasından çalıştırabilirsiniz. Uygulama zaten bir tarayıcı sekmesinde açıksa eklentinin kullanılabilir hale gelmesi için sekmeyi yenilemeniz gerekebilir.
Yüklediğiniz eklenti daha sonra güncellenirse ve henüz vermediğiniz ek yetkilendirmeler gerektirirse eklentiyi bir sonraki kullanımınızda bu izinleri vermeniz istenir.
Yayınlanmayan Google Workspace eklentilerini yetkilendirin
Yayınlanmayan eklentiler henüz Google Workspace Marketplace'te listelenmediğinden, yayınlanan eklentilerle aynı yetkilendirme akışı yoktur. Yayınlanmamış bir eklentiyi yükledikten sonra yetkilendirmeniz hemen istenmez. Bunun yerine, yetkilendirme akışı, eklentiyi ilk kez kullanmayı denediğinizde başlar.
Çalıştırılan eklentiler kullanıcı yetkilendirmesinin gerekip gerekmediğini belirler. Yetkilendirme gerekiyorsa eklenti bir provizyon kartı sunar. Bir eklenti ilk kez çalıştırıldığında her zaman yetkilendirme gerekir. Eklentinin yeni bir sürümü, daha önce yetkilendirilmemiş bir hizmeti kullanıyorsa yetkilendirme gerekebilir. Erişimi Yetkilendir düğmesi, kullanıcının eklenti için yetkilendirmeye izin vermesi veya izni reddetmesi için bir iletişim penceresi sağlar.
Google Workspace Eklentileri için Google dışı hizmetleri yetkilendirme
Bir Google Workspace eklentisi, kendisi için yetkilendirme gerektiren üçüncü taraf hizmetlere bağlanabilir. Bu tür hizmetlere bağlanan Google Workspace Eklentileri için kullanıcının iki ayrı işlem yapması gerekir:
- Eklenti yüklendiğinde veya ilk kez başlatıldığında eklentinin yetkilendirilmesi.
- Google dışı hizmete ilk kez erişildiğinde yetkilendirme.
Geliştirdiğiniz Google Workspace eklentisinin, Google dışı bir hizmete OAuth kullanarak erişmesi gerekiyorsa eklentiyi oluştururken bu hizmetin bağlantısını yapılandırmanız gerekir.
Daha fazla bilgi için Google Workspace Eklentinizi üçüncü taraf hizmetlerine 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 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 eklentiniz, kullanıcıya bunu yapma olanağı sağlamalıdır.
Bir kullanıcı gerekli oturum açmadan eklentinizle konferans oluşturmaya çalışırsa konferans çözümlerinin onCreateFunction yöntemi, kimlik doğrulama URL'sine sahip ConferenceError içeren bir ConferenceData nesnesi döndürmelidir.
Bu nesneyi aldıktan sonra Google Takvim, 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. Böylece kullanıcılar, eklentiyi daha fazla kullanmadan önce bu düğmeyi kullanarak üçüncü taraf sisteme giriş yapabilir.
ConferenceError kullanarak yetkilendirmeyi yönetme hakkında daha fazla bilgi için Üçüncü taraf konferansları oluşturma bölümüne bakın.
Yayınlanmayan düzenleyici eklentilerini yetkilendir
En iyi uygulama, Düzenleyici Eklentilerini geliştirirken test etmenizdir. Yetkilendirme akışı, yayınlanan Düzenleyici Eklentileri'ndeki akışla aynıdır. Tek fark, akışın eklentiyi ilk kez test etmeyi denediğinizde başlamasıdur. Daha sonra aynı eklentiyi yeniden test ederseniz tekrar yetkilendirme yapmanız istenmez.
Eklentilerin yetkilendirmesini kaldırın
Eklenti geliştirirken yetkilendirme akışını yeniden test edebilmek için yetkilendirmeyi kaldırmak faydalı olabilir.
Aşağıdakileri yaparak bir eklentinin yetkisini kaldırabilirsiniz:
- Hesap güvenlik konsolunuzu açın.
- Yetkisini kaldırmak istediğiniz eklentiyi bulup tıklayın.
- Erişimi Kaldır'ı tıklayın.
Eklentiyi yetkisiz hale getirdikten sonra tekrar çalıştırdığınızda yetkilendirme akışı yeniden gösterilir.