Bu kılavuz, AdMob hesapları hakkında programatik olarak bilgi almak için AdMob API'yi kullanmak isteyen geliştiriciler için hazırlanmıştır.
Uygulamanızın, kullanıcı adına web hizmetleriyle etkileşim kurabilmesi için tüm Google AdMob API çağrılarının OAuth2 üzerinden yetkilendirilmesi gerekir. OAuth2, AdMob API istemci uygulamanızın, kullanıcı adı ve şifresini kullanmak ya da depolamak zorunda kalmadan kullanıcının AdMob hesabına erişebilmesini sağlar. Yetkilendirmeye genel bakış için Yetkilendirme sayfasını inceleyin.
OAuth2 kimlik bilgilerini oluşturmak ve ilk isteğinizi yapmak için aşağıdaki adımları uygulayın.
Ön koşullar
Bir Google Hesabı.
REST ile ilgili temel bilgiler ve OAuth 2.0 ile istekleri yetkilendirme hakkında bilgi sahibi olun.
Kimlik doğrulama türünüzü belirleme
Uygulamanız için hangi kimlik doğrulama türünün en uygun olduğunu görmek üzere aşağıdaki tabloya göz atın:
OAuth2 kimlik doğrulama türünüzü seçin | Eğer ... |
---|---|
Masaüstü uygulaması |
|
Web uygulaması |
|
Proje oluşturma
AdMob API'yi kullanmaya başlamak için önce Google API Konsolu'nda bir proje oluşturmanız veya seçmeniz ve kurulum aracını kullanarak API'yi etkinleştirmeniz gerekir. Bu araç, süreç boyunca size rehberlik eder ve AdMob API'yi otomatik olarak etkinleştirir.
Mevcut bir proje için API'yi etkinleştirme
Aşağıdaki adımlar, mevcut bir projesi olan ve AdMob API'yi bu projede manuel olarak etkinleştirmeyi tercih eden kullanıcılar için geçerlidir.
To enable an API for your project:
- Open the API Library in the Google API Console.
- If prompted, select a project, or create a new one. The API Library lists all available APIs, grouped by product family and popularity.
- If the API you want to enable isn't visible in the list, use search to find it, or click View All in the product family it belongs to.
- Select the API you want to enable, then click the Enable button.
- If prompted, enable billing.
- If prompted, read and accept the API's Terms of Service.
OAuth2 kimlik bilgileri oluştur
Aşağıdaki talimatlar, yüklü uygulama akışı ile kullanmak üzere OAuth 2.0 istemci kimliği oluşturma sürecinde size yol gösterecektir.
- Go to the Credentials page.
KİMLİK BİLGİLERİ OLUŞTUR > OAuth istemci kimliği'ni tıklayın.
Bu proje için daha önce OAuth izin ekranı yapılandırmadıysanız şimdi buna yönlendirilirsiniz. İZİN EKRANINI YAPILANDIR'ı tıklayın. İzin ekranınızı OAuth 2.0 istemci kimliğinizi kullanacak şekilde yapılandırmanın birden fazla yolu vardır.
- Kullanıcı türünüzü Harici, yayınlama durumunu ise Yayınlandı olarak ayarlayın.
Alternatif olarak, kullanıcı türünüzü Harici, yayınlama durumunu Test olarak ayarlayabilirsiniz. Ardından, OAuth 2.0 istemci kimliğinizi kullanmaları için erişim izni vermek amacıyla kullanıcı ekle'yi seçerek Test kullanıcıları'nı ekleyebilirsiniz.
OAuth izin ekranınızı ayarlama ile ilgili ek bilgilere bakın.
Uygulama türü olarak Masaüstü uygulaması veya Web Uygulaması'nı seçin, uygulamaya bir ad verin ve Oluştur'u tıklayın.
İşlem tamamlandığında, JSON biçiminde indirip daha sonra kullanmak üzere kaydedebileceğiniz bir OAuth 2.0 istemci kimliği ve istemci gizli anahtarı sunulur.
İstekte bulunun
AdMob API, HTTP ve JSON üzerine inşa edildiği için herhangi bir standart HTTP istemcisi ona istek gönderebilir ve yanıtları ayrıştırabilir. Bununla birlikte Google API istemci kitaplıkları, daha iyi dil entegrasyonu, daha yüksek güvenlik ve yetkili istekte bulunma desteği sağlar. İstemci kitaplıkları çeşitli programlama dillerinde kullanılabilir. Bunları kullanarak HTTP isteklerini manuel olarak oluşturma ve yanıtları ayrıştırma zahmetinden kurtulabilirsiniz.
OAuth 2.0 kimlik bilgileri oluşturulduktan sonra AdMob API'yi kullanmaya başlayabilirsiniz. OAuth 2.0 kullanarak erişim isteğinde bulunmak için uygulamanızın kapsam bilgilerine de ihtiyacı vardır:
Kapsam | Anlamı |
---|---|
https://www.googleapis.com/auth/admob.readonly |
Tüm AdMob verilerini görüntüleyin. Buna hesap bilgileri, envanter ve uyumlulaştırma ayarları, raporlar ve diğer veriler dahil olabilir. Ödemeler veya kampanya ayrıntıları gibi hassas veriler dahil değildir. |
https://www.googleapis.com/auth/admob.report |
Reklam performansı ve kazanç raporlarını görüntüleyin. Yayıncı kimliği, saat dilimi ve varsayılan para birimi kodunu görün. |
Java, PHP, Python veya curl'deki örnekleri kullanarak rapor oluşturmak için ilk isteğinizi yapın.
Paylaşılan jetonları iptal et
Paylaşılan jetonları iki şekilde iptal edebilirsiniz:
Google hesabı izinleri sayfanıza gidin ve ilgili projenin erişimini iptal edin.
Alternatif olarak, Google Identity API'yi kullanarak web uygulaması jetonlarını iptal edebilirsiniz.