Yapılan arama, arama için kullanılan motorla ilgili meta veriler ve arama sonuçlarıyla ilgili meta verileri döndürür.
HTTP isteği
GET https://customsearch.googleapis.com/customsearch/v1
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Sorgu parametreleri
Parametreler | |
---|---|
c2coff |
Basitleştirilmiş ve Geleneksel Çince Arama'yı etkinleştirir veya devre dışı bırakır. Bu parametrenin varsayılan değeri 0'dır (sıfır). Bu, özelliğin etkinleştirildiği anlamına gelir. Desteklenen değerler:
|
cr |
Arama sonuçlarını, belirli bir ülkeden gelen dokümanlarla kısıtlar. cr parametresi değerinde Boole operatörlerini kullanabilirsiniz. Google Arama, bir dokümanın ülkesini belirlemek için aşağıdakileri analiz eder:
Bu parametrenin geçerli değerlerinin listesi için Ülke Parametresi Değerleri sayfasına bakın. |
cx |
Bu istek için kullanılacak Programlanabilir Arama Motoru Kimliği. |
dateRestrict |
Sonuçları tarihe dayalı URL'lerle kısıtlar. Desteklenen değerler şunlardır:
|
exactTerms |
Arama sonuçlarındaki tüm dokümanların içermesi gereken bir kelime öbeğini tanımlar. |
excludeTerms |
Arama sonuçlarındaki hiçbir dokümanda görünmemesi gereken bir kelimeyi veya kelime öbeğini tanımlar. |
fileType |
Sonuçları, belirli bir uzantıya ait dosyalarla kısıtlar. Google tarafından dizine eklenebilen dosya türlerinin listesini Search Console Yardım Merkezi'nde bulabilirsiniz. |
filter |
Yinelenen içerik filtresini etkinleştirmeyi veya devre dışı bırakmayı kontrol eder.
Kabul edilebilir değerler şunlardır:
|
gl |
Son kullanıcının coğrafi konumu.
|
googlehost |
Kullanımdan kaldırıldı. Benzer bir efekt için Aramayı gerçekleştirmek için kullanılacak yerel Google alan adı (ör. google.com, google.de veya google.fr). |
highRange |
Bir arama aralığının bitiş değerini belirtir.
|
hl |
Kullanıcı arayüzü dilini ayarlar.
|
hq |
Belirtilen sorgu terimlerini, mantıksal bir AND operatörüyle birleştirilmişmiş gibi sorguya ekler. |
imgColorType |
Siyah beyaz, gri tonlamalı, şeffaf veya renkli görseller döndürür. Kabul edilebilir değerler şunlardır:
|
imgDominantColor |
Belirli bir baskın rengin görsellerini döndürür. Kabul edilebilir değerler şunlardır:
|
imgSize |
Belirtilen boyuttaki görselleri döndürür. Kabul edilebilir değerler şunlardır:
|
imgType |
Belirli bir türdeki görselleri döndürür. Kabul edilebilir değerler şunlardır:
|
linkSite |
Tüm arama sonuçlarının belirli bir URL'ye bir bağlantı içermesi gerektiğini belirtir. |
lowRange |
Bir arama aralığının başlangıç değerini belirtir. Sorguya |
lr |
Aramayı belirli bir dilde yazılmış dokümanlarla kısıtlar (ör. Kabul edilebilir değerler şunlardır:
|
num |
Döndürülecek arama sonuçlarının sayısı.
|
orTerms |
Bir dokümanda kontrol edilecek ek arama terimleri sağlar. Burada, arama sonuçlarındaki her doküman ek arama terimlerinden en az birini içermelidir. |
q |
Sorgu |
relatedSite |
Kullanımdan kaldırıldı. |
rights |
Lisanslamaya dayalı filtreler. Desteklenen değerler şunları içerir: |
safe |
Arama güvenlik seviyesi. Kabul edilebilir değerler şunlardır:
|
searchType |
Arama türünü belirtir: Kabul edilebilir değerler şunlardır:
|
siteSearch |
Her zaman sonuçlara dahil edilmesi veya sonuçlardan hariç tutulması gereken belirli bir siteyi belirtir (aşağıdaki |
siteSearchFilter |
Kabul edilebilir değerler şunlardır:
|
sort |
Sonuçlara uygulanacak sıralama ifadesi. Sıralama parametresi, sonuçların belirtilen ifadeye göre sıralanacağını (ör. tarihe göre sıralama) belirtir. Örnek: Sort=date. |
start |
Döndürülecek ilk sonucun dizini. Her sayfa için varsayılan sonuç sayısı 10'dur, dolayısıyla |
İstek içeriği
İstek metni boş olmalıdır.
Yanıt metni
Başarılıysa yanıt metni, Search
öğesinin bir örneğini içerir.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/cse
Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.