Method: cse.list

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

string

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:

  • 1: Devre dışı

  • 0: Etkin (varsayılan)

cr

string

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:

  • doküman URL'sinin üst düzey alanı (TLD)

  • Web sunucusunun IP adresinin coğrafi konumu

Bu parametrenin geçerli değerlerinin listesi için Ülke Parametresi Değerleri sayfasına bakın.

cx

string

Bu istek için kullanılacak Programlanabilir Arama Motoru Kimliği.

dateRestrict

string

Sonuçları tarihe dayalı URL'lerle kısıtlar. Desteklenen değerler şunlardır:

  • d[number]: Belirtilen sayıda geçmiş gün için sonuçları ister.

  • w[number]: Belirtilen sayıda geçmiş haftadan sonuçları ister.

  • m[number]: Belirtilen sayıda geçen ay için sonuçları ister.

  • y[number]: Belirtilen sayıda geçmiş yıla ait sonuçları ister.

exactTerms

string

Arama sonuçlarındaki tüm dokümanların içermesi gereken bir kelime öbeğini tanımlar.

excludeTerms

string

Arama sonuçlarındaki hiçbir dokümanda görünmemesi gereken bir kelimeyi veya kelime öbeğini tanımlar.

fileType

string

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

string

Yinelenen içerik filtresini etkinleştirmeyi veya devre dışı bırakmayı kontrol eder.

  • Google'ın arama sonucu filtreleri hakkında daha fazla bilgi için Otomatik Filtreleme bölümüne bakın. Ana makine dışlama filtrelemesinin yalnızca çok siteli aramalar için geçerli olduğunu unutmayın.

  • Varsayılan olarak Google, bu sonuçların kalitesini iyileştirmek için tüm arama sonuçlarına filtreleme uygular.

Kabul edilebilir değerler şunlardır:

  • 0: Yinelenen içerik filtresini kapatır.

  • 1: Yinelenen içerik filtresini etkinleştirir.

gl

string

Son kullanıcının coğrafi konumu.

  • gl parametre değeri iki harfli bir ülke kodudur. gl parametresi, menşe ülkesi parametre değeri ile eşleşen arama sonuçlarını iyileştirir. Geçerli değerlerin listesi için Ülke Kodları sayfasına bakın.

  • gl parametre değeri belirtmek daha alakalı sonuçlar sağlayacaktır. Bu durum özellikle uluslararası müşteriler, hatta ABD dışında İngilizce konuşulan ülkelerdeki müşteriler için geçerlidir.

googlehost

string

Kullanımdan kaldırıldı. Benzer bir efekt için gl parametresini kullanın.

Aramayı gerçekleştirmek için kullanılacak yerel Google alan adı (ör. google.com, google.de veya google.fr).

highRange

string

Bir arama aralığının bitiş değerini belirtir.

  • Sorguya lowRange...highRange tutarında kapsayıcı arama aralığı eklemek için lowRange ve highRange değerlerini kullanın.
hl

string

Kullanıcı arayüzü dilini ayarlar.

hq

string

Belirtilen sorgu terimlerini, mantıksal bir AND operatörüyle birleştirilmişmiş gibi sorguya ekler.

imgColorType

enum (ImgColorType)

Siyah beyaz, gri tonlamalı, şeffaf veya renkli görseller döndürür. Kabul edilebilir değerler şunlardır:

  • "color"

  • "gray"

  • "mono": siyah beyaz

  • "trans": şeffaf arka plan

imgDominantColor

enum (ImgDominantColor)

Belirli bir baskın rengin görsellerini döndürür. Kabul edilebilir değerler şunlardır:

  • "black"

  • "blue"

  • "brown"

  • "gray"

  • "green"

  • "orange"

  • "pink"

  • "purple"

  • "red"

  • "teal"

  • "white"

  • "yellow"

imgSize

enum (ImgSize)

Belirtilen boyuttaki görselleri döndürür. Kabul edilebilir değerler şunlardır:

  • "huge"

  • "icon"

  • "large"

  • "medium"

  • "small"

  • "xlarge"

  • "xxlarge"

