İlk istemci uygulamanızı kodlamaya başlamadan önce, henüz yapmadıysanız tamamlamanız gereken birkaç şey vardır.
Google Hesabı edinin
Google API Konsolu'nda proje oluşturmak için Google Hesabınızın olması gerekir. Hesabınız varsa başka bir şey yapmanız gerekmez.
Test amacıyla ayrı bir Google Hesabı da kullanmak isteyebilirsiniz.
Google AdMob'u deneme
Bu API belgesinde, Google AdMob'u daha önce kullandığınız ve web programlama kavramları ile web veri biçimleri hakkında bilgi sahibi olduğunuz varsayılır.
Google AdMob'u daha önce hiç kullanmadıysanız kodlamaya başlamadan önce kullanıcı arayüzünü deneyin.
İstemciniz için proje oluşturma
Google AdMob'a istek gönderebilmeniz için öncelikle Google'a istemcinizden bahsetmeniz ve API'ye erişimi etkinleştirmeniz gerekir. Bunun için, Google API Konsolu'nu kullanarak proje (ayarlar ve API erişim bilgilerinin adlandırılmış bir koleksiyonu) oluşturur ve uygulamanızı kaydedersiniz.
AdMob API'yi kullanmaya başlamak için önce kurulum aracını kullanmanız gerekir. Bu araç, Google API Konsolu'nda proje oluşturma ve API'yi etkinleştirme konusunda size rehberlik eder.
REST ile ilgili temel bilgileri öğrenin
REST, veri isteme ve değiştirmeye kullanışlı ve tutarlı yaklaşım sağlayan bir yazılım mimarisi stilidir.
REST terimi, "Representational State Transfer"in (Temsili Durum Aktarımı) kısaltmasıdır. Google API'leri bağlamında, Google tarafından saklanan verilerin temsillerini almak ve değiştirmek için HTTP fiillerini kullanma anlamına gelir.
RESTful bir sistemde, kaynaklar bir veri deposunda saklanır. Bir istemci, sunucunun belirli bir işlemi (ör. kaynak oluşturma, alma, güncelleme veya silme) gerçekleştirmesi için istek gönderir. Sunucu, işlemi gerçekleştirir ve yanıt gönderir. Bu yanıt genelde belirtilen kaynağın bir temsili biçimindedir.
Google'ın RESTful API'lerinde istemci, HTTP fiili kullanarak (ör. POST, GET, PUT veya DELETE) bir işlem belirtir. Aşağıdaki biçimde yer alan küresel olarak benzersiz bir URI ile kaynak belirtir:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Tüm API kaynaklarının HTTP tarafından erişilebilen benzersiz URI'ları olduğu için REST, veri önbelleğe almayı etkinleştirir ve web'deki dağıtılan altyapıyla birlikte çalışmak üzere optimize edilmiştir.
HTTP 1.1 standartları belgelerindeki yöntem tanımlarını yararlı bulabilirsiniz. Bu tanımlar, GET, POST, PUT ve DELETE özelliklerini içerir.
AdMob API'de REST
AdMob API işlemleri doğrudan REST HTTP fiilleriyle eşlenir.
AdMob API URI'lerinin biçimleri şu şekildedir:
https://admob.googleapis.com/v1/resourcePath?parameters
API'deki desteklenen her işlem için kullanılan URI'lerin tümü AdMob API Referansı belgesinde özetlenmiştir.
JSON ile ilgili temel bilgileri öğrenin
AdMob API, verileri JSON biçiminde döndürür.
JSON (JavaScript Object Notation), rastgele veri yapılarını basit metin biçiminde sunan, yaygın şekilde kullanılan ve dilden bağımsız bir veri biçimidir. Daha fazla bilgi için json.org adresine bakın.