Bu sayfada, Google Workspace Marketplace'te uygulamanızı yapılandırmak ve yönetmek için Google Workspace Marketplace SDK'sını nasıl kullanacağınız açıklanmaktadır.
Uygulamanızı kullanıma sunmak için Marketplace SDK'sında ayarlamanız gerekir. Marketplace SDK'sı, Google Workspace Marketplace'te uygulamanızı oluşturup kontrol etmenize olanak tanıyan bir araç setidir. Marketplace SDK'sını kullanarak Marketplace ayarlarını yönetebilirsiniz. Örneğin:
- Uygulamanızın belirli bir Google Workspace kuruluşu (özel uygulama) veya tüm Marketplace kullanıcıları (herkese açık uygulama) için kullanılıp kullanılamayacağını belirtin.
- Uygulamanızı yükleyebilecek Marketplace kullanıcısı türleri
- Uygulamanızın hangi Google Workspace uygulamalarıyla entegre olduğu
- Uygulamanızın gerektirdiği OAuth kapsamları
- Uygulamayı kimin oluşturduğu ve sürdürdüğü hakkında bilgi
Uygulamanızı özel olarak mı yoksa herkese açık olarak mı yayınladığınızdan bağımsız olarak, uygulamanızı Marketplace'te yönetmek için Marketplace SDK'sını kullanmanız gerekir.
Marketplace SDK'sını etkinleştirme
Henüz yapmadıysanız Google Cloud projenizde Google Workspace Marketplace SDK'sını etkinleştirin.
Google Cloud Console'da Cloud projenizi açma
Henüz açık değilse bu örnek için kullanmayı planladığınız Cloud projesini açın:
- Google Cloud Console'da Proje seçin sayfasına gidin.
- Kullanmak istediğiniz Google Cloud projesini seçin. Alternatif olarak Proje oluştur'u tıklayıp ekrandaki talimatları uygulayın. Google Cloud projesi oluşturursanız proje için faturalandırmayı etkinleştirmeniz gerekebilir.
Google Workspace Marketplace SDK'sını etkinleştirme
Google API'lerini kullanmadan önce bir Google Cloud projesinde etkinleştirmeniz gerekir. Tek bir Google Cloud projesinde bir veya daha fazla API'yi etkinleştirebilirsiniz.Google Cloud konsolunda, Google Workspace Marketplace SDK'sını etkinleştirin.
Uygulamanızın yapılandırma ayarlarını belirleme
Aşağıdaki referansta, Marketplace SDK'sının Uygulama Yapılandırması sayfasında kullanılabilen ayarlar açıklanmaktadır.
Uygulamanızı kimlerin görüntüleyebileceğini ve yükleyebileceğini seçme
Uygulamanızı yapılandırırken aşağıdaki ayarları kullanarak uygulamanıza erişebilecek kullanıcıları belirtirsiniz:
- Uygulama görünürlüğü: Google Workspace kuruluşunda bir uygulama yayınlıyorsanız uygulama girişinizin liste dışı olup olmadığı, kuruluşunuzdaki tüm kullanıcılara veya Google Workspace kullanan herkese görünür olup olmadığı.
- Yükleme ayarları: Uygulamanın yalnızca Google Workspace yöneticileri tarafından yüklenip yüklenemeyeceği.
Uygulama girişinizde belirttiğiniz ayarlardan bağımsız olarak, Google Workspace kuruluşuna ait kullanıcılar, yöneticileri tarafından ayarlanan ayarlara bağlı olarak uygulamanızı keşfedemez, yükleyemez veya kullanamayabilir. Yöneticiler, uygulamanızın kullanılabilirliğini aşağıdaki şekillerde etkileyebilir:
- Kullanıcılarının Marketplace'teki uygulamaları görüntüleyip görüntüleyemeyeceğini ve kullanıcıları adına uygulama yükleyip yükleyemeyeceğini kontrol edebilir.
- Kuruluşları için uygulamaları yönetmek ve seçmek üzere izin verilenler listesi kullanabilir. İzin verilenler listelerini kullanan bir kuruluş için uygulama geliştiriyorsanız uygulamanın izin verilenler listesine eklenmesi konusunda bir yöneticiye danışın.
- Google Chat'e, Google Chat uygulamalarına veya her ikisine erişimi kaldırma gibi belirli Google Workspace uygulamalarını devre dışı bırakın. Bu durumlarda, kullanıcılar uygulamanızı Marketplace'ten yükleyemez.
Yöneticilerin Marketplace'e erişimi nasıl yönettiğini öğrenmek için Marketplace Yöneticisi Yardım dokümanlarına bakın.
Uygulama görünürlüğü ayarları
Google Workspace hesabı (iş veya okul kuruluşunuz tarafından oluşturulan bir hesap) kullanıyorsanız Uygulama Görünümü seçeneğini görürsünüz. Tüketici hesabı kullanıyorsanız ("@gmail.com" ile biten bir hesap) yalnızca herkese açık olarak yayınlayabilirsiniz.
- Herkese açık: Uygulama, alanınızın dışındaki kullanıcılar tarafından bulunabilir ve yüklenebilir. Herkese açık görünürlük seçerseniz Google, uygulama girişinizi yayınlanmadan önce inceler ve onaylar.
- Gizli: Yalnızca alanınızdaki kullanıcılar uygulamanızı bulabilir ve yükleyebilir.
Liste Dışı olarak yayınlamayı seçerseniz uygulama girişi, göz atma veya arama sonuçlarında gösterilmez. Kullanıcılar uygulamanın mağaza sayfasına yalnızca doğrudan URL ile erişebilir.
Uygulamanızın kullanıma sunulacağı ülkeleri ve bölgeleri sınırlamak istiyorsanız mağaza girişini oluştururken Dağıtım bölümünde bu ayarı yapabilirsiniz.
Uygulama yükleme ayarları
Yükleme Ayarları seçeneği, kullanıcıların veya Google Workspace yöneticilerinin uygulamanızı Google Workspace Marketplace'teki mağaza girişi sayfanızdan yükleyip yükleyemeyeceğini belirler.
- Bireysel Kullanıcı + Yönetici Yüklemesi (varsayılan): Uygulama, bireysel kullanıcılar tarafından veya yöneticiler tarafından alanları, kuruluş birimleri ya da kullanıcı grupları için yüklenebilir. Bir kullanıcının alan politikaları, bireysel yüklemeler etkinleştirilmiş olsa bile kullanıcının uygulama yüklemesini engelleyebilir.
- Yalnızca Yönetici Yüklemesi: Uygulama yalnızca yöneticiler tarafından alanları, kuruluş birimleri veya kullanıcı grupları için yüklenebilir. Uygulamanız, Google Workspace Marketplace arama sonuçlarında yalnızca yöneticilere ve Google Hesaplarına giriş yapmamış kullanıcılara gösterilir. Uygulamanız alan yükleme gerektiriyorsa bu seçeneği belirleyin.
Sık kullanılan yükleme ve görünürlük ayarları
Aşağıdaki tabloda, yükleme ve görünürlük için yaygın uygulama yapılandırma seçeneklerinden bazıları özetlenmiştir:
| Uygulamanın hedef kullanıcıları | Uygulama görünürlüğü ayarı | Uygulama yükleme ayarı | Uygulamamı kimler yükleyebilir? | Uygulamamı kimler kullanabilir? | |
|---|---|---|---|---|---|
| Google Workspace kuruluşları için oluşturulan uygulamalarda | |||||
| Kuruluşunuzdaki belirli kullanıcılar | Gizli ve Liste dışı | Bireysel Kullanıcı + Yönetici Yüklemesi | İzin verilmişse kuruluşunuzda uygulama girişi URL'sine sahip olan herkes. | İzin verilmişse kuruluşunuzda uygulama girişi URL'sine sahip olan herkes. | |
| Kuruluşunuz | Gizli | Bireysel Kullanıcı + Yönetici Yüklemesi | İzin veriliyorsa kuruluşunuzdaki herkes. | İzin veriliyorsa kuruluşunuzdaki herkes. | |
| Kuruluşunuz | Gizli | Yalnızca yönetici | Yöneticiler | Uygulamayı yöneticileri tarafından yükleyen kullanıcılar. | |
| Belirli bir Google Workspace kuruluşunun dışındaki kullanıcıların kullanabileceği uygulamalar için | |||||
| Google Workspace kuruluşlarındaki kullanıcılar | Herkese açık | Yalnızca yönetici | Yöneticiler | Uygulamayı yöneticileri tarafından yüklemiş olan kullanıcılar. | |
| Tüm Google Workspace kullanıcıları | Herkese açık | Bireysel Kullanıcı + Yönetici Yüklemesi |
|
|
|
Uygulamanızın Google Workspace uygulamalarıyla nasıl entegre edildiğini belirleme
Uygulamanızın veya eklentinizin birlikte çalışmak üzere tasarlandığı Google Workspace hizmetlerini (ör. Google Workspace eklentisi ya da Google Chat uygulaması) seçin. En az bir seçenek belirlemeniz gerekir. Bazı durumlarda uygulama girişinize birden fazla uygulama entegrasyonu ekleyebilirsiniz. Uygulama entegrasyonlarını birlikte listeleme bölümüne bakın.
Seçtiğiniz uygulama entegrasyonlarına bağlı olarak Google Cloud projenizde daha fazla bilgi sağlamanız ve ilgili API'leri etkinleştirmeniz gerekebilir. Aşağıdaki tabloda her biri için gereken ek kurulum açıklanmaktadır:
Google Workspace eklentisi (Apps Komut Dosyası)
Google Workspace eklentisi yayınlamak için eklentinin dağıtım kimliğini sağlamanız gerekir. Dağıtım kimliğini bulmak için aşağıdaki adımları uygulayın:
- Google Workspace eklentinizi Apps Komut Dosyası düzenleyicisinde açın.
- Dağıtım > Dağıtımları yönet'i tıklayın.
- Dağıtım kimliğinin altında Kopyala'yı tıklayın.
Google Workspace eklentisi (HTTP dağıtımları)
Google Workspace eklentinizi HTTP uç noktalarını kullanarak oluşturduysanız Google Cloud dağıtım kaynağından dağıtım kimliğini almak için aşağıdaki adımları uygulayın.
- "Google Workspace Eklentisi"nin altındaki Uygulama Yapılandırması sayfasında, HTTP veya diğer dağıtımlar > Dağıtımı Seç'i tıklayın.
- Yayınlamak istediğiniz dağıtımı seçin.
- Seç'i tıklayın.
Düzenleyici Eklentisi (Dokümanlar, E-Tablolar, Slaytlar, Formlar)
Düzenleyici eklentisi yayınlamak için yayınlamak istediğiniz proje komut dosyası kimliğini ve sürümünü sağlamanız gerekir.
Proje komut dosyası kimliğini bulmak için aşağıdaki adımları uygulayın:
- Eklentiyi Apps Komut Dosyası düzenleyicisinde açın.
- Sol taraftan Proje ayarları'nı tıklayın.
- "Kimlikler" bölümünün altındaki komut dosyası kimliğini kopyalayın.
Sürümü bulmak için aşağıdaki adımları uygulayın:
- Eklentiyi Apps Komut Dosyası düzenleyicisinde açın.
- Sağ üstte Dağıtım > Dağıtımları yönet'i tıklayın.
- Sürüm numarası "Yapılandırma" bölümündedir.
Google Chat uygulaması
Google Chat uygulaması yayınlamak için Google Chat API'yi yapılandırmanız gerekir. Google Chat uygulamalarını yayınlama başlıklı makaleyi inceleyin.
Drive uygulaması
Drive uygulaması yayınlamak için Google Drive API'yi etkinleştirmeniz ve yapılandırmanız gerekir.
Web uygulaması
Bir web uygulamasını yayınlamak için evrensel gezinme URL'sini sağlamanız gerekir. Bu URL, Google Apps menüsünden web uygulamasını işaret eder. Web uygulamanız üretimde olmalı ve tüm işlevleri çalışmalıdır.
Mağaza Girişi sayfasını doldururken 96x96 ve 48x48 piksel boyutlarında ek simgeler sağlamanız gerekir.
Web uygulamanızı Apps Script'te oluşturduysanız evrensel gezinme URL'sini almak için aşağıdaki adımları uygulayın:
- Google Workspace eklentinizi Apps Komut Dosyası düzenleyicisinde açın.
- Dağıt > Yeni dağıtım'ı tıklayın.
- "Türü seçin" bölümünde Web uygulaması'nı tıklayın.
- Seçenekleri doldurun ve Dağıt'ı tıklayın.
- Kopyala'yı tıklayın.
Uygulamanızın gerektirdiği erişim düzeyini belirtin
OAuth Kapsamları bölümünde, uygulamanızın ihtiyaç duyduğu OAuth 2.0 kapsamlarının tam listesini sağlayın. Burada girdiğiniz OAuth kapsamları, OAuth izin ekranınızda ve varsa Apps Script manifestinizde gösterdiğinizle eşleşmelidir.
Birden fazla uygulama entegrasyonu ekleyecekseniz her birinin kapsamlarını Marketplace SDK Uygulama Yapılandırması sayfasına ve OAuth izin ekranınıza eklediğinizden emin olun.
Her zaman mümkün olan en dar kapsamları kullanın (örneğin, yalnızca salt okunur bir kapsama ihtiyacınız varsa tam Drive kapsamı eklemeyin).
Apps Komut Dosyası projeleri için daha fazla bilgi edinmek üzere Yetkilendirme kapsamları başlıklı makaleyi inceleyin.
Uygulama geliştirici hakkında bilgi verme
Geliştirici Bilgileri bölümünde iletişim bilgilerini ve diğer ayrıntıları doldurun. Bu alanlar uygulamanızın mağaza girişi sayfasında görünür.
| Alanlar | |
|---|---|
| Satıcı durumu |
Tüketiciyi koruma yasaları nedeniyle, Avrupa Ekonomik Alanı'nda (AEA) bulunan tüketiciler, Google Workspace Marketplace'teki bir satıcının tacir mi yoksa tacir olmayan mı olduğu konusunda bilgilendirilmelidir:
Belirtilmemişse uygulamanızın mağaza girişi sayfasında "Tacir durumu belirtilmemiş" ifadesi görünür. |
| Geliştirici adı | Uygulamanın yazarı olarak gösterilecek ad. Tacirseniz ticari adınızı veya yasal adınızı belirtin. |
| Geliştiricinin posta adresi |
Satıcılar için gereklidir. Tacir olmayan kullanıcılar için toplanmaz. İşletmenizin konumu. Sizinle iletişime geçilebilecek geçerli bir posta adresi girin. |
| Geliştirici web sitesi URL'si | Sizi (veya kuruluşunuzu) geliştirici olarak tanımlayan web sitesi. |
| Geliştirici e-posta adresi |
İletişim noktası olarak kullanılacak e-posta adresi. Uygulama girişinize dahil değildir. Bu e-posta adresinin kullanıldığı esnada güncel olduğundan emin olun:
|
| Uygulama web sitesi URL'si | İsteğe bağlı. Uygulamanızı daha ayrıntılı açıklayan web sitesi. |
Uygulama yapılandırma ayarlarınızı Marketplace SDK'sına kaydetme
Önceki bölümde bulunan bilgileri kullanarak uygulama yapılandırmanızı Marketplace SDK'sına kaydedin:
Google Cloud Console'da Marketplace SDK'sı Yapılandırma sayfasına gidin:
Her bölümü, önceki bölümde belirlediklerinize göre doldurun.
Kaydet'i tıklayın.
(İsteğe bağlı) Google Analytics'te uygulama kullanımıyla ilgili analizler alabilirsiniz. Bunu yapmak için Marketplace SDK'sına bir Google Analytics kimliği ekleyin.
- Analytics sekmesine gidin.
- Google Analytics kimliğinizi girin.
- Kaydet'i tıklayın.