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ş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

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ı
  • Tüm AdMob API hesaplarınızı tek bir üst düzey yönetici hesabı kullanarak yönetirsiniz.
  • Yeni bir kullanıcıysanız veya en basit kurulumla hızlı bir başlangıç yapmak istiyorsanız.
  • Uygulamanız Google AdMob kullanıcılarının kimliğini yalnızca bir makineden doğrular.
Web uygulaması
  • Uygulamanızın AdMob API hesap verilerine erişmesine izin verebilecek bir kullanıcı olarak kimlik doğrulaması yapmak istiyorsunuz.
  • Kolayca birden fazla yetkilendirme kimlik bilgisi oluşturmak (örneğin, üçüncü taraf hesaplarını yönetmek) istiyorsunuz.
  • Uygulamanız geri çağırma URL'leri gerektiriyor. Geri çağırma URL'leri masaüstü uygulaması akışında desteklenmez.

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.

Projeniz için bir API'yı etkinleştirmek için:

  1. Open the API Library içinde Google API Console .
  2. If prompted, select a project, or create a new one. API Library , ürün ailesi ve popülerliğe göre gruplandırılmış tüm kullanılabilir API'ları listeler.
  3. Etkinleştirmek istediğiniz API listede görünmüyorsa bulmak için aramayı kullanın veya ait olduğu ürün ailesindeki Tümünü Görüntüle'yi tıklayın.
  4. Etkinleştirmek istediğiniz API'yi seçin, ardından Etkinleştir düğmesini tıklayın.
  5. If prompted, enable billing.
  6. 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.

  1. Go to the Credentials page.
  2. 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.

    1. Kullanıcı türünüzü Harici, yayınlama durumunu ise Yayınlandı olarak ayarlayın.
    2. 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.

  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ı 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:

  1. Google hesabı izinleri sayfanıza gidin ve ilgili projenin erişimini iptal edin.

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