AdMob API'yi kullanmaya başlama

Bu kılavuz, AdMob API'yi kullanarak AdMob hesaplarındaki verileri programlı olarak ve yönetmek isteyen geliştiriciler içindir.

Uygulamanızın kullanıcı adına web hizmetleriyle etkileşimde bulunabilmesi için tüm Google AdMob API çağrıları OAuth2 üzerinden yetkilendirilmelidir. OAuth2, AdMob API istemci uygulamanızın kullanıcının kullanıcı adını veya şifresini işlemesi ya da depolaması gerekmeden kullanıcının AdMob hesabına erişmesini 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ün hangisi olduğunu görmek için aşağıdaki tabloya göz atın:

OAuth2 kimlik doğrulama türünüzü seçme Şu durumlarda:
Masaüstü uygulaması
  • Tüm AdMob API hesaplarınızı tek bir üst düzey yönetici hesabı kullanarak yönetiyorsunuz.
  • İlk kez kullanıyorsanız veya en basit kurulumla hızlıca başlamak istiyorsanız.
  • Uygulamanız yalnızca tek bir makineden gelen Google AdMob kullanıcılarının kimliğini doğrular.
Web uygulaması
  • Uygulamanızın AdMob API hesap verilerine erişmesine izin verebilecek bir kullanıcı olarak kimliğinizi doğrulamak istiyorsunuz.
  • Örneğin, üçüncü taraf hesaplarını yönetmek için birden fazla yetkilendirme kimlik bilgisini kolayca oluşturmak istiyorsanız.
  • 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'sini 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ç, 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 bu proje için manuel olarak etkinleştirmeyi tercih eden kullanıcılar için geçerlidir.

Projenizde bir API'yi 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 ailesine ve popülerliğe göre gruplandırılmış tüm kullanılabilir API'leri listeler.
  3. Etkinleştirmek istediğiniz API listede görünmüyorsa arama özelliğini kullanarak API'yi bulun veya ait olduğu ürün ailesinde Tümünü Göster'i tıklayın.
  4. Etkinleştirmek istediğiniz API'yi seçin ve 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ş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österir.

  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 bir OAuth izin ekranı yapılandırmadıysanız şimdi bunu yapmanız istenir. CONFIGURE CONSENT SCREEN'i (Kullanıcı rızası ekranını yapılandır) tıklayın. OAuth 2.0 istemci kimliğinizi kullanmak için izin ekranınızı yapılandırmanın birden fazla yolu vardır.

    1. Kullanıcı türünüzü Harici, yayınlanma durumunuzu ise Yayınlandı olarak ayarlayın.

    2. Alternatif olarak, kullanıcı türünüzü Harici, yayınlama durumunuzu ise Test olarak ayarlayın. Ardından, Kullanıcı ekle'yi seçerek Test kullanıcıları'nı ekleyin. Böylece bu kullanıcılara OAuth 2.0 istemci kimliğinizi kullanma erişimi 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 indirebileceğiniz ve 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, daha yüksek güvenlik ve yetkilendirilmiş isteklerin yapılmasını destekler. İ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. 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örün. Bu verilere hesap bilgileriniz, 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ını 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'deki ö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 projenin erişimini iptal edin.

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