imgType

enum (ImgType)

Belirli bir türdeki görselleri döndürür. Kabul edilebilir değerler şunlardır:

  • "clipart"

  • "face"

  • "lineart"

  • "stock"

  • "photo"

  • "animated"

lowRange

string

Bir arama aralığının başlangıç değerini belirtir. Sorguya lowRange...highRange tutarında kapsayıcı arama aralığı eklemek için lowRange ve highRange değerlerini kullanın.

lr

string

Aramayı belirli bir dilde yazılmış dokümanlarla kısıtlar (ör. lr=lang_ja).

Kabul edilebilir değerler şunlardır:

  • "lang_ar": Arapça

  • "lang_bg": Bulgarca

  • "lang_ca": Katalanca

  • "lang_cs": Çekçe

  • "lang_da": Danca

  • "lang_de": Almanca

  • "lang_el": Yunanca

  • "lang_en": İngilizce

  • "lang_es": İspanyolca

  • "lang_et": Estonca

  • "lang_fi": Fince

  • "lang_fr": Fransızca

  • "lang_hr": Hırvatça

  • "lang_hu": Macarca

  • "lang_id": Endonezce

  • "lang_is": İzlandaca

  • "lang_it": İtalyanca

  • "lang_iw": İbranice

  • "lang_ja": Japonca

  • "lang_ko": Korece

  • "lang_lt": Litvanca

  • "lang_lv": Letonca

  • "lang_nl": Felemenkçe

  • "lang_no": Norveççe

  • "lang_pl": Lehçe

  • "lang_pt": Portekizce

  • "lang_ro": Rumence

  • "lang_ru": Rusça

  • "lang_sk": Slovakça

  • "lang_sl": Slovence

  • "lang_sr": Sırpça

  • "lang_sv": İsveççe

  • "lang_tr": Türkçe

  • "lang_zh-CN": Çince (Basitleştirilmiş)

  • "lang_zh-TW": Çince (Geleneksel)

num

integer

Döndürülecek arama sonuçlarının sayısı.

  • Geçerli değerler, 1 ile 10 arasındaki (10 dahil) tam sayılardır.
orTerms

string

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

string

Sorgu

relatedSite
(deprecated)

string

Kullanımdan kaldırıldı.

rights

string

Lisanslamaya dayalı filtreler. Desteklenen değerler şunları içerir: cc_publicdomain, cc_attribute, cc_sharealike, cc_noncommercial, cc_nonderived ve bunların kombinasyonları. Tipik kombinasyonlara göz atın.

safe

enum (Safe)

Arama güvenlik seviyesi. Kabul edilebilir değerler şunlardır:

  • "active": Güvenli Arama filtresini etkinleştirir.

  • "off": Güvenli Arama filtrelemesini devre dışı bırakır. (varsayılan)

searchType

enum (SearchType)

Arama türünü belirtir: image. Belirtilmemişse sonuçlar web sayfalarıyla sınırlıdır.

Kabul edilebilir değerler şunlardır:

  • "image": özel resim arama.
siteSearchFilter

enum (SiteSearchFilter)

siteSearch parametresinde adı verilen siteden sonuçların dahil edilip edilmeyeceğini kontrol eder.

Kabul edilebilir değerler şunlardır:

  • "e": hariç tut

  • "i": dahil et

sort

string

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

integer (uint32 format)

Döndürülecek ilk sonucun dizini. Her sayfa için varsayılan sonuç sayısı 10'dur, dolayısıyla &start=11 ikinci sonuç sayfasının en üstünden başlar. Not: Sorguyla 100'den fazla doküman eşleşse bile JSON API hiçbir zaman 100'den fazla sonuç döndürmez. Bu nedenle, start + num toplamının 100'den büyük bir sayıya ayarlanması hataya neden olur. Ayrıca, num için maksimum değerin 10 olduğunu unutmayın.

İ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.