Data Manager API için kullanıcı kimlik bilgilerini harici kullanıcılardan isteyen bir uygulamayı kullanıma sunmadan önce Google Cloud projenizin Google OAuth uygulama doğrulamasından geçmesi gerekir.
Bu kılavuzda, geliştirme sırasında önerilen Kitle yapılandırması geçişleri ve Google OAuth uygulama doğrulamasını tamamlama adımları ele alınmaktadır.
Uygulama kitlesi aşamaları
Geliştirme aşamanıza bağlı olarak Google Cloud Console'daki Kitle sayfasını farklı Kullanıcı türü ve Yayınlama durumu ayarlarıyla yapılandırın. İlk testten üretim lansmanına sorunsuz bir geçiş için bu aşamaları izleyin.
1. Aşama: İlk geliştirme (Test)
Geliştirmeye ve temel API isteklerini test etmeye başlarken:
Yayınlanma durumu: Test ediliyor olarak ayarlanmalıdır.
Kullanıcı türü:
Google Cloud projeniz bir Google Workspace kuruluşuna aitse ve uygulamayı yalnızca kuruluşunuzdaki kullanıcılar kullanıyorsa Dahili'yi seçin.
Aksi takdirde Harici'yi seçin.
Test kullanıcıları: Kullanıcı türü'nü Harici olarak ayarladıysanız kimlik bilgileri oluşturmak için kullandığınız Google Hesaplarını manuel olarak eklemek üzere Kullanıcı ekle'yi tıklayın. Yalnızca listedeki Google Hesapları uygulamayı yetkilendirebilir. Test sınırları ve jeton geçerlilik süresi kuralları geçerlidir.
Test sırasında doğrulama gerekmez. Harici'yi kullanırsanız test kullanıcıları, kullanıcı rızası ekranına geçmeden önce doğrulanmamış bir uygulamaya test erişimleri olduğunu onaylayan bir uyarı ekranı görür.
2. Aşama: Lansmana yakın (Doğrulama gönderimi)
Entegrasyonunuz tamamlandığında, kullanıcı arayüzünüz oluşturulduğunda ve önümüzdeki ay içinde lansman yapmayı planladığınızda:
Kitle sayfası ayarlarını güncelleyin:
Yayınlanma durumu: Üretimde durumuna geçiş yapın.
Kullanıcı türü: Uygulamanız, kuruluşunuzun dışındaki müşterilere (ör. reklamveren müşterileri) hizmet veriyorsa Harici olarak ayarlayın.
Uygulamanızı doğrulama için gönderin. Google OAuth uygulaması doğrulama süreci birkaç hafta sürebilir. Bu nedenle, kullanıcı arayüzünüz hazır olduğunda mümkün olan en kısa sürede gönderin.
Uygulama doğrulama şartları
Uygulamanızı Doğrulama Merkezi'nde doğrulamaya göndermek için Google Auth Platform ayarlarınızı yapılandırın ve gerekli doğrulama materyallerini hazırlayın.
Markalama ve gizlilik politikası
Google Cloud Console'daki Markalama sayfasında, göndermeden önce aşağıdaki bilgileri doğrulayın:
Uygulama ana sayfası: Ana sayfanız herkese açık olmalı ve uygulamanızın gizlilik politikasına görünür bir bağlantı içermelidir.
Gizlilik politikası bağlantısı: Markalama sayfasında yapılandırılan gizlilik politikası URL'si, uygulamanızın ana sayfasında bağlantısı verilen gizlilik politikası URL'siyle eşleşmelidir.
Doğrulama kapsamları
Veri Erişimi sayfasında yalnızca uygulamanızın gerektirdiği kapsamları isteyin. Data Manager API, hassas kapsamlar kullanır:
https://www.googleapis.com/auth/datamanager(Birincil kapsam)https://www.googleapis.com/auth/datamanager.partnerlink(İş ortağı bağlantıları için)
Doğrulama gönderiminizde, uygulamanızın istenen kapsamlara neden erişmesi gerektiğini yazılı olarak ayrıntılı bir şekilde açıklayın.
İletişim bilgileri
Google OAuth doğrulama ekibi, tüm iletişimleri Google Cloud projenizde yapılandırılan proje sahiplerine ve proje düzenleyicilerine gönderir. Bilgi taleplerini kaçırmamak için Google Cloud konsolunda bu kişi ayrıntılarını güncel tutun.
Doğrulama ekibi ek sorular gönderirse veya güncelleme (ör. tanıtım videonuzda ya da kullanıcı rızası ekranı ayarlarınızda değişiklik) isterse siz yanıt verene kadar inceleme duraklatılır. Gönderiminiz birkaç haftadan uzun süredir beklemedeyse ve güncelleme yapılmadıysa tüm proje sahiplerinin ve proje düzenleyicilerinin e-posta gelen kutularını (spam ve önemsiz klasörleri dahil) kontrol edin.
Tanıtım videosu
Uygulamanızın istenen kapsamları nasıl kullandığını gösteren, herkese açık bir tanıtım videosunun bağlantısını (ör. liste dışı bir YouTube videosu veya herkese açık bir Google Drive bağlantısı) sağlayın.
Videonun, aşağıdaki Veri Yöneticisi API'si kontrolleri de dahil olmak üzere Uygulama işlevselliği tanıtım videosu şartlarının tümünü karşıladığından emin olun:
Uçtan uca kullanıcı yolculuğu ve OAuth erişim izni: Kullanıcının oturum açma veya yetkilendirme işlemini başlatmasından OAuth erişim izni akışını tamamlamasına kadar uygulamanızdaki tüm kullanıcı yolculuğunu gösterin.
Eşleşen uygulama kimliği: Videoda gösterilen uygulama adı, logo ve markanın Google Cloud Console'daki Marka bilinci oluşturma sayfası yapılandırmasıyla eşleştiğinden emin olun.
OAuth kullanıcı rızası ekranını İngilizce olarak doldurun: Sol alt köşedeki dil seçici İngilizce olarak ayarlanmış şekilde OAuth kullanıcı rızası ekranının tamamını gösterin ve ekranın, uygulamanızın istediği Data Manager API kapsamlarını tam olarak gösterdiğinden emin olun.
Uygulamanızın kullanıcı arayüzünde kapsam kullanımı: İstenen kapsamları kullanan uygulama özelliklerini gösterin (ör. uygulamanızın kullanıcı arayüzünde iş ortağı bağlantısı oluşturma, kitle listesi oluşturma veya veri kullanımı yapılandırma).
3. aşama: Lansmana hazır (Doğrulandı)
Google OAuth doğrulama ekibi, uygulama doğrulama isteğinizi onayladığını bildirdikten sonra herhangi bir işlem yapmanız gerekmez. Uygulamanız artık doğrulandı. Kuruluş dışı kullanıcılar, doğrulanmamış uygulama uyarı ekranıyla karşılaşmadan uygulamayı yetkilendirebilir.