OAuth kurulumu

Uygulamanızın kullanıcı adına web hizmetleriyle etkileşimde bulunabilmesi 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ş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çin Ş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 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 istiyorsanız.
  • Ö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'yi kullanmaya başlamak için öncelikle 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 yol gösterir 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 proje için manuel olarak etkinleştirmeyi tercih eden kullanıcılar için geçerlidir.

Projeniz için bir API'yi etkinleştirmek üzere:

  1. Google API Konsolu'nda API Kitaplığı'nı açın.
  2. İstenirse bir proje seçin veya yeni bir proje oluşturun. API Kitaplığı'nda, ürün ailesine ve popülerliğe göre gruplandırılmış tüm kullanılabilir API'ler listelenir.
  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. İstenirse faturalandırmayı etkinleştirin.
  6. İstenirse API'nin Hizmet Şartları'nı okuyup kabul edin.

OAuth2 kimlik bilgileri oluşturma

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

  1. Müşteriler sayfasına gidin.

  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 kullanıcı rızası ekranı yapılandırmadıysanız şimdi bunu yapmanız istenir. CONFIGURE CONSENT SCREEN'i (KULLANICI RIZASI EKRANINI YAPILANDIR) tıklayın. Kullanıcı rızası 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 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ı ekleyin. Böylece, bu kullanıcılara OAuth 2.0 istemci kimliğinizi kullanma erişimi vermiş olursunuz.

      OAuth kullanıcı rızası ekranınızı ayarlama hakkında ek bilgi edinin.

  3. Uygulama türü olarak Masaüstü uygulaması veya Web uygulaması'nı seçin, 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; 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örebilir. Buna hesap bilgileri, envanter ve arabuluculuk 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üleme Yayıncı kimliği, saat dilimi ve varsayılan para birimi kodunu görün.

Java, PHP, Python veya curl'daki ö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.