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.
为您的项目启用API:
- Open the API Library中的Google API Console 。
- If prompted, select a project, or create a new one. API Library列出了所有可用的API,并按产品家族和受欢迎程度分组。
- 如果您要启用的API在列表中不可见,请使用搜索找到它,或单击其所属产品系列中的“ 查看全部 ”。
- 选择要启用的API,然后单击“ 启用”按钮。
- 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.