AdMob API'yi kullanmaya başlama

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şime geçebilmesi 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ının kullanıcı adını veya şifresini işlemek ya da depolamak zorunda kalmadan kullanıcının AdMob hesabına erişebilmesini sağlar. Yetkilendirmeye genel bakış için Yetkilendirme başlıklı makaleyi inceleyin.

OAuth2 kimlik bilgilerini oluşturmak ve ilk isteğinizi göndermek için aşağıdaki adımları uygulayın.

Ön koşullar

Kimlik doğrulama türünüzü belirleme

Uygulamanız için en uygun kimlik doğrulama türünü 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ı
  • Tüm AdMob API hesaplarınızı tek bir üst düzey yönetici hesabı kullanarak yönetiyorsunuz.
  • İlk kez kullanıcıysanız veya en basit kurulumla hızlıca başlamak istiyorsanız
  • Uygulamanız, Google AdMob kullanıcılarının kimliğini yalnızca tek bir makineden doğrular.
Web uygulaması
  • Uygulamanızın, AdMob API hesabı verilerine erişmesine izin verebilecek bir kullanıcı olarak kimlik doğrulaması yapmak istiyorsunuz.
  • Örneğin, üçüncü taraf hesapları yönetmek için birden fazla yetkilendirme kimlik bilgisini kolayca oluşturmak istiyorsunuz.
  • Uygulamanız için geri çağırma URL'leri gerekiyor. Geri çağırma URL'leri, masaüstü uygulaması akışında desteklenmez.

Proje oluşturma

AdMob API'yi kullanmaya başlamak için öncelikle Google API Konsolu'nda bir proje oluşturmanız veya seçmeniz ve API'yi etkinleştirmek için kurulum aracını kullanmanız gerekir. Bu araç, işlem boyunca size rehberlik eder ve AdMob API'sini 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 proje için manuel olarak etkinleştirmeyi tercih eden kullanıcılar için geçerlidir.

OAuth2 kimlik bilgileri oluşturma

Aşağıdaki talimatlar, yüklü uygulama akışıyla kullanılacak bir OAuth 2.0 istemci kimliği oluşturma sürecinde size yol gösterecektir.

  2. KİMLİĞİ BİLGİLERİ OLUŞTUR > OAuth istemci kimliği'ni tıklayın.

    Bu proje için daha önce bir OAuth izin ekranı yapılandırmadıysanız bunu hemen yapmanız istenir. İ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.

    1. Kullanıcı türünüzü Harici ve yayınlama durumunuzu Yayınlandı olarak ayarlayın.

    2. Alternatif olarak, kullanıcı türünüzü Harici, yayınlama durumunu Test olarak ayarlayın ve ardından Kullanıcı ekle'yi seçerek Test kullanıcıları ekleyin. Böylece, OAuth 2.0 istemci kimliğinizi kullanmalarına erişim izni vermiş olursunuz.

      OAuth izin ekranınızı ayarlama hakkında daha fazla bilgi edinin.

  3. 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ı gösterilir.

İstekte bulunun

AdMob API'si HTTP ve JSON üzerine kurulu olduğundan herhangi bir standart HTTP istemcisi ona istek gönderebilir, yanıtları ayrıştırabilir. Ancak Google API istemci kitaplıkları daha iyi dil entegrasyonu ve daha yüksek güvenlik sağlamanın yanı sıra yetkili isteklerin yapılmasını da destekler. İstemci kitaplıkları çeşitli programlama dillerinde kullanılabilir. Bu diller sayesinde, 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. Uygulamanızın OAuth 2.0 kullanarak erişim isteğinde bulunabilmesi için kapsam bilgilerine de ihtiyacı vardır:

Kapsam Anlamı
https://www.googleapis.com/auth/admob.readonly Tüm AdMob verilerini görme. Bu verilere hesap bilgileri, envanter ve uyumlulaştırma ayarlarınız, raporlarınız ve diğer verileriniz 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örme Yayıncı kimliğini, saat dilimini ve varsayılan para birimi kodunu görme

Java, PHP, Python veya curl örnekleri kullanarak rapor oluşturmak için ilk isteğinizi gönderin.

Paylaşılan jetonları iptal etme

Paylaşılan jetonları iki şekilde iptal edebilirsiniz:

  1. Google Hesabı izinleri sayfanıza gidin ve ilgili projeden erişimi iptal edin.

  2. Alternatif olarak, Google Identity API'yi kullanarak web uygulaması jetonlarını iptal edebilirsiniz.