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ın kullanılabilir olması 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 pazar yeri ayarlarını yönetmek için Marketplace SDK'sını kullanırsınız:
- Uygulamanızın belirli bir Google Workspace kuruluşu (gizli 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ı türleri
- Uygulamanızın entegre olduğu Google Workspace uygulamaları
- 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'sını 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çin
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'e, Google Chat uygulamalarına 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 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ü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.
- Gizli: Uygulamanızı yalnızca alanınızdaki kullanıcılar bulabilir ve yükleyebilir.
Listelenmemiş 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 listelemesini 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 listeleme sayfanızdan yükleyip yükleyemeyeceğini belirler.
- Bireysel + Yönetici Yüklemesi (varsayılan): Uygulama, bireysel kullanıcılar veya yöneticiler tarafından kendi 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 + 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 | Gizli | Bireysel + Yönetici Yüklemesi | İzin verilirse kuruluşunuzdaki herkes. | İzin verilirse kuruluşunuzdaki herkes. | |
| Kuruluşunuz | Gizli | Yalnızca yönetici | Yöneticiler | Uygulamayı yöneticileri tarafından yüklenmiş olan 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üklenmiş olan kullanıcılar | |
| Tüm Google Workspace kullanıcıları | Herkese açık | Bireysel + Yönetici Yüklemesi |
|
|
|
Uygulamanızın Google Workspace uygulamalarıyla nasıl entegre olduğunu belirleme
Uygulama Entegrasyonları seçeneği, uygulamanızın veya eklentinizin birlikte çalışmak üzere tasarlandığı Google Workspace hizmetlerini (ör. Google Workspace eklentisi veya Google Chat uygulaması) seçmenize olanak tanır. 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.
Sayfada, her Google Workspace eklentisi için desteklediği her ana ürünün yayınlanma durumu gösterilir. Bu sayede, kullanıcılarınızın hangi entegrasyonlardan yararlanabileceğini anlayabilirsiniz. Aşağıdaki uygulama entegrasyonu durumları olasıdır:
Unsaved: Bir entegrasyon eklediniz veya değiştirdiniz ancak Uygulama Yapılandırması sekmesindeki değişiklikleri kaydetmediniz.Draft: Değişiklikleriniz kaydedildi ancak yayınlanmadı.Under review: Güncellenen uygulama entegrasyonunuzu incelemeye gönderdiniz.Published: Uygulama entegrasyonunuz Marketplace girişine dahil edilmiştir.
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 Komut Dosyası'nda dağıtım kimliğini bulmak için aşağıdaki adımları uygulayın:
- Google Workspace eklentinizi Apps Komut Dosyası Düzenleyici'de 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 eklentisini 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üzenleyicisi'nde 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üzenleyicisi'nde 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ı Chat API'de yapılandırmak için Chat API'yi yapılandırma başlıklı makaleyi inceleyin.
- Google Workspace eklentisi olmayan bir Chat uygulaması oluşturduysanız Chat API'de etkileşim etkinliği ayarlarını yapılandırmanız gerekir. Adımlar için Kullanıcı etkileşimlerini alma ve yanıtlama başlıklı makaleyi inceleyin.
- Chat uygulamanızı AppSheet'in otomatik yapılandırmasıyla oluşturduysanız AppSheet dokümanlarında 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ı
Web uygulaması 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 Komut Dosyası Düzenleyici'de 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 kullanıcı rızası ekranınızda ve varsa Apps Komut Dosyası manifestinizde gösterdiklerinizle eşleşmelidir.
Birden fazla uygulama entegrasyonu ekliyorsanız her birinin kapsamlarını Marketplace SDK Uygulama Yapılandırması sayfasına ve OAuth kullanıcı rızası 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 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ı'ndaki (AEA) 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 zorunludur. Tacir olmayanlar 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ş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,
roles/appmetadata.workspaceMarketplaceAppConfigurationAdminrolünü eksik izinlere sahip hesaba atamasını isteyin. Böylece, bu hesap Marketplace SDK'da uygulamayı yapılandırıp yönetebilir.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.
Uygulamaları yayınlamak için
roles/editorveyaroles/ownerkullanılabilir. Ancak IAM'yi güvenli bir şekilde kullanma dokümanında, projede düzenleme erişiminin diğer kaynaklarla kolayca sınırlandırılamaması nedeniyle bu kötü bir uygulama olarak kabul edilir.