Google API'lerine erişen tüm uygulamalar, Google'ın API Hizmetleri Kullanıcı Verileri Politikası'nda belirtildiği şekilde kimliklerini ve amaçlarını doğru bir şekilde beyan ettiklerini doğrulamalıdır. Sizi, Google'ın ve uygulamanızın paylaşılan kullanıcılarını korumak için kullanıcı rızası ekranınızın ve uygulamanızın Google tarafından doğrulanması gerekebilir.
Uygulamanız aşağıdaki ölçütlerin tümünü karşılıyorsa doğrulama gerekir:
- Google API Konsolu'nda uygulamanızın yapılandırması, Harici kullanıcı türü ve Yayınlandı yayınlanma durumu için ayarlanmıştır. Bu, uygulamanızın üretim aşamasında olduğu ve Google Hesabı olan tüm kullanıcılar tarafından kullanılabileceği anlamına gelir.
- Uygulamanızın OAuth kullanıcı rızası ekranında bir logo veya görünen ad göstermesini istiyorsanız.
Uygulamanızın marka bilgilerini doğrularsanız kullanıcıların markanızı tanıma ve uygulamanıza erişim izni verme olasılığını artırabilirsiniz. Doğrulanmış marka bilgileri, kullanıcılar veya Google Workspace yöneticileri hesaba erişimi olan üçüncü taraf uygulamalarını ve hizmetlerini incelerken daha az iptal işlemi yapılmasına da yardımcı olabilir. Otomatik marka doğrulama süreci, Markayı Doğrula düğmesini tıklamanızın ardından genellikle birkaç dakika sürer. Bazı durumlarda, sonucun otomatik olarak belirlenemediği durumlarda uygulamanız, genellikle 2-3 iş günü süren manuel inceleme sürecinden geçebilir.
Uygulamanızın marka bilgileri doğrulanmazsa kullanıcıların veri isteklerinize duyduğu güven azalabilir. Bu da daha az kullanıcı yetkilendirmesine ve daha sonra daha fazla iptale yol açabilir.
OAuth izin ekranı
Kullanıcı rızası ekranı, Şekil 1'deki 2 numaralı kutuda vurgulandığı gibi, kullanıcıların verilerine kimin erişim istediğini ve uygulamanızın kullanıcılar adına ne tür verilere erişmesi gerektiğini gösterir.
Uygulamanız marka doğrulama sürecinden geçip onay aldığında, uygulamanızın kimliği ve kullanıcı verileri politikaları, izin veren hesap tarafından daha net anlaşılır. Bu net anlayış, hesap sahibinin isteklerinizi yetkilendirme ve Google Hesabı sayfasında olası iptalleri incelerken erişimi sürdürme olasılığını artırabilir. Cloud Console'daki OAuth Markalama sayfasında yapılandırdığınız içerik aşağıdaki bileşenleri doldurur:
- Uygulamanızın adı ve logosu (Şekil 1'deki 1 numaralı kutuda gösterildiği gibi)
- Uygulamanızın adı seçildikten sonra görünen kullanıcı destek e-postanız (Şekil 1'deki 2. kutu)
- Gizlilik politikanızın ve hizmet şartlarınızın bağlantıları (Şekil 1'deki 3. kutu)
Yetkilendirilen alanlar
Marka doğrulama süreci kapsamında Google, bir uygulamanın OAuth kullanıcı rızası ekranı ve kimlik bilgileriyle ilişkili tüm alan adlarının doğrulanmasını zorunlu kılar. Genel sonekte kayda açık olan alan bileşenini doğrulamanızı isteriz: "üst düzey özel alan". Örneğin, uygulama ana sayfası https://sub.example.com/product olarak yapılandırılmış bir OAuth kullanıcı rızası ekranı, hesap sahibinden example.com alanının sahipliğini doğrulamasını ister.
OAuth kullanıcı rızası ekranı düzenleyicisinin Yetkili alanlar bölümü, Uygulama alanı bölümünün URI'larında kullanılan gizli üst düzey alanları içermelidir. Bu alanlar arasında uygulama ana sayfası, gizlilik politikası ve hizmet şartları yer alır. Yetkili alanlar bölümünde, "Web uygulaması" OAuth istemci türlerinizde yetkilendirilmiş yönlendirme URI'leri veya JavaScript kaynakları da bulunmalıdır.
Google Search Console'u kullanarak yetkili alanlarınızın sahipliğini doğrulayın. Bir alan için sahip izinlerine sahip bir Google Hesabı, bu yetkili alanı kullanan API Console projesiyle ilişkilendirilmelidir. Google Search Console'da alan doğrulamaları hakkında daha fazla bilgi için Site sahipliğinizi doğrulama başlıklı makaleyi inceleyin.
Doğrulamaya hazırlanma adımları
Verilere erişim istemek için Google API'lerini kullanan tüm uygulamaların marka doğrulamasını tamamlamak için aşağıdaki adımları uygulaması gerekir:
- Uygulamanızın, Doğrulama şartlarıyla ilgili istisnalar bölümündeki kullanım alanlarından hiçbirine girmediğini onaylayın.
- Uygulamanızın, ilişkili API'lerin veya ürünün markalarla ilgili koşullarına uyduğundan emin olun. Örneğin, Google ile Oturum Açma kapsamlarıyla ilgili markalama kurallarına bakın.
- Google Search Console'da projenizin yetkili alanlarının sahibi olduğunuzu doğrulayın. API Konsolu projenizle Sahip veya Düzenleyici olarak ilişkilendirilmiş bir Google Hesabı kullanın.
- OAuth kullanıcı rızası ekranındaki tüm marka bilgilerinin (ör. uygulama adı, destek e-postası, ana sayfa URI'si, gizlilik politikası URI'si vb.) uygulamanın kimliğini doğru şekilde yansıttığından emin olun.
Uygulama ana sayfası koşulları
Ana sayfanızın aşağıdaki koşulları karşıladığından emin olun:
- Ana sayfanız yalnızca sitenize giriş yapmış kullanıcılar tarafından değil, herkes tarafından erişilebilir olmalıdır.
- Ana sayfanızın, incelenen uygulamayla olan ilgisi net olmalıdır.
- Uygulamanızın Google Play Store'daki girişine veya Facebook sayfasına yönlendiren bağlantılar, geçerli uygulama ana sayfaları olarak kabul edilmez.
Uygulama gizlilik politikası bağlantısı şartları
Uygulamanızın gizlilik politikasının aşağıdaki şartları karşıladığından emin olun:
- Gizlilik politikası, kullanıcılar tarafından görülebilmeli, uygulamanızın ana sayfasıyla aynı alanda barındırılmalı ve Google API Konsolu'nun OAuth kullanıcı rızası ekranında bağlantısı verilmelidir. Ana sayfada uygulamanın işlevinin açıklamasının yanı sıra gizlilik politikası ve isteğe bağlı hizmet şartları bağlantılarının bulunması gerektiğini unutmayın.
- Gizlilik politikasında, uygulamanızın Google kullanıcı verilerine nasıl eriştiği, bu verileri nasıl kullandığı, sakladığı veya paylaştığı açıklanmalıdır. Google kullanıcı verilerini kullanımınızı, yayınlanan gizlilik politikanızda açıklanan uygulamalarla sınırlamanız gerekir.
Uygulamanızı marka doğrulaması için gönderme
Google Cloud Console projesi, tüm Cloud Console kaynaklarınızı düzenler. Proje; proje işlemlerini gerçekleştirme iznine sahip bir dizi ilişkili Google Hesabı, bir dizi etkin API ve bu API'ler için faturalandırma, kimlik doğrulama ve izleme ayarlarından oluşur. Örneğin, bir proje bir veya daha fazla OAuth istemcisi içerebilir, bu istemciler tarafından kullanılacak API'leri yapılandırabilir ve kullanıcılar uygulamanıza erişim yetkisi vermeden önce gösterilecek bir OAuth kullanıcı rızası ekranı yapılandırabilir.
OAuth istemcilerinizden herhangi biri üretime hazır değilse bunları doğrulama isteyen projeden silmenizi öneririz. Bu işlemi Müşteriler sayfasında yapabilirsiniz.
Doğrulama için göndermek üzere aşağıdaki adımları uygulayın:
- Uygulamanızın Google API'leri Hizmet Şartları'na ve Google API Hizmetleri Kullanıcı Verileri Politikası'na uygun olduğundan emin olun.
- Projenizin ilişkili hesaplarının sahip ve düzenleyici rollerini, OAuth kullanıcı rızası ekranınızın kullanıcı destek e-postasını ve geliştirici iletişim bilgilerini Cloud Console'da güncel tutun. Böylece yeni şartlar hakkında ilgili ekip üyeleriniz bilgilendirilir.
- Cloud Console OAuth Markalama sayfasına gidin.
- Proje seçici düğmesini tıklayın.
- Açılan Seçim yapın iletişim kutusunda projenizi seçin. Projenizi bulamıyorsanız ancak proje kimliğinizi biliyorsanız tarayıcınızda aşağıdaki biçimde bir URL oluşturabilirsiniz:
https://console.developers.google.com/auth/branding?project=[PROJECT_ID]
- Markalama sayfasında uygulamanızın markalama bilgilerini (uygulama adı, logo, geliştirici iletişim bilgileri ve ilgili bağlantılar dahil) girin. Yaptığınız tüm değişiklikler Taslak Marka Öğeleri olarak kaydedilir.
- Değerlendirme sürecini başlatmak için Marka Öğelerini Doğrula düğmesini tıklayın. Otomatik inceleme genellikle birkaç dakika içinde tamamlanır.
- Değerlendirme tamamlandıktan sonra durumu inceleyin. İşlem başarılı olursa durum Yayınlanmaya hazır olarak değişir. Otomatik doğrulama başarısız olursa tespit edilen sorunları görebilir ve bunları düzeltebilir ya da manuel inceleme isteğinde bulunabilirsiniz.
- Yeni markalamayı yayınlamak için Markalamayı yayınla düğmesini tıklayın.
- Uygulamanız hassas veya kısıtlanmış kapsamlar için de doğrulama gerektiriyorsa OAuth Doğrulama Merkezi'ne giderek Veri erişim durumunuzu takip edin ve tanıtım videosu gibi istenen ek bilgileri sağlayın. Veri erişimi için doğrulama isteğinde bulunmadan önce yayınlanmış bir marka bilinci oluşturma durumunuzun olması gerektiğini unutmayın.
- Uygulamanızın istediği tüm kapsamları bildirmek için Kapsam ekle veya kaldır düğmesini kullanın. Google ile Oturum Açma için gerekli olan ilk kapsam grubu, Hassas olmayan kapsamlar bölümünde önceden doldurulur. Eklenen kapsamlar hassas olmayan, hassas veya kısıtlanmış olarak sınıflandırılır.
- Uygulamanızdaki ilgili özelliklerle alakalı belgeler için en fazla üç bağlantı sağlayın.
- Sonraki adımlarda uygulamanız hakkında istenen ek bilgileri sağlayın.
Markanızı yayınladıktan veya veri erişimi isteği gönderdikten sonra Google'ın Güven ve Güvenlik Ekibi, ihtiyaç duyduğu ek bilgileri veya tamamlamanız gereken adımları e-posta yoluyla iletebilir. Ek bilgi istekleri için Geliştirici iletişim bilgileri bölümündeki e-posta adreslerinizi ve OAuth kullanıcı rızası ekranınızın destek e-postasını kontrol edin. Projenizin mevcut inceleme durumunu (yanıtınızı beklerken inceleme sürecinin duraklatılıp duraklatılmadığı dahil) onaylamak için projenizin Markalama veya Doğrulama Merkezi sayfalarını da görüntüleyebilirsiniz.
Doğrulama şartlarıyla ilgili istisnalar
Uygulamanız aşağıdaki bölümlerde açıklanan senaryolardan herhangi birinde kullanılacaksa incelemeye göndermeniz gerekmez.
Kişisel kullanım
Uygulamanızın tek kullanıcısı sizseniz veya uygulamanız yalnızca birkaç kullanıcı tarafından kullanılıyorsa ve bu kullanıcıların tümünü şahsen tanıyorsanız bu kullanım alanından yararlanabilirsiniz. Siz ve sınırlı sayıdaki kullanıcılarınız, doğrulanmamış uygulama ekranını geçip kişisel hesaplarınıza uygulamanıza erişim izni vermeyi tercih edebilirsiniz.
Geliştirme, Test veya Hazırlık katmanlarında kullanılan projeler
Google OAuth 2.0 politikalarına uymak için test ve üretim ortamları için farklı projeler kullanmanızı öneririz. Uygulamanızı yalnızca Google Hesabı olan tüm kullanıcıların kullanımına sunmak istiyorsanız doğrulama için göndermenizi öneririz. Bu nedenle, uygulamanız geliştirme, test veya hazırlık aşamalarındaysa doğrulama gerekmez.
Uygulamanız geliştirme veya test aşamasındaysa Yayınlama Durumu'nu varsayılan ayar olan Test olarak bırakabilirsiniz. Bu ayar, uygulamanızın hâlâ geliştirme aşamasında olduğu ve yalnızca test kullanıcıları listesine eklediğiniz kullanıcılar tarafından kullanılabileceği anlamına gelir. Uygulamanızın geliştirme veya test sürecinde yer alan Google Hesaplarının listesini yönetmeniz gerekir.
Yalnızca hizmete ait veriler
Uygulamanız yalnızca kendi verilerine erişmek için bir hizmet hesabı kullanıyorsa ve herhangi bir kullanıcı verisine (bir Google Hesabı'na bağlı) erişmiyorsa doğrulama için göndermeniz gerekmez.
Hizmet hesaplarının ne olduğunu anlamak için Google Cloud belgelerindeki Hizmet hesapları bölümüne bakın. Hizmet hesabı kullanma talimatları için Sunucudan sunucuya uygulamalar için OAuth 2.0'ı kullanma başlıklı makaleyi inceleyin.
Yalnızca dahili kullanım
Bu, uygulamanın yalnızca Google Workspace veya Cloud Identity kuruluşunuzdaki kişiler tarafından kullanıldığı anlamına gelir. Projenin sahibi kuruluş olmalı ve OAuth kullanıcı rızası ekranı Dahili kullanıcı türü için yapılandırılmalıdır. Bu durumda, uygulamanızın bir kuruluş yöneticisinden onay alması gerekebilir. Daha fazla bilgi için Google Workspace için dikkat edilmesi gereken diğer noktalar başlıklı makaleyi inceleyin.
- Herkese açık ve dahili uygulamalar hakkında daha fazla bilgi edinin.
- Uygulamanızı nasıl dahili olarak işaretleyeceğinizi Uygulamamı nasıl yalnızca dahili olarak işaretleyebilirim? başlıklı SSS bölümünden öğrenebilirsiniz.
Alan genelinde yükleme
Uygulamanızın yalnızca bir Google Workspace veya Cloud Identity kuruluşunun kullanıcılarını hedeflemesini ve her zaman alan genelinde yükleme kullanmasını planlıyorsanız uygulamanız için marka doğrulaması gerekmez. Ancak uygulamanız kısıtlanmış veya hassas kapsamlar kullanıyorsa uygulama doğrulaması gerekir. Bunun nedeni, alan genelinde yüklemenin, alan yöneticisinin üçüncü taraf ve dahili uygulamalara kullanıcılarınızın verilerine erişim izni vermesine olanak tanımasıdır. Uygulamayı alan adlarında kullanılmak üzere izin verilenler listesine yalnızca kuruluş yöneticileri ekleyebilir.
Uygulamanızı nasıl alan genelinde yükleme yapacak şekilde ayarlayacağınızı öğrenmek için Uygulamamda başka bir Google Workspace alanından kurumsal hesabı olan kullanıcılar var başlıklı SSS bölümünü inceleyin.