Bu sayfada, Google Workspace Marketplace SDK'sını kullanarak uygulamanızı Google Workspace Marketplace'te nasıl yapılandırıp yöneteceğiniz açıklanmaktadır.
Uygulamanızı kullanıma sunmak için Marketplace SDK'sında ayarlamanız gerekir. Marketplace SDK, Marketplace'te uygulamanızı oluşturup kontrol etmenizi sağlayan bir araç setidir. Aşağıdakiler gibi Marketplace ayarlarını yönetmek için Marketplace SDK'sını kullanırsınız:
- 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ılabilir olup olmadığı
- Uygulamanızı yükleyebilecek Marketplace kullanıcılarının 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 bakımını kimin yaptığı hakkında bilgiler
Uygulamanızı özel veya herkese açık olarak yayınlıyor olmanızdan bağımsız olarak, Marketplace'teki uygulamanızı 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 Marketplace SDK'yı etkinleştirin.
Cloud projenizi Google Cloud Console'da açın.
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.
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 Console'da 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 bulunan 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üğü: Bir Google Workspace kuruluşunda uygulama yayınlıyorsanız uygulama girişinizin listelenmemiş mi, kuruluşunuzdaki tüm kullanıcılar tarafından mı yoksa Google Workspace kullanan herkes tarafından mı görüleceği.
- 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 belirlenen ayarlara bağlı olarak uygulamanızı keşfedemeyebilir, yükleyemeyebilir 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 düzenlemek üzere izin verilenler listesi kullanabilirler. İzin verilenler listelerini kullanan bir kuruluş için uygulama geliştiriyorsanız uygulamayı izin verilenler listesine ekleme konusunda bir yöneticiden bilgi alın.
- Google Chat, Google Chat uygulamaları veya her ikisine de erişimi kaldırma gibi belirli Google Workspace uygulamalarını devre dışı bırakma 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önetici Yardım belgelerine göz atı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ürlüğü seçeneğini görürsünüz. Tüketici hesabı ("@gmail.com" ile biten bir hesap) kullanıyorsanız yalnızca herkese açık olarak yayınlayabilirsiniz.
- Herkese açık: Uygulama, alanınızın dışındaki kullanıcılar tarafından bulunup yüklenebilir. Herkese açık görünürlüğü seçerseniz Google, uygulama girişinizi yayınlanmadan önce inceler ve onaylar.
- Özel: Uygulamanızı yalnızca alanınızdaki kullanıcılar bulabilir ve yükleyebilir.
Liste dışı olarak yayınlamayı seçerseniz uygulama listelemesi 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 listesini 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ı 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 bir kullanıcı grubu için yüklenebilir. Kullanıcının alan politikaları, tek tek yüklemeler etkinleştirilmiş olsa bile kullanıcının uygulama yüklemesini engelleyebilir.
- Yalnızca Yönetici Tarafından Yükleme: Uygulama yalnızca yöneticiler tarafından kendi alanları, kuruluş birimleri veya kullanıcı grupları için yüklenebilir. Uygulamanız yalnızca Google Workspace Marketplace'teki arama sonuçlarında yöneticilere ve Google Hesaplarında oturum açmamış kullanıcılara gösterilir. Uygulamanız alan yüklemesi 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ükle ilgili bazı yaygın uygulama yapılandırma seçenekleri özetlenmiştir:
| Hedeflenen uygulama kullanıcıları | Uygulama görünürlüğü ayarı | Uygulama yükleme ayarı | Uygulamamı kimler yükleyebilir? | Uygulamamı kimler kullanabilir? | |
|---|---|---|---|---|---|
| Google Workspace kuruluşu için oluşturulan uygulamalar | |||||
| Kuruluşunuzdaki belirli kullanıcılar | Gizli ve Liste dışı | Bireysel Kullanıcı + Yönetici Yüklemesi | İzin verilirse kuruluşunuzda uygulama listeleme URL'sine sahip olan herkes. | İzin verilirse kuruluşunuzda uygulama listeleme URL'sine sahip olan herkes. | |
| Kuruluşunuz | Özel | Bireysel Kullanıcı + Yönetici Yüklemesi | İzin verilirse kuruluşunuzdaki herkes | İzin verilirse kuruluşunuzdaki herkes | |
| Kuruluşunuz | Özel | Yalnızca yönetici | Yöneticiler | Uygulamayı yöneticileri tarafından yüklenen kullanıcılar. | |
| Belirli bir Google Workspace kuruluşunun dışındaki kullanıcıların erişebildiğ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üklenen 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 olduğunu belirleme
Uygulamanızın veya eklentinizin (ör. Google Workspace eklentisi ya da Google Chat uygulaması) birlikte çalışması için tasarlandığı Google Workspace hizmetlerini seçin. En az bir seçenek belirlemeniz gerekir. Bazı durumlarda, uygulama girişinize birden fazla uygulama entegrasyonu ekleyebilirsiniz. Uygulama entegrasyonlarını birlikte listeleme başlıklı makaleyi inceleyin.
Hangi uygulama entegrasyonlarını seçtiğinize bağlı olarak daha fazla bilgi vermeniz ve Google Cloud projenizde ilgili API'leri etkinleştirmeniz gerekebilir. Aşağıdaki tabloda her biri için gereken ek kurulum açıklanmaktadır:
Google Workspace eklentisi
Google Workspace eklentisi yayınlamak için eklentinin dağıtım kimliğini sağlamanız gerekir.
Apps Script'te dağıtım kimliğini bulmak için aşağıdaki adımları uygulayın:
- Google Workspace eklentinizi Apps Script düzenleyicide açın.
- Dağıt > Dağıtımları yönet'i tıklayın.
- Dağıtım kimliğinin altında Kopyala'yı tıklayın.
Bir HTTP eklentisinin dağıtım kimliğini bulmak için aşağıdaki adımları uygulayın:
- Uygulama Yapılandırması sayfasındaki "Google Workspace eklentisi" bölümünde 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)
Bir Düzenleyici eklentisi yayınlamak için yayınlamak istediğiniz proje komut dosyası kimliğini ve sürümü sağlamanız gerekir.
Proje komut dosyası kimliğini bulmak için aşağıdaki adımları uygulayın:
- Eklentiyi Apps Komut Dosyası Düzenleyici'de açın.
- Sol tarafta Proje ayarları'nı tıklayın.
- "Kimlikler" bölümünde komut dosyası kimliğini kopyalayın.
Sürümü bulmak için aşağıdaki adımları uygulayın:
- Eklentiyi Apps Komut Dosyası Düzenleyici'de açın.
- Sağ üstte Dağıt > Dağıtımları yönet'i tıklayın.
- Sürüm numarası "Yapılandırma" bölümünde yer alır.
Google Chat uygulaması
Etkileşimli bir Google Chat uygulaması yayınlamak için aşağıdaki belgeleri inceleyin:
- Chat uygulamanızı eklenti olarak oluşturduysanız eklenti ayarlarını Chat API'sinde yapılandırmanız gerekir. Adımlar için Google Workspace eklentisi belgelerindeki Chat uygulamasını yapılandırma başlıklı makaleyi inceleyin.
- Chat uygulamanızı etkileşim etkinliklerini kullanarak oluşturduysanız etkileşim etkinliği ayarlarını Chat API'sinde yapılandırmanız gerekir. Adımlar için Chat API belgelerindeki Etkileşim etkinliklerini alma ve yanıtlama başlıklı makaleye bakın.
- Chat uygulamanızı AppSheet'in otomatik yapılandırmasıyla oluşturduysanız AppSheet belgelerinde açıklanan adımları kullanarak Chat uygulamanızı yayınlayın: Otomatik yapılandırmayı kullanarak Chat uygulamanızı paylaşma.
Drive uygulaması
Bir Drive uygulamasını yayınlamak için Google Drive API'yi etkinleştirip yapılandırmanız gerekir.
Web uygulaması
Bir web uygulamasını yayınlamak için evrensel gezinme URL'sini (Google uygulamaları menüsünden web uygulamasına yönlendiren URL) sağlamanız gerekir. Web uygulamanız üretimde olmalı ve tüm işlevleri çalışır durumda olmalı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 Komut Dosyası'nda oluşturduysanız evrensel gezinme URL'sini almak için aşağıdaki adımları uygulayın:
- Google Workspace eklentinizi Apps Script düzenleyicide 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 gerektirdiği OAuth 2.0 kapsamlarının tam listesini sağlayın. Buraya girdiğiniz OAuth kapsamları, OAuth izin ekranınızda ve varsa Apps Komut Dosyası manifestinizde gösterdiklerinizle eşleşmelidir.
Birden fazla uygulama entegrasyonu ekliyorsanız her birinden kapsamları Marketplace SDK Uygulama Yapılandırması sayfasına ve OAuth onay ekranınıza eklediğinizden emin olun.
Her zaman mümkün olan en dar kapsamları kullanın (ör. yalnızca salt okunur bir kapsama ihtiyacınız varsa tam bir Drive kapsamı eklemeyin).
Apps Komut Dosyası projeleri için daha fazla bilgi edinmek üzere Yetkilendirme kapsamları başlıklı makaleyi inceleyin.
Uygulama geliştiricisi hakkında bilgi verme
Geliştirici Bilgileri bölümünde iletişim bilgilerini ve diğer ayrıntıları girin. Bu alanlar, uygulamanızın mağaza girişi sayfasında görünür.
| Alanlar | |
|---|---|
| Tüccar durumu |
Tüketiciyi koruma yasaları uyarınca, Avrupa Ekonomik Alanı'nda (AEA) ikamet eden tüketicilere, pazar yerindeki bir satıcının tacir mi yoksa tacir olmayan mı olduğu bildirilmelidir:
Belirtilmemişse uygulamanızın mağaza girişi sayfasında "Tacir durumu belirtilmemiş" ifadesi gösterilir. |
| Geliştirici adı | Uygulamanın yazarı olarak gösterilecek ad. Tüccarsanız ticari adınızı veya yasal adınızı girin. |
| Geliştiricinin posta adresi |
Tüccarlar için gereklidir. Tacir olmayanlar için toplanmaz. İşletmenizin bulunduğu konum. Sizinle iletişime geçebileceğimiz geçerli bir posta adresi girin. |
| Geliştirici web sitesi URL'si | Sizi (veya kuruluşunuzu) geliştirici olarak tanımlayan web sitesi. |
| Geliştiricinin e-posta adresi |
İletişim noktası olarak kullanılacak e-posta adresi. Uygulama girişinize dahil edilmez. Bu e-posta adresinin güncel tutulduğundan emin olun. Bu adres şu amaçlarla kullanılır:
|
| Uygulama web sitesi URL'si | İsteğe bağlıdır. Uygulamanızı daha ayrıntılı olarak açıklayan web sitesi. |
Uygulama yapılandırma ayarlarınızı Marketplace SDK'sına kaydetme
Önceki bölümdeki bilgileri kullanarak uygulama yapılandırmanızı Marketplace SDK'sına kaydedin:
Google Cloud Console'da Marketplace SDK Uygulama Yapılandırması sayfasına gidin:
Her bölümü önceki bölümde belirlediklerinize göre doldurun.
Taslağı 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 Google Analytics kimliği ekleyin.
- Analytics sekmesine gidin.
- Google Analytics kimliğinizi girin.
- Kaydet'i tıklayın.
Sorun giderme
Bu bölümde, karşılaşabileceğiniz yaygın sorunlar açıklanmaktadır.
Uygulamalar Marketplace'te yayınlanırken gerekli izinler eksik
Marketplace SDK'sının Uygulama Yapılandırması sayfasında uygulama yapılandırma girişimleri aşağıdaki hata mesajıyla başarısız olduğundan Marketplace'te uygulama yayınlayamıyorsunuz:
You are missing at least one of the following required permissions: Project workspacemarketplace.appconfiguration.view / workspacemarketplace.appconfiguration.update
Bu hata, Marketplace SDK API etkinleştirildiğinde ve Editor veya Owner dışında bir IAM rolü kullanılırken oluşur.
Hatayı düzeltmek için aşağıdaki çözümlerden birini uygulayın:
Proje sahibinden, Marketplace SDK'da uygulamayı yapılandırmasına ve yönetmesine izin vermek için eksik izinlere sahip hesaba
roles/appmetadata.workspaceMarketplaceAppConfigurationAdminrolünü atamasını isteyin.Proje sahibinden, Google Cloud Console'daki IAM ve Yönetici > Roller sayfasından özel bir role eksik izinleri eklemesini isteyin. Ardından, özel rolü eksik izinlere sahip hesaba atayın.
Uygulama yayınlamak için ilkel
roles/editorveyaroles/ownerkullanılabilir. Ancak IAM'yi güvenli bir şekilde kullanma dokümanında, projede düzenleme erişimini diğer kaynaklarla kolayca kısıtlayamadığınız için bu kötü bir uygulama olarak kabul edilir.