İ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ın olması gerekir. Zaten hesabınız varsa hazırsınız demektir.
Test amaçlı ayrı bir Google Hesabı da isteyebilirsiniz.
İstemciniz için proje oluşturma
Google Knowledge Graph Search API'ye istek gönderebilmeniz için öncelikle Google'a müşterinizi bilgilendirmeniz 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şturur ve uygulamanızı kaydedersiniz.
Google Knowledge Graph Search API'yi kullanmaya başlamak için önce kurulum aracını kullanmanız gerekir. Bu araç, Google API Konsolu'nda proje oluşturma, API'yi etkinleştirme ve kimlik bilgileri oluşturma konusunda size rehberlik eder.
Henüz oluşturmadıysanız Kimlik bilgileri oluştur > API anahtarı'nı tıklayarak uygulamanızın API anahtarını oluşturun. Ardından API anahtarları bölümünde API anahtarınızı bulun.
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, HTTP fiilini kullanarak POST, GET, PUT veya DELETE gibi bir işlem belirtir. Bir kaynağı aşağıdaki biçimdeki global 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ı dokümanlarındaki yöntem tanımlarını yararlı bulabilirsiniz. Bu tanımlar, GET, POST, PUT ve DELETE özelliklerini içerir.
Google Bilgi Grafiği Arama API'sinde REST
Google Bilgi Grafiği Arama API'sı işlemleri doğrudan REST HTTP fiilleriyle eşlenir.
Google Bilgi Grafiği Arama API'sı URI'leri için belirli biçimler şunlardır:
https://kgsearch.googleapis.com/v1/entities:search?query=your_query¶meters
API'de desteklenen her işlem için kullanılan URI'ların eksiksiz grubu Google Knowledge Graph Search API referansı dokümanında özetlenir.
JSON ile ilgili temel bilgileri öğrenin
Google Bilgi Grafiği Arama API'sı, verileri JSON biçiminde döndürür.
JSON (JavaScript Object Notation [JavaScript Nesne Gösterimi]), rastgele veri yapılarının basit metin gösterimini sağlayan yaygın bir dilden bağımsız veri biçimidir. Daha fazla bilgi için json.org adresine bakın.