İlk istemci uygulamanızı kodlamaya başlamadan önce, henüz yapmadıysanız yapmanız gereken birkaç şey vardır.
Bir Google Hesabı edinin
Google API Konsolu'nda proje oluşturmak için Google Hesabınız olması gerekir. Zaten hesabınız varsa hazırsınız demektir.
Test amacıyla ayrı bir Google Hesabı da isteyebilirsiniz.
Google Reklam Deneyimi Raporu'nu Deneyin
Bu API dokümanlarında, Google Reklam Deneyimi Raporu'nu kullandığınız ve web programlama kavramları ve web veri biçimleri hakkında bilgi sahibi olduğunuz varsayılır.
Google Reklam Deneyimi Raporu'nu kullanmadıysanız kodlamaya başlamadan önce kullanıcı arayüzünü deneyin.
İstemciniz için proje oluşturma
Google Reklam Deneyimi Raporu'na istek gönderebilmeniz için önce Google'a müşterinizi bildirmeniz ve API'ye erişimi etkinleştirmeniz gerekir. Bunu, Google API Konsolu'nu kullanarak bir proje (ayarlar ve API erişim bilgilerinin adlandırılmış bir koleksiyonu) oluşturup uygulamanızı kaydetmek için kullanırsınız.
REST ile ilgili temel bilgileri öğrenin
API'yi çağırmanın iki yolu vardır:
- HTTP istekleri gönderme ve yanıtları ayrıştırma.
- İstemci kitaplıklarını kullanma.
İstemci kitaplıklarını kullanmamayı tercih ederseniz REST ile ilgili temel bilgileri öğrenmeniz gerekir.
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 POST, GET, PUT veya DELETE gibi bir HTTP fiilini kullanarak bir işlem belirtir. Bir kaynağı aşağıdaki biçimdeki genel olarak benzersiz bir URI ile 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.
Google Reklam Deneyimi Raporu API'sinde REST
Google Reklam Deneyimi Raporu API işlemleri, doğrudan REST HTTP fiilleriyle eşlenir.
Google Reklam Deneyimi Raporu API URI'ları için belirli biçimler şunlardır:
https://adexperiencereport.googleapis.com/v1/resourcePath?parameters
API'de desteklenen her işlem için kullanılan URI'lerin tamamı Google Reklam Deneyimi Raporu API Referansı belgesinde özetlenmiştir.
JSON ile ilgili temel bilgileri öğrenin
Google Reklam Deneyimi Raporu API'si, verileri JSON biçiminde döndürür.
JSON (JavaScript Object Notation), rastgele veri yapılarının basit metin temsilini sağlayan yaygın, dilden bağımsız bir veri biçimidir. Daha fazla bilgi için json.org adresine bakın.