Google Custom Search API – Gökhan Azizoğlu

Gönderiyi paylaş

Merhaba,

Bu yazımda Kelime Ezberle uygulamamda kullanmış olduğum Google Custom Search API ile ilgili bir örnek proje paylaşacağım. Kelime Ezberle uygulamasını incelemek isteyenler buraya tıklayarak uygulamayı inceleyebilirler.

Custom Search API‘nin tanımına çok detaylı girmeyeceğim bu API ile ilgili tanımları birçok yerden okuyarak öğrenebilirsiniz. Kısaca bahsedecek olursam. Google Custom Search, geliştiricilerin Google Arama motoruna dayalı özelleştirilmiş arama motoru oluşturmalarına izin veren Google tarafından sağlanmış bir platformdur.

Ben bu API’yi Kelime Ezberle uygulamamda Google Görsellerde bulunan resimleri elde etmek için kullandım. Kendime Google Arama motoruna dayalı özel bir arama motoru oluşturdum ve daha sonra bu API’yi kullanarak özel sorgular ile dilediğim görseli elde ettim.

Örnek projeleri hazırlarken sade ve kullanımı kolay olmasına dikkat etmeye çalışıyorum. Bu konu için ele alacak olursak amacım Google Görsellerden sorguma karşılık gelen verileri çekmek. Bu yüzden projeyi farklı yerlere çekmeye gerek yok. Verileri çektikten sonra zaten geri kalan kısımları üzerine katarak geliştirebilirsiniz ama önce en temelini halletmek.

Bu proje için bir arama motoruna ihtiyaç var. Bunun için Google’ın bize sunduğu iki sürüm var Custom Search Engine (Ücretsiz) ve Google Site Search (Ücretli). Biz ücretsiz Custom Search Engine kullanacağız. Custom Search Engine’in günlük 100 sorgu limiti bulunuyor. Fiyatlandırmaları buradan öğrenebilirsiniz.

Projeye başlamadan önce yapmanız gerekenler:

Google API Konsol‘dan Custom Search API’yi etkinleştirin ve API Key’i kopyalayın. Bu işlemin nasıl gerçekleştiğini internette bulabilirsiniz.
Custom Search Engine (Özel Arama Motoru) buradan oluşturun ve Görsel Arama seçeneğini aktif edin. Aramanın yapılmasını istediğiniz siteleri “Arama yapılacak siteler” bölümünden ekleyebilirsiniz. Oluşturma tamamlandıktan sonra “Kodu Al” diyerek “var cx=’SEARCH ENGINE ID’ “ tanımlamasında bulunan arama motoru ID’nizi kopyalayın.

Gerekli verileri elde ettikten sonra istekte bulunacağımız URL’den bahsetmek istiyorum. Aşağıda HTTP GET isteğinde bulunacağımız Custom Search API’nin formatı bulunuyor.

https://www.googleapis.com/customsearch/v1?

Bu format üzerine ekleyeceğimiz sorgu parametreleri ile arama sonuçlarını elde edebiliriz. Sorgunun başarıl olması için 3 parametrenin mutlaka kullanılması gerekiyor bunlar:

1.API Key

2.Custom Search Engine ID (Belirtme için cx veya cref kullanılabilir. Kendi arama motorumuzu oluşturduğumuz için cx kullanıyoruz.)

3.Aranacak Kelime (Belirtme için q kullanacağız.)

Bunları elde ettikten sonra oluşan formatımız aşağıdaki gibi olacaktır.

GET https://www.googleapis.com/customsearch/v1?key=INSERT_YOUR_API_KEY&cx=017576662512468239146:omuauf_lfve&q=lectures

Sorgumuzu biraz daha özelleştirecek olursak:

Resim Boyutu: “&imgSize=medium” (small,medium,large,xlarge…) ekleyerek aramalarımızda resimlerin boyutlarının hangisi olması gerektiğini belirtebiliriz.

Arama Tipi: “&searchType=image” Görsellerde arama olmasını istiyorsanız arama tipi image olmalı.

Dosya Türü: “&fileType=jpg” (pdf,png,xls,xml,doc,..) Dosya türünü belirterek aramanızı özelleştirebilirsiniz.

Yukarıda belirttiğim 3 sorgu parametresini projede özelleştirirken kullandım. Bu parametreleri URL’e eklemeniz yeterli. Diğer tüm parametrelere bu adresten ulaşabilirsiniz.