Bu sayfa, yalnızca Google Site Search müşterilerinin kullanabildiği Custom Search JSON API'nin XML sürümüyle ilgilidir.
- Genel Bakış
- Programlanabilir Arama Motoru İstek Biçimi
- XML Sonuçları
Genel bakış
Google WebSearch hizmeti, Google Site Search müşterilerinin Google arama sonuçlarını kendi web sitelerinde görüntüleyebilmesini sağlar. WebSearch hizmeti, arama sonuçlarını sunmak için HTTP tabanlı basit bir protokol kullanır. Arama yöneticileri, arama sonuçlarını isteme ve bu sonuçları son kullanıcıya sunma şekilleri üzerinde tam kontrole sahiptir. Bu dokümanda, Google arama isteğinin ve sonuç biçimlerinin teknik ayrıntıları açıklanmaktadır.
Uygulamanız, Google WebSearch sonuçlarını almak için Google'a basit bir HTTP isteği gönderir. Google, daha sonra arama sonuçlarını XML biçiminde döndürür. XML biçimli sonuçlar, arama sonuçlarının görüntülenme şeklini özelleştirmenize olanak tanır.
WebSearch İstek Biçimi
- Genel Bakış İsteğinde Bulunun
- Sorgu Terimleri
- İstek Parametreleri
- Örnek WebSearch Sorguları
- WebSearch Sorgusu Parametre Tanımları
- Örnek Görsel Sorguları
- Görsel Arama Sorgusu Parametre Tanımları
- Gelişmiş Arama
- Gelişmiş Arama Sorgusu Parametreleri
- Özel Sorgu Terimleri
- İstek Sınırları
İsteğe Genel Bakış
Google arama isteği standart bir HTTP GET
komutudur. Sorgularınızla alakalı parametre koleksiyonunu içerir. Bu parametreler, istek URL'sine "ve" (&) karakterleri ile ayrılmış ad=değer çiftleri olarak eklenir. Parametreler, arama sorgusu ve HTTP isteğini yapan motoru tanımlayan benzersiz bir motor kimliği (cx
) gibi verileri içerir. WebSearch veya Görsel Arama hizmeti, HTTP isteklerinize yanıt olarak XML sonuçları döndürür.
Sorgu Terimleri
Çoğu arama isteği bir veya daha fazla sorgu terimi içerir. Sorgu terimi, arama isteğindeki bir parametrenin değeri olarak görünür.
Sorgu terimleri, Google'ın döndürdüğü arama sonuçlarını filtrelemek ve düzenlemek için çeşitli bilgi türlerini belirtebilir. Sorgular şunları belirtebilir:
- Dahil edilecek veya hariç tutulacak kelimeler ya da kelime öbekleri
- Bir arama sorgusundaki kelimelerin tümü (varsayılan)
- Arama sorgusundaki tam ifade
- Arama sorgusundaki herhangi bir kelime veya kelime öbeği
- Arama terimlerini aramak için dokümanın neresinde?
- Dokümanın herhangi bir yerinde (varsayılan)
- Yalnızca dokümanın gövdesinde
- Yalnızca doküman başlığında
- Yalnızca dokümanın URL'sinde
- Yalnızca dokümandaki bağlantılarda
- Belgelerle ilgili kısıtlamalar
- Belirli dosya türlerindeki dokümanları (ör. PDF dosyaları veya Word dokümanları) dahil etme veya hariç tutma
- Arama yapmak yerine belirli bir URL hakkında bilgi döndüren özel URL sorguları
- Bir URL hakkında, URL'nin Açık Dizin kategorisi, snippet'i veya dili gibi genel bilgileri döndüren sorgular
- Bir URL'ye bağlantı veren web sayfaları grubunu döndüren sorgular
- Belirli bir URL'ye benzer bir web sayfası grubu döndüren sorgular
Varsayılan Arama
Arama sorgusu parametre değerleri URL çıkışlı olmalıdır. Arama sorgusundaki tüm boşluk dizilerinin yerine artı işaretini ("+") koyacağınızı unutmayın. Bu konu, bu dokümanın URL Çıkışı bölümünde daha ayrıntılı olarak ele alınmaktadır.
Arama sorgusu terimi, q parametresi kullanılarak WebSearch hizmetine gönderilir. Örnek bir arama sorgusu terimi:
q=horses+cows+pigs
Varsayılan olarak Google WebSearch hizmeti yalnızca arama sorgusundaki terimlerin tümünü içeren dokümanları döndürür.
İstek Parametreleri
Bu bölümde, arama isteğinde bulunurken kullanabileceğiniz parametreler listelenmiştir. Parametreler iki listeye ayrılır. İlk liste tüm arama istekleriyle alakalı parametreleri içerir. İkinci liste, yalnızca gelişmiş arama istekleriyle alakalı parametreleri içerir.
Üç istek parametresi gereklidir:
- client parametresi
google-csbe
olarak ayarlanmalıdır. - output parametresi, döndürülen XML sonuçlarının biçimini belirtir. Sonuçlar, Google'ın DTD'sine referansla (xml) veya (
xml_no_dtd
) referans olmadan döndürülebilir. Bu değerixml_no_dtd
olarak ayarlamanızı öneririz. Not: Bu parametreyi belirtmezseniz sonuçlar XML yerine HTML olarak döndürülür.
- Motorun benzersiz kimliğini temsil eden cx parametresi.
Yukarıda belirtilenler dışında en yaygın kullanılan istek parametreleri şunlardır:
Örnek WebSearch Sorguları
Aşağıdaki örneklerde, farklı sorgu parametrelerinin nasıl kullanıldığını göstermek için birkaç WebSearch HTTP isteği gösterilmektedir. Farklı sorgu parametrelerinin tanımları bu belgenin WebSearch Sorgusu Parametresi Tanımları ve Gelişmiş Arama Sorgusu Parametreleri bölümlerinde sağlanmıştır.
Bu istekte "red sox" (q=red+sox
) sorgu terimi için ilk 10 sonuç (start=0&num=10
) istenir. Sorgu, sonuçların Kanada web sitelerinden (cr=countryCA
) gelmesi ve Fransızca (lr=lang_fr
) yazılması gerektiğini de belirtir. Son olarak sorgu, üçü de gerekli olan client, output ve cx parametrelerinin değerlerini belirtir.
http://www.google.com/search?
start=0
&num=10
&q=red+sox
&cr=countryCA
&lr=lang_fr
&client=google-csbe
&output=xml_no_dtd
&cx=00255077836266642015:u-scht7a-8i
Bu örnekte, arama sorgusunu daha da özelleştirmek için gelişmiş arama sorgusu parametrelerinden bazıları kullanılmaktadır. Bu istek, q parametresi yerine as_q parametresini (as_q=red+sox
) kullanır. Ayrıca "Yankees" kelimesini içeren dokümanları arama sonuçlarından (as_eq=yankees
) hariç tutmak için as_eq parametresi de kullanılır.
http://www.google.com/search?
start=0
&num=10
&as_q=red+sox
&as_eq=Yankees
&client=google-csbe
&output=xml_no_dtd
&cx=00255077836266642015:u-scht7a-8i
WebSearch Sorgu Parametresi Tanımları
c2coff | |||||||
---|---|---|---|---|---|---|---|
Açıklama | Optional. c2coff parametresi, Basitleştirilmiş ve Geleneksel Çince Arama özelliğini etkinleştirir veya devre dışı bırakır. Bu parametrenin varsayılan değeri
|
||||||
Örnekler | q=google&c2coff=1 |
müşteri | |
---|---|
Açıklama | Zorunludur. |
Örnekler | q=google&client=google-csbe |
cr | |
---|---|
Açıklama | Optional. Google WebSearch, bir belgenin ülkesini belirlemek için aşağıdakileri analiz eder:
Bu parametrenin geçerli değerlerinin listesi için Ülke (cr) Parametre Değerleri bölümüne bakın. |
Örnekler | q=Frodo&cr=countryNZ |
cx | |
---|---|
Açıklama | Zorunludur. |
Örnekler | q=Frodo&cx=00255077836266642015:u-scht7a-8i |
filter | |||||||
---|---|---|---|---|---|---|---|
Açıklama | Optional. filter parametresi, Google arama sonuçlarının otomatik olarak filtrelenmesini etkinleştirir veya devre dışı bırakır. Google'ın arama sonucu filtreleri hakkında daha fazla bilgi için bu dokümanın Otomatik Filtreleme bölümüne bakın.
Not: Google varsayılan olarak, kalitesini iyileştirmek için tüm arama sonuçlarına filtreleme uygular. |
||||||
Örnekler | q=google&filter=0 |
gl | |
---|---|
Açıklama | Optional. WebSearch isteklerinde |
Örnekler | Bu istek, Birleşik Krallık'ta yazılan dokümanları WebSearch sonuçlarında öne çıkarır: |
hl | |
---|---|
Açıklama | Optional. Daha fazla bilgi için Sorguları ve Sonuçlar Sunumunu Uluslararasılaştırma'nın Arayüz Dilleri bölümüne, desteklenen dillerin listesi için de Desteklenen Arayüz Dilleri bölümüne bakın. |
Örnekler | Bu istek, Fransızca şarap reklamlarını hedefler. (Vin, Fransızca şarap terimidir.) q=vin&ip=10.10.10.10&ad=w5&hl=fr |
Hq | |
---|---|
Açıklama | Optional. |
Örnekler | Bu istekte "pizza" VE "peynir" araması yapılır. İfade,
|
ie | |
---|---|
Açıklama | Optional. Bu parametreyi ne zaman kullanmanız gerekebileceği hakkında bilgi edinmek için Karakter Kodlama bölümünü inceleyin. Olası |
Örnekler | q=google&ie=utf8&oe=utf8 |
lr | |
---|---|
Açıklama | Optional. Google WebSearch, dokümanda kullanılan dili belirlemek için aşağıdakileri analiz eder:
Bu parametrenin geçerli değerlerinin bir listesi için Dil ( |
Örnekler | q=Frodo&lr=lang_en |
num | |
---|---|
Açıklama | Optional. Varsayılan Not: Arama sonuçlarının toplam sayısı istenen sonuç sayısından azsa mevcut tüm arama sonuçları döndürülür. |
Örnekler | q=google&num=10 |
oe | |
---|---|
Açıklama | Optional. Bu parametreyi ne zaman kullanmanız gerekebileceği hakkında bilgi edinmek için Karakter Kodlama bölümünü inceleyin. Olası |
Örnekler | q=google&ie=utf8&oe=utf8 |
çıkış | |||||||
---|---|---|---|---|---|---|---|
Açıklama | Zorunludur.
|
||||||
Örnekler | output=xml_no_dtd |
q | |
---|---|
Açıklama | Optional. Ayrıca, Google Arama Kontrol Paneli, Not: q parametresi için belirtilen değer URL çıkışlı olmalıdır. |
Örnekler | q=vacation&as_oq=london+paris |
güvenli | |||||||||
---|---|---|---|---|---|---|---|---|---|
Açıklama | Optional.
Bu özellikle ilgili daha ayrıntılı bilgi için Yetişkinlere Uygun İçeriği Güvenli Arama ile Filtreleme bölümüne bakın. |
||||||||
Örnekler | q=adult&safe=high |
start | |
---|---|
Açıklama | Optional.
|
Örnekler | start=10 |
sıralama | |
---|---|
Açıklama | Optional. |
Örnekler |
|
g | |
---|---|
Açıklama | Optional. http://www.花井鮨.com Bu parametre için geçerli değerler
http://www.xn--elq438j.com. Not: Bu bir beta özelliktir. |
Örnekler | q=google&ud=1 |
Gelişmiş Arama
Görselin altında listelenen ek sorgu parametreleri gelişmiş arama sorgularıyla alakalıdır. Gelişmiş arama gönderdiğinizde, çeşitli parametrelerin değerleri (ör. as_eq, as_epq, as_oq vb.) ilgili aramayla ilgili sorgu terimlerinde dikkate alınır. Resimde, Google'ın Gelişmiş Arama sayfası gösterilmektedir. Resimde, her bir gelişmiş arama parametresinin adı, sayfada bu parametrenin karşılık geldiği alanın içinde veya yanında red metinle yazılır.
![](https://services.google.com/images/as_examples/advanced_search.jpg?authuser=7&hl=tr)
Gelişmiş Arama Sorgusu Parametreleri
as_dt | |
---|---|
Açıklama | Optional. |
Örnekler | as_dt=i,as_dt=e |
as_epq | |
---|---|
Açıklama | Optional. |
Örnekler | as_epq=abraham+lincoln |
as_eq | |
---|---|
Açıklama | Optional. |
Örnekler |
|
as_lq | |
---|---|
Açıklama | Optional. |
Örnekler |
|
as_nlo | |
---|---|
Açıklama | Optional. |
Örnekler | Aşağıdakiler de dahil olmak üzere 5 ile 10 arasında bir arama aralığı ayarlar:
|
as_nhi | |
---|---|
Açıklama | Optional. |
Örnekler | Aşağıdakiler de dahil olmak üzere 5 ile 10 arasında bir arama aralığı ayarlar:
|
as_oq | |
---|---|
Açıklama | Optional. |
Örnekler |
|
as_q | |
---|---|
Açıklama | Optional. |
Örnekler |
|
as_qdr | |
---|---|
Açıklama | Optional.
|
Örnekler |
Bu örnekte geçen yıla ait sonuçlar istenmektedir:
Bu örnekte son 10 güne ait sonuçlar istenir:
|
as_sitesearch | |
---|---|
Açıklama | Optional. |
Örnekler |
|
Özel Sorgu Terimleri
Google WebSearch, Google arama motorunun ek özelliklerine erişen birkaç özel sorgu teriminin kullanılmasına izin verir. Bu özel sorgu terimleri, q istek parametresinin değerine eklenmelidir. Diğer sorgu terimlerinde olduğu gibi özel sorgu terimlerinin de URL çıkışlı olması gerekir. Özel sorgu terimlerinden bazıları iki nokta üst üste (:) içerir. Bu karakterin de URL çıkışlı olması gerekir; URL çıkışlı değeri %3A
'dir.
Geri Bağlantılar [link:] | |
---|---|
Açıklama |
Bir Not: |
Örnekler |
|
Boole VEYA Arama [ VEYA ] | |
---|---|
Açıklama |
Bir terim grubundaki herhangi bir terim için arama göndermek üzere as_oq istek parametresini de kullanabilirsiniz. Not: Bir arama isteği "London+OR+Paris" sorgusunu belirtirse arama sonuçları, bu iki kelimeden en az birini içeren belgeleri içerir. Bazı durumlarda, arama sonuçlarındaki dokümanlar her iki kelimeyi de içerebilir. |
Örnekler | Londra veya Paris'i arayın: Kullanıcı girişi:
london OR
paris Sorgu terimi:q=london+OR+paris Tatil ve Londra ya da Paris için arama yapın: Sorgu terimi:
q=vacation+london+OR+paris Tatil ve Londra, Paris veya çikolata seçenekleri için arama yapın: Sorgu terimi:
q=vacation+london+OR+paris+OR+chocolates Tatil ve çikolatalar ile londra veya paris kelimelerini, en az ağırlığı çikolatalara vererek arayın: Sorgu terimi:
q=vacation+london+OR+paris+chocolates Londra veya Paris'i de içeren dokümanlarda tatil, çikolata ve çiçek araması yapın: Sorgu terimi:
q=vacation+london+OR+paris+chocolates+flowers Tatil ve Londra ya da Paris için arama yapın ve ayrıca çikolata veya çiçeklerden birini arayın: Sorgu terimi: q=vacation+london+OR+paris+chocolates+OR+flowers |
Sorgu Terimini Hariç Tut [-] | |
---|---|
Açıklama | Hariç tut (
"Hariç tut" sorgu terimi, bir arama terimi birden fazla anlama sahip olduğunda yararlıdır. Örneğin, "bas" kelimesi balık veya müzik ile ilgili sonuçlar döndürebilir. Balıklarla ilgili dokümanları arıyor olsaydınız, hariç tut sorgu terimini kullanarak müzikle ilgili dokümanları arama sonuçlarınızdan hariç tutabilirsiniz. Belirli bir kelime veya kelime öbeğiyle eşleşen dokümanları arama sonuçlarından hariç tutmak için as_eq istek parametresini de kullanabilirsiniz. |
Örnekler | Kullanıcı girişi: bass -music Sorgu terimi: q=bass+%2Dmusic |
Dosya Türü Hariç Tutma [ -filetype: ] | |
---|---|
Açıklama |
Not: Sorgunuza daha fazla Google tarafından desteklenen dosya türleri şunlardır:
Gelecekte başka dosya türleri de eklenebilir. Güncel bir listeye her zaman Google'ın dosya türüyle ilgili SSS sayfasından ulaşabilirsiniz. |
Örnekler | Bu örnek, "Google"dan bahseden ancak PDF dokümanı olmayan dokümanları döndürür: Bu örnek, "Google"dan bahseden ancak hem PDF hem de Word dokümanlarını hariç tutan dokümanları döndürür: |
Dosya Türü Filtreleme [ filetype: ] | |
---|---|
Açıklama |
Sorgunuza daha fazla Varsayılan olarak, arama sonuçları herhangi bir dosya uzantısına sahip dokümanları içerir. Google tarafından desteklenen dosya türleri şunlardır:
Gelecekte başka dosya türleri de eklenebilir. Güncel bir listeye her zaman Google'ın dosya türüyle ilgili SSS sayfasından ulaşabilirsiniz. |
Örnekler | Bu örnek, "Google"dan bahseden PDF dokümanlarını döndürür: Bu örnekte, "Google" geçen PDF ve Word dokümanları döndürülür: |
Sorgu Terimini Dahil Et [+] | |
---|---|
Açıklama | İçerme (+) sorgu terimi, bir kelime veya kelime öbeğinin arama sonuçlarında yer alan tüm dokümanlarda bulunması gerektiğini belirtir. Dahil et sorgu terimini kullanmak için tüm arama sonuçlarının önüne "+" (artı işareti) eklenmesi gereken kelime veya kelime öbeğinin önüne eklersiniz.
Google'ın normalde arama sonuçlarını tanımlamadan önce sildiği yaygın bir kelimeden önce |
Örnekler | Kullanıcı girişi: Star Wars Episode +I Sorgu terimi: q=Star+Wars+Episode+%2BI |
Yalnızca Bağlantılar Arama, tüm terimler [ allinlinks: ] | |
---|---|
Açıklama |
Arama sorgunuzda
|
Örnekler | Kullanıcı girişi:allinlinks: Google search Sorgu terimi: q=allinlinks%3A+Google+search |
Kelime Öbeği Arama | |
---|---|
Açıklama | İfade araması (") sorgu terimi, kelime öbeklerini tırnak içine alarak veya aralarına kısa çizgi koyarak tam ifadeleri aramanıza olanak tanır.
Ünlü alıntılar veya özel isimler için arama yapıyorsanız kelime öbeği aramaları özellikle yararlıdır. Sıralı arama göndermek için as_epq istek parametresini de kullanabilirsiniz. |
Örnekler | Kullanıcı girişi:"Abraham Lincoln" Sorgu terimi: q=%22Abraham+Lincoln%22 |
Yalnızca Metin Arama, tüm terimler [allintext:] | |
---|---|
Açıklama |
Arama sorgunuzda
|
Örnekler | Bu örnekte, arama sonuçlarında yer alan tüm dokümanların gövdesinde "Google" ve "arama" kelimelerinin görünmesi gerektiğini belirtilmektedir: Kullanıcı girişi: allintext:Google search Sorgu terimi: q=allintext%3AGoogle+search |
Başlık Arama, tek terim [intitle:] | |
---|---|
Açıklama |
Not: Bu tür her kelimenin önüne
|
Örnekler | Bu örnek, arama sonuçlarındaki tüm dokümanların başlıklarında "Google" kelimesinin görünmesi ve söz konusu dokümanların başlıklarında, URL'lerinde, bağlantılarında veya gövde metninde herhangi bir yerde "arama" kelimesinin görünmesi gerektiğini belirtir: |
Başlık Arama, tüm terimler [allintitle:] | |
---|---|
Açıklama |
Not: Arama sorgusunun başına
|
Örnekler | Bu örnek, arama sonuçlarındaki tüm dokümanların başlıklarında "Google" ve "arama" kelimelerinin görünmesi gerektiğini belirtir: |
URL Arama, tek terim [inurl:] | |
---|---|
Açıklama |
|
Örnekler | Bu örnek, arama sonuçlarındaki tüm dokümanların URL'lerinde "Google" kelimesinin görünmesi ve söz konusu dokümanların başlıklarında, URL'lerinde, bağlantılarında veya gövde metninde herhangi bir yerde "arama" kelimesinin görünmesi gerektiğini belirtir: |
URL Arama, tüm terimler [allinurl:] | |
---|---|
Açıklama |
|
Örnekler | Bu örnekte, arama sonuçlarındaki tüm dokümanların URL'lerinde "Google" ve "arama" kelimelerinin görünmesi gerektiğini belirtilmektedir: |
Web Belgesi Bilgileri [info:] | |
---|---|
Açıklama |
Not: |
Örnekler | Kullanıcı girişi: info:www.google.com Sorgu terimi: q=info%3Awww.google.com |
Örnek Görsel Sorguları
Aşağıdaki örneklerde, farklı sorgu parametrelerinin nasıl kullanıldığını göstermek için birkaç Resim HTTP isteği gösterilmektedir. Farklı sorgu parametrelerinin tanımları bu belgenin Resim Sorgusu Parametresi Tanımları bölümlerinde sağlanmıştır.
Bu istekte .png dosya türündeki "maymun" (q=monkey
) sorgu terimi için ilk 5 sonuç (start=0&num=5
) istenir. Son olarak sorgu, üçü de gerekli olan client
, output
ve cx
parametrelerinin değerlerini belirtir.
http://www.google.com/cse? searchtype=image start=0 &num=5 &q=monkey &as_filetype=png &client=google-csbe &output=xml_no_dtd &cx=00255077836266642015:u-scht7a-8i
Görsel Arama Sorgu Parametreleri
as_filetype | |
---|---|
Açıklama | Optional. Belirtilen türdeki görselleri döndürür. İzin verilen değerler: |
Örnekler | q=google&as_filetype=png |
imgsz | |
---|---|
Açıklama | Optional. Belirtilen boyuttaki görselleri döndürür. Buradaki boyut şunlardan biri olabilir:
|
Örnekler | q=google&as_filetype=png&imgsz=icon |
imgtype | |
---|---|
Açıklama | Optional. Aşağıdakilerden biri olabilecek türdeki görselleri döndürür:
|
Örnekler | q=google&as_filetype=png&imgtype=photo |
Imp | |
---|---|
Açıklama | Optional. Siyah beyaz, gri tonlamalı veya renkli resimleri döndürür:
|
Örnekler | q=google&as_filetype=png&imgc=gray |
imgcolor | |
---|---|
Açıklama | Optional. Belirli bir baskın rengin görsellerini döndürür:
|
Örnekler | q=google&as_filetype=png&imgcolor=yellow |
as_rights | |
---|---|
Açıklama | Optional. Lisanslamaya dayalı filtreler. Desteklenen değerler şunlardır:
|
Örnekler | q=cats&as_filetype=png&as_rights=cc_attribute |
İstek Sınırları
Aşağıdaki grafikte, Google'a gönderdiğiniz arama istekleriyle ilgili sınırlamalar listelenmiştir:
Bileşen | Sınır | Yorum |
---|---|---|
Arama isteği uzunluğu | 2.048 bayt | |
Sorgu terimlerinin sayısı | 10 | şu parametrelerdeki terimleri içerir: q, as_epq, as_eq, as_lq, as_oq, as_q |
Sonuç sayısı | 20 | num parametresini 20'den büyük bir sayıya ayarlarsanız yalnızca 20 sonuç döndürülür. Daha fazla sonuç elde etmek için birden fazla istek göndermeniz ve her istekle birlikte start parametresinin değerini artırmanız gerekir. |
Sorguları ve Sonuçları Uluslararasılaştırma Sunumu
Google WebSearch hizmeti, birden fazla dilde doküman aramanıza olanak tanır. HTTP isteğinizi yorumlamak ve XML yanıtınızı kodlamak için kullanılması gereken karakter kodlamasını belirtebilirsiniz (ie ve oe arama parametrelerini kullanarak). Ayrıca, sonuçları yalnızca belirli dillerde yazılmış dokümanları içerecek şekilde filtreleyebilirsiniz.
Aşağıdaki bölümlerde, birden fazla dilde arama yapmayla ilgili sorunlar ele alınmaktadır:
Karakter Kodlama
Sunucular, web sayfaları gibi verileri, tarayıcılar gibi kullanıcı aracılarına kodlanmış bayt dizisi olarak gönderir. Kullanıcı aracısı daha sonra baytların kodunu bir karakter dizisine dönüştürür. WebSearch hizmetine istek gönderirken hem arama sorgunuz hem de aldığınız XML yanıtı için kodlama şemalarını belirtebilirsiniz.
HTTP isteğinizdeki karakterlerin kodlama mekanizmasını belirtmek için ie istek parametresini kullanabilirsiniz. Google'ın XML yanıtınızı kodlamak için kullanması gereken kodlama şemasını belirtmek amacıyla oe parametresini de kullanabilirsiniz. ISO-8859-1
(veya latin1
) dışında bir kodlama şeması kullanıyorsanız lütfen ie ve oe parametreleri için doğru değerleri belirttiğinizden emin olun.
Not: Birden fazla dilde arama işlevi sağlıyorsanız hem ie hem de oe parametreleri için utf8
(UTF-8) kodlama değerini kullanmanızı öneririz.
ie ve oe parametreleri için kullanabileceğiniz değerlerin tam listesi için lütfen Karakter Kodlama Şemaları ekine bakın.
Karakter kodlaması hakkında daha fazla genel bilgi için lütfen http://www.w3.org/TR/REC-html40/charset.html adresine bakın.
Arayüz Dilleri
Grafik arayüzünüzün dilini tanımlamak için hl istek parametresini kullanabilirsiniz. hl parametresi değeri, dil kısıtlaması (lr parametresi kullanılarak) açıkça belirtilmediğinde özellikle uluslararası sorgularda XML arama sonuçlarını etkileyebilir. Bu gibi durumlarda hl parametresi, kullanıcının giriş diliyle aynı dildeki arama sonuçlarını tanıtabilir.
Google'ın her sorgu için en yüksek kaliteli arama sonuçlarını seçmesini sağlamak amacıyla arama sonuçlarında hl parametresini açıkça ayarlamanızı öneririz.
hl parametresinin geçerli değerlerinin tam listesi için lütfen Desteklenen Arayüz Dilleri bölümüne bakın.
Belirli Dillerde Yazılmış Dokümanları Arama
Arama sonuçlarını belirli bir dilde veya dil kümesinde yazılmış dokümanlarla kısıtlamak için lr istek parametresini kullanabilirsiniz.
lr parametresi, arama sonuçlarına dahil edilmesi (veya hariç tutulması) gereken birden fazla dili belirtmenize olanak tanımak için Boole Operatörleri'ni destekler.
Aşağıdaki örneklerde, farklı dillerde doküman istemek için Boole Operatörlerini nasıl kullanabileceğiniz gösterilmektedir.
Japonca yazılmış dokümanlar için:
lr=lang_jp
İtalyanca veya Almanca yazılmış dokümanlar için:
lr=lang_it|lang_de
Macarca veya Çekçe yazılmamış dokümanlar için:
lr=(-lang_hu).(-lang_cs)
lr parametresinin olası değerlerinin tam listesi için lütfen Dil Toplama Değerleri bölümüne ve bu operatörlerin kullanımıyla ilgili kapsamlı bir açıklama için Boole Operatörleri bölümüne bakın.
Basitleştirilmiş ve Geleneksel Çince Arama
Basitleştirilmiş Çince ve Geleneksel Çince, Çince'nin iki yazı varyantıdır. Aynı kavram her varyantta farklı şekilde yazılabilir. Varyantlardan birinde sorgu verildiğinde Google WebSearch hizmeti, her iki varyanttaki sayfaları da içeren sonuçlar döndürebilir.
Bu özelliği kullanmak için:
- c2coff istek parametresini 0 olarak ayarlayın
ve - Aşağıdakilerden birini yapın:
Aşağıdaki örnekte, hem basitleştirilmiş hem de geleneksel Çincedeki bir sonuç isteğine dahil edeceğiniz sorgu parametreleri gösterilmektedir. (İstemci gibi gerekli ek bilgilerin örnekte yer almadığını unutmayın.)
search?hl=zh-CN &lr=lang_zh-TW|lang_zh-CN &c2coff=0
Sonuçları Filtreleme
Google WebSearch, arama sonuçlarınızı filtrelemek için çeşitli yöntemler sunar:
- Arama sonuçlarını otomatik olarak filtreleme
- Dil ve Ülke Filtreleme
- Yetişkinlere Uygun İçerikleri Güvenli Arama ile Filtreleme
Arama Sonuçlarını Otomatik Filtreleme
Google, mümkün olan en iyi arama sonuçlarını sağlamak amacıyla, genellikle istenmediği kabul edilen arama sonuçlarını otomatik olarak filtrelemek için iki teknik kullanır:
-
Yinelenen İçerik: Birden fazla belgede aynı bilgiler varsa yalnızca en alakalı doküman arama sonuçlarınıza dahil edilir.
-
Ana Bilgisayar İzleyicisi—Aynı siteden çok sayıda arama sonucu varsa Google, o sitedeki tüm sonuçları göstermeyebilir veya
sıralamada sonuçları normalde olduğundan daha düşük bir sıralamada gösterebilir.
Filtreler çoğu arama sonucunun kalitesini önemli ölçüde artırdığından, bu filtreleri tipik arama istekleri için açık bırakmanızı öneririz. Ancak arama isteğinizde filtre sorgu parametresini 0 olarak ayarlayarak bu otomatik filtreleri atlayabilirsiniz.
Dil ve Ülke Filtreleme
Google WebSearch hizmeti, tüm web dokümanlarının ana dizininden sonuçlar döndürür. Ana dizin, dil ve menşe ülke gibi belirli özelliklere göre gruplandırılmış dokümanlardan oluşan alt koleksiyonlar içerir.
Arama sonuçlarını sırasıyla belirli dillerde yazılmış veya belirli ülkelerden gelen doküman alt koleksiyonlarıyla kısıtlamak için lr ve cr istek parametrelerini kullanabilirsiniz.
Google WebSearch, dokümanda kullanılan dili belirlemek için aşağıdakileri analiz eder:
- doküman URL'sinin üst düzey alanı (TLD)
- dokümanın dil meta etiketleri
- dokümanın gövde metninde kullanılan birincil dil
Sonuçları dile göre kısıtlama hakkında daha fazla bilgi edinmek için lütfen lr parametresinin tanımına, Belirli Dillerde Yazılmış Dokümanları Arama başlıklı bölüme ve lr parametresinin değerleri olarak kullanılabilen Dil Koleksiyonu Değerleri bölümüne de bakın.
Google WebSearch, 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
Sonuçları menşe ülkeye göre kısıtlama hakkında daha fazla bilgi için lütfen cr parametresinin tanımına ve cr parametresinin değeri olarak kullanılabilen Ülke Koleksiyon Değerleri bölümüne de bakın.
Not: Arama sonuçlarınızı özelleştirmek için dil ve ülke değerlerini birleştirebilirsiniz. Örneğin, Fransızca olarak yazılmış ve Fransa ya da Kanada'dan gelen belgeler ya da Hollanda'dan gelen ve İngilizce dilinde yazılmamış belgeler talep edebilirsiniz. lr ve cr parametrelerinin ikisi de Boole Operatörlerini destekler.
Yetişkinlere Uygun İçeriği Güvenli Arama ile Filtreleme
Birçok Google müşterisi, yetişkinlere uygun içerik barındıran siteler için arama sonuçları görüntülemek istememektedir. Güvenli Arama filtremizi kullanarak, yetişkinlere uygun içerik barındıran arama sonuçlarını filtreleyebilir ve hariç tutabilirsiniz. Google'ın filtreleri; anahtar kelimeleri, kelime öbeklerini ve URL'leri kontrol etmek için Google'a ait bir teknoloji kullanır. Hiçbir filtre %100 doğru olmasa da Güvenli Arama, yetişkinlere uygun içeriğin büyük çoğunluğunu arama sonuçlarınızdan kaldırır.
Google, Güvenli Arama'nın mümkün olduğunca güncel ve kapsamlı olmasını sağlamak için web'i sürekli olarak tarar ve kullanıcı önerilerinden güncellemeler ekler.
Güvenli Arama aşağıdaki dillerde kullanılabilir:
Felemenkçe İngilizce Fransızca Almanca |
İtalyanca Portekizce (Brezilya) İspanyolca Geleneksel Çince |
safe sorgu parametresini kullanarak Google'ın sonuçlarınızı yetişkinlere uygun içeriğe göre filtreleme düzeyini ayarlayabilirsiniz. Aşağıdaki tabloda, Google'ın Güvenli Arama ayarları ve bu ayarların arama sonuçlarınızı nasıl etkileyeceği açıklanmaktadır:
Güvenli Arama Düzeyi | Açıklama |
---|---|
yüksek | Güvenli aramanın daha katı bir sürümünü etkinleştirir. |
medium | Pornografi ve diğer uygunsuz cinsel içeriklerin bulunduğu web sayfalarını engeller. |
kapalı | Yetişkinlere uygun içerikleri arama sonuçlarından filtrelemez. |
* Varsayılan Güvenli Arama ayarı kapalı konumdadır.
Güvenli Arama'yı etkinleştirdiyseniz ve sonuçlarınızda rahatsız edici içeriğe sahip siteler bulursanız, lütfen siteyi incelememiz için sitenin URL'sini safesearch@google.com adresine e-posta ile gönderin.
XML Sonuçları
- Google XML Sonuçları DTD
- XML Yanıtı hakkında
- Normal ve Gelişmiş Arama Sorguları için XML Sonuçları
- Normal/Gelişmiş Arama: Örnek Sorgu ve XML Sonucu
- Normal/Gelişmiş Arama: XML Etiketleri
Google XML Sonuçları DTD
Google, tüm arama sonucu türlerinde XML biçimini tanımlamak için aynı DTD'yi kullanır. Etiketlerin ve özelliklerin çoğu tüm arama türleri için geçerlidir. Ancak bazı etiketler yalnızca belirli arama türleri için geçerlidir. Sonuç olarak, DTD'deki tanımlar bu belgede belirtilen tanımlardan daha az kısıtlayıcı olabilir.
Bu dokümanda, DTD'nin WebSearch ile ilgili olan yönleri açıklanmaktadır. DTD'ye baktığınızda WebSearch üzerinde çalışıyorsanız burada belgelenmeyen etiketleri ve özellikleri güvenli bir şekilde yoksayabilirsiniz. DTD ve dokümanlarda farklı tanımlar varsa bu belgede bu durum belirtilmiştir.
Google, en son DTD'ye referans vererek veya belirtmeden XML sonuçlarını döndürebilir. DTD, arama yöneticilerinin ve XML ayrıştırıcıların Google'ın XML sonuçlarını anlamasına yardımcı olan bir rehberdir. Google'ın XML dil bilgisi zaman zaman değişebileceğinden, ayrıştırıcınızı her XML sonucunu doğrulamak için DTD'yi kullanacak şekilde yapılandırmamalısınız.
Ayrıca, XML ayrıştırıcınızı her arama isteği gönderdiğinizde DTD'yi getirecek şekilde yapılandırmamanız gerekir. Google, DTD'yi nadiren günceller ve bu istekler gereksiz gecikme ve bant genişliği gereksinimleri oluşturur.
Google, XML sonuçlarını almak için xml_no_dtd çıkış biçimini kullanmanızı önerir. Arama isteğinizde xml çıkış biçimini belirtirseniz tek fark aşağıdaki satırın XML sonuçlarına eklenmesi olur:
<!DOCTYPE GSP SYSTEM "google.dtd">
En son DTD'ye http://www.google.com/google.dtd adresinden erişebilirsiniz.
DTD'deki bazı özelliklerin şu an için kullanılamadığını veya desteklenmediğini lütfen unutmayın.
XML Yanıtı Hakkında
- Tüm öğe değerleri, XML etiket tanımlarında aksi belirtilmedikçe görüntülenmeye uygun geçerli HTML'dir.
- Bazı öğe değerleri, gösterilmeden önce HTML olarak kodlanması gereken URL'lerdir.
- XML ayrıştırıcınız, belgelenmemiş öznitelik ve etiketleri yoksaymalıdır. Google, XML çıktısına daha fazla özellik eklerse bu, uygulamanızın değişiklik yapmadan çalışmaya devam etmesine olanak tanır.
- Belirli karakterlere, XML etiketlerine değer olarak eklendiğinde çıkış karakteri eklenmelidir. XML işlemciniz, bu varlıkları tekrar uygun karakterlere dönüştürmelidir. Varlıkları düzgün bir şekilde dönüştürmezseniz tarayıcı örneğin & karakterini "&" olarak oluşturabilir.
XML Standardı bu karakterleri belgeler. Bu karakterler aşağıdaki tabloda yeniden oluşturulmuştur:
Karakter Çıkış karakterli Formlar Varlık Karakter Kodu Ve işareti - & & Tek Tırnak İşareti ' ' ' Çift Tırnak İşareti " " " Büyüktür İşareti > > > Küçüktür İşareti < < <
Normal ve Gelişmiş Arama Sorguları İçin XML Sonuçları
Normal/Gelişmiş Arama: Örnek Sorgu ve XML Sonucu
Bu örnek WebSearch isteği, "socer" (q=socer
) arama terimi hakkında 10 sonuç (num=10
) ister. Bu, bu örnekte "soccer" kelimesi kasten yanlış yazılmıştır.)
http://www.google.com/search?
q=socer
&hl=en
&start=10
&num=10
&output=xml
&client=google-csbe
&cx=00255077836266642015:u-scht7a-8i
Bu istek, aşağıdaki XML sonucunu verir. XML sonucunda, sonuca dahil edilmeyen belirli etiketlerin nerede görüneceğini belirten birkaç yorum bulunduğunu unutmayın.
<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?>
<GSP VER="3.2">
<TM>0.452923</TM>
<Q>socer</Q>
<PARAM name="cx" value="00255077836266642015:u-scht7a-8i" original_value="00255077836266642015%3Au-scht7a-8i"/>
<PARAM name="hl" value="en" original_value="en"/>
<PARAM name="q" value="socer" original_value="socer"/>
<PARAM name="output" value="xml" original_value="xml"/>
<PARAM name="client" value="google-csbe" original_value="google-csbe"/>
<PARAM name="num" value="10" original_value="10"/>
<Spelling>
<Suggestion q="soccer"><b><i>soccer</i></b></Suggestion>
</Spelling>
<Context>
<title>Sample Vacation CSE</title>
<Facet>
<FacetItem>
<label>restaurants</label>
<anchor_text>restaurants</anchor_text>
</FacetItem>
<FacetItem>
<label>wineries</label>
<anchor_text>wineries</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>golf_courses</label>
<anchor_text>golf courses</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>hotels</label>
<anchor_text>hotels</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>nightlife</label>
<anchor_text>nightlife</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>soccer_sites</label>
<anchor_text>soccer sites</anchor_text>
</FacetItem>
</Facet>
</Context>
<RES SN="1" EN="10">
<M>6080</M>
/*
* The FI tag after the comment indicates that the result
* set has been filtered. If the number of results were exact, the
* FI tag would be replaced by an XT tag in the same format.
*/
<FI />
<NB>
/*
* Since the request is for the first page of results, the PU tag,
* which contains a link to the previous page of search results,
* is not included in this XML result. If the sample result did include
* a previous page of results, it would be listed here, in the same format
* as the NU tag on the following line
*/
<NU>/search?q=socer&hl=en&lr=&ie=UTF-8&output=xml&client=test&start=10&sa=N</NU>
</NB>
<R N="1">
<U>http://www.soccerconnection.net/</U>
<UE>http://www.soccerconnection.net/</UE>
<T>SoccerConnection.net</T>
<CRAWLDATE>May 21, 2007</CRAWLDATE>
<S><b>soccer</b>; players; coaches; ball; world cup;<b>...</b></S>
<Label>transcodable_pages</Label>
<Label>accessible</Label>
<Label>soccer_sites</Label>
<LANG>en</LANG>
<HAS>
<DI>
<DT>SoccerConnection.net</DT>
<DS>Post your <b>soccer</b> resume directly on the Internet.</DS>
</DI>
<L/>
<C SZ="8k" CID="kWAPoYw1xIUJ"/>
<RT/>
</HAS>
</R>
/*
* The result includes nine more results, each enclosed by an R tag.
*/
</RES>
</GSP>
Normal/Gelişmiş Arama: XML Etiketleri
Normal arama istekleri ve gelişmiş arama istekleri için XML yanıtları, aynı XML etiket grubunu kullanır. Bu XML etiketleri, yukarıdaki XML örneğinde gösterilmiş ve aşağıdaki tablolarda açıklanmıştır.
Aşağıdaki XML etiketleri, etiket adına göre alfabetik olarak listelenir ve her etiket tanımı, etiketin bir açıklamasını, etiketin bir XML sonucunda nasıl görüneceğini ve etiket içeriğinin biçimini gösteren bir örnek içerir. Etiket başka bir XML etiketinin alt etiketiyse veya etiketin kendi alt etiketleri ya da özellikleri varsa bu bilgiler, etiketin tanım tablosunda da sağlanır.
Aşağıdaki tanımlarda bazı alt etiketlerin yanında belirli semboller gösterilebilir. Bu semboller ve anlamları aşağıdaki gibidir:
* = alt etiketin sıfır veya daha fazla örneği
+ = alt etiketin bir veya daha fazla örneği
A | B | C | G | O | T | E | S | S | A | H | Ü | S | R | K | T | U | X |
anchor_text | |
---|---|
Tanım | <anchor_text> etiketi, arama sonucu grubuyla ilişkili bir hassasiyet etiketini tanımlamak için kullanıcılara göstermeniz gereken metni belirtir. Ayrıntılandırma etiketleri alfanümerik olmayan karakterleri alt çizgilerle değiştirdiğinden, kullanıcı arayüzünüzde <label> etiketinin değerini görüntülememeniz gerekir. Bunun yerine, <anchor_text> etiketinin değerini görüntülemeniz gerekir. |
Örnek | <anchor_text>golf kursları</anchor_text> |
Alt etiketi | FacetItem |
İçerik Biçimi | Metin |
ENGELLE | |
---|---|
Tanım | Bu etiket, bir tanıtım sonucunun gövde satırındaki bir blokun içeriğini içerir. Her blokun T, U ve L alt etiketleri vardır. Boş olmayan T etiketi, bloğun metin içerdiğini, boş olmayan U ve L etiketleri ise bloğun bir bağlantı içerdiğini belirtir (URL U alt etiketinde ve bağlantı metni L alt etiketinde verilir). |
Alt etiketler | T, U, L |
Alt etiketi | BODY_LINE |
İçerik Biçimi | Boş |
BODY_LINE | |
---|---|
Tanım | Bu etiket, tanıtılan sonucun gövdesinde bir satırın içeriğini içerir. Her gövde satırı, bir metin veya URL ve bağlantı metni içeren bir bağlantı içeren birkaç ENGELLE etiketinden oluşur. |
Alt etiketler | ENGELLE* |
Alt etiketi | SL_MAIN |
İçerik Biçimi | Boş |
C | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Tanım | <C> etiketi, WebSearch hizmetinin bu arama sonucu URL'sinin önbelleğe alınmış bir sürümünü alabileceğini belirtir. Önbelleğe alınan sayfaları XML API aracılığıyla alamazsınız, ancak bu içerik için kullanıcıları www.google.com adresine yönlendirebilirsiniz. |
|||||||||
Özellikler |
|
|||||||||
Örnek | <C SZ="6k" CID="kvOXK_cYSSgJ" /> | |||||||||
Alt etiketi | HAS | |||||||||
İçerik Biçimi | Boş |
C2C | |
---|---|
Tanım | <C2C> etiketi, sonucun Geleneksel Çince bir sayfaya ait olduğunu belirtir. Bu etiket yalnızca Basitleştirilmiş ve Geleneksel Çince Arama etkinleştirildiğinde görünür. Bu özelliği etkinleştirme ve devre dışı bırakma hakkında daha fazla bilgi için c2coff sorgu parametresinin tanımına bakın. |
İçerik Biçimi | Metin |
İçerik | |
---|---|
Tanım | <Context> etiketi, bir arama sonucu grubuyla ilişkilendirilmiş ayrıntılandırma etiketlerinin listesini içerir. |
Örnek | <Context> |
Alt etiketler | title, Façeta+ |
İçerik Biçimi | Kapsayıcı |
TARAMA TARİHİ | |
---|---|
Tanım | <CRAWLDATE> etiketi, sayfanın en son tarandığı tarihi tanımlar. |
Örnek | <CRAWLDATE>21 Mayıs 2005</CRAWLDATE> |
Alt etiketi | R |
İçerik Biçimi | Metin |
Kendi | |
---|---|
Tanım | <DI> etiketi, tek bir arama sonucuyla ilgili Açık Dizin Projesi (ODP) kategori bilgilerini içerir. |
Örnek | <DI> |
Alt etiketler | DT?, DS'yi nasıl seçebilirsiniz? |
Alt etiketi | HAS |
İçerik Biçimi | Boş |
DS | |
---|---|
Tanım | <DS> etiketi, ODP dizininde tek bir kategori için listelenen özeti sağlar. |
Örnek | <DS><b>futbol</b> özgeçmişinizi doğrudan İnternet'te yayınlayın.</DS> |
Alt etiketi | Kendin Yap |
İçerik Biçimi | Metin (HTML içerebilir) |
DT | |
---|---|
Tanım | <DT> etiketi, ODP dizininde listelenen tek bir kategorinin başlığını sağlar. |
Örnek | <DT>SoccerConnection.net</DT> |
Alt etiketi | Kendin Yap |
İçerik Biçimi | Metin (HTML içerebilir) |
Özellik | |
---|---|
Tanım | <Facet> etiketi, <FacetItem> etiketlerinin mantıksal bir gruplandırmasını içerir. Bu gruplamaları Programlanabilir Arama Motoru XML Spesifikasyonu biçimini kullanarak oluşturabilirsiniz. Bu gruplamaları oluşturmazsanız results_xml_tag_Context><Bağlam> etiketi en fazla dört <Facet> etiketi içerir. Her bir <Facet> etiketi içindeki öğeler görüntüleme amacıyla gruplandırılır ancak mantıksal bir ilişkisi olmayabilir. |
Örnek | <Facet> |
Alt etiketler | FacetItem+, başlık+ |
Alt etiketi | Bağlam |
İçerik Biçimi | Kapsayıcı |
FacetItem | |
---|---|
Tanım | <FacetItem> etiketi, bir arama sonucu grubuyla ilişkilendirilmiş bir ayrıntılandırma etiketiyle ilgili bilgileri içerir. |
Örnek | <FacetItem> |
Alt etiketler | label, anchor_text+ |
Alt etiketi | Façeta |
İçerik Biçimi | FacetItem |
FI | |
---|---|
Tanım | <FI> etiketi, arama için doküman filtrelemenin yapılıp yapılmadığını gösteren bir işaret işlevi görür. Google'ın arama sonucu filtreleri hakkında daha fazla bilgi için bu dokümanın Otomatik Filtreleme bölümüne bakın. |
Örnek | <FI /> |
Alt etiketi | RES |
İçerik Biçimi | Boş |
GST | |||||||
---|---|---|---|---|---|---|---|
Tanım | <GSP> etiketi, Google XML arama sonuçlarında döndürülen tüm verileri içerir. "GSP", "Google Search Protocol"ün kısaltmasıdır. |
||||||
Özellikler |
|
||||||
Örnek | <GSP VER="3,2"> | ||||||
Alt etiketler | PARAM+, Q, RES?, ÇB | ||||||
İçerik Biçimi | Boş |
HAS | |
---|---|
Tanım | <HAS> etiketi, belirli bir URL için desteklenen tüm özel arama isteği parametreleri ile ilgili bilgileri içerir.
Not: WebSearch için <HAS> tanımı, DTD'dekinden daha kısıtlayıcıdır. |
Alt etiketler | DI?, L?, C?, RT? |
Alt etiketi | R |
ISURL | |
---|---|
Tanım | İlişkili arama sorgusu bir URL ise Google, <ISURL> etiketini döndürür. |
Alt etiketi | GSP |
İçerik Biçimi | Boş |
L | |
---|---|
Tanım | <L> etiketinin varlığı, WebSearch hizmetinin bu arama sonucu URL'sine bağlantı veren diğer siteleri bulabileceğini belirtir. Bu tür siteleri bulmak için link: özel sorgu terimini kullanabilirsiniz. |
Alt etiketi | HAS |
İçerik Biçimi | Boş |
etiket | |
---|---|
Tanım | <label> etiketi, aldığınız arama sonuçlarını filtrelemek için kullanabileceğiniz bir ayrıntılandırma etiketi belirtir. Ayrıntılandırma etiketi kullanmak için Google'a gönderdiğiniz HTTP isteğindeki q parametresinin değerine more:[[label tag value]] dizesini aşağıdaki örnekte gösterildiği gibi ekleyin. Sorguyu Google'a göndermeden önce bu değerin URL çıkışlı olması gerektiğini lütfen unutmayın. This example uses the refinement label golf_courses to Not: <label> etiketi, arama sonuçlarınızdaki belirli bir URL ile ilişkilendirilmiş bir ayrıntılandırma etiketini tanımlayan <Label> etiketi ile aynı değildir. |
Örnek | <label>golf_kursları</label> |
Alt etiketi | FacetItem |
İçerik Biçimi | Metin |
DİLÇ | |
---|---|
Tanım | <LANG> etiketi, Google'ın arama sonucunun diline ilişkin en iyi tahminini içerir. |
Örnek | <LANG>en</LANG> |
Alt etiketi | R |
İçerik Biçimi | Metin |
M | |
---|---|
Tanım | <M> etiketi, arama için sonuçların tahmini toplam sayısını tanımlar. Not: Bu tahmin doğru olmayabilir. |
Örnek | <M>16200000</M> |
Alt etiketi | RES |
İçerik Biçimi | Metin |
YD | |
---|---|
Tanım | <NB> etiketi, sonuç kümesine ait gezinme bilgilerini (arama sonuçlarının bir sonraki sayfasına veya arama sonuçlarının bir önceki sayfasına yönlendiren bağlantılar) içerir. Not: Bu etiket yalnızca daha fazla sonuç varsa gösterilir. |
Örnek | <NB> |
Alt etiketler | NU?, PU kullanımı |
Alt etiketi | RES |
İçerik Biçimi | Boş |
NU | |
---|---|
Tanım | <NU> etiketi, arama sonuçlarının sonraki sayfasına giden göreli bir bağlantı içerir. |
Örnek | <NU>/search?q=flowers&num=10&hl=tr&ie=UTF-8 &output=xml&client=test&start=10</NU> |
Alt etiketi | YOK |
İçerik Biçimi | Metin (Göreli URL) |
PARAM | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Tanım | <PARAM> etiketi, XML sonucuyla ilişkili HTTP isteğinde gönderilen bir giriş parametresini tanımlar. Parametreyle ilgili bilgiler, ad, değer, orijinal_değer gibi etiket özelliklerinde yer alır ve HTTP isteğinde gönderilen her parametre için bir PARAM etiketi olur. |
||||||||||||
Özellikler |
|
||||||||||||
Örnek | <PARAM name="cr" value="countryNZ" Original_value="countryNZ" /> | ||||||||||||
Alt etiketi | GSP | ||||||||||||
İçerik Biçimi | Karışık |
PU | |
---|---|
Tanım | <PU> etiketi, arama sonuçlarının önceki sayfasına giden göreli bir bağlantı sağlar. |
Örnek | <PU>/search?q=flowers&num=10&hl=tr&output=xml &client=test&start=10</PU> |
Alt etiketi | YOK |
İçerik Biçimi | Metin (Göreli URL) |
SORU | |
---|---|
Tanım | <Q> etiketi, XML sonucuyla ilişkili HTTP isteğinde gönderilen arama sorgusunu tanımlar. |
Örnek | <Q>pizza</Q> |
Alt etiketi | GSP |
İçerik Biçimi | Metin |
R | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Tanım | <R> etiketi, tek bir arama sonucunun ayrıntılarını içerir. Not: WebSearch için <R> etiketinin tanımı DTD'dekinden daha kısıtlayıcıdır. |
|||||||||
Özellikler |
|
|||||||||
Alt etiketler | U, UE, T?, CRAWLDATE, S?, Türkçe?, HAS | |||||||||
Alt etiketi | RES |
RES | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Tanım | <RES> etiketi, bağımsız arama sonuçları grubunu ve bu sonuçlarla ilgili ayrıntıları içerir. |
|||||||||
Özellikler |
|
|||||||||
Örnek | <RES SN="1" EN="10"> | |||||||||
Alt etiketler | M, FI?, XT?, NB?, R* | |||||||||
Alt etiketi | GSP | |||||||||
İçerik Biçimi | Boş |
S | |
---|---|
Tanım | <S> etiketi, sorgu terimlerini kalın karakterlerle vurgulanmış olarak gösteren bir arama sonucu alıntısını içerir. Metnin doğru şekilde kaydırılması için alıntıya satır sonları dahil edilir. |
Örnek | <S>Washington (CNN) -- Senato'nun Başkan'a karşı <b>Bush's</b> adli seçimlerini sonlandırma teklifi |
Alt etiketi | R |
İçerik Biçimi | Metin (HTML) |
SL_MAIN | |
---|---|
Tanım | Bu etiket, bir tanıtım sonucunun içeriğini kapsar. Promosyonları ayrıştırmak için kullanın. Başlık bağlantısının bağlantı metni ve URL'si sırasıyla T ve U alt etiketlerinde bulunur. Gövde metninin satırları ve bağlantılar BODY_LINE alt etiketlerinde bulunur. |
Alt etiketler | BODY_LINE*, T, U |
Alt etiketi | SL_RESULTS |
İçerik Biçimi | Boş |
SL_RESULTS | |
---|---|
Tanım | Tanıtılan sonuçlar için kapsayıcı etiket. Arama sonuçlarınızda bir tanıtım olduğunda bunlardan biri görünür. SL_MAIN alt etiketi, ana sonuç verilerini içerir. |
Alt etiketler | SL_MAIN* |
Alt etiketi | R |
İçerik Biçimi | Boş |
Yazım | |
---|---|
Tanım | <Spelling> etiketi, gönderilen sorgu için alternatif bir yazım önerisi içerir. Bu etiket yalnızca arama sonuçlarının ilk sayfasında görünür. Yazım önerileri İngilizce, Çince, Japonca ve Korece dillerinde kullanılabilir. Not: Google, yalnızca gl parametre değerinin küçük harfle olduğu sorgular için yazım önerileri döndürür. |
Örnek | <Spelling> |
Alt etiketler | Öneri |
Alt etiketi | GSP |
İçerik Biçimi | Boş |
Öneri | |||||||
---|---|---|---|---|---|---|---|
Tanım | <Suggestion> etiketi, gönderilen sorgu için alternatif bir yazım önerisi içerir. Arama yapan kullanıcıya alternatif yazımı önermek için etiketin içeriğini kullanabilirsiniz. q özelliğinin değeri, sorgu terimi olarak kullanabileceğiniz URL çıkış karakterli yazım önerisidir. | ||||||
Özellikler |
|
||||||
Örnek | <Suggestion q="soccer"><b><i>futbol</i></b></Suggestion> | ||||||
Alt etiketi | Yazım | ||||||
İçerik Biçimi | Metin (HTML) |
T | |
---|---|
Tanım | <T> etiketi, sonucun başlığını içerir. |
Örnek | <T>Amici'nin Doğu Kıyısı Pizzacısı</T> |
Alt etiketi | R |
İçerik Biçimi | Metin (HTML) |
başlık | |
---|---|
Tanım | <Context> alt öğesi olan <title> etiketi, Programlanabilir Arama Motorunuzun adını içerir. <Facet> alt öğesi olan <title> etiketi, bir özellik grubu için başlık sağlar. |
Örnek | <Context> alt öğesi olarak: <title>Arama Motorum</title> <Facet> alt öğesi olarak: <title>facet title</title> |
Alt etiketi | Bağlam, Facet |
İçerik Biçimi | Metin |
TM | |
---|---|
Tanım | <TM> etiketi, arama sonuçlarını döndürmek için gereken toplam sunucu süresini saniye cinsinden tanımlar. |
Örnek | <TM>0,100445</TM> |
Alt etiketi | GSP |
İçerik Biçimi | Metin (Kayan noktalı sayı) |
TT | |
---|---|
Tanım | <TT> etiketi bir arama ipucu sağlar. |
Örnek | <TT><i>İpucu: Çoğu tarayıcıda Return tuşuna basmak Ara düğmesini tıklamakla aynı sonuçları üretir.</i></TT> |
Alt etiketi | GSP |
U | |
---|---|
Tanım | <U> etiketi, arama sonucunun URL'sini sağlar. |
Örnek | <U>http://www.dominos.com/</U> |
Alt etiketi | R |
İçerik Biçimi | Metin (Mutlak URL) |
UD | |
---|---|
Tanım | <UD> etiketi, arama sonucu için IDN kodlu (Uluslararası Alan Adı) URL'sini sağlar. Bu değer, alan adlarının yerel diller kullanılarak görüntülenmesine olanak tanır. Örneğin, IDN kodlamalı URL'nin http://www.%E8%8A%B1%E4%BA%95.com kodu çözülebilir ve http://www.花高鮨.com olarak görüntülenebilir. Bu <UD> etiketi, yalnızca ud parametresini içeren istekler için arama sonuçlarına dahil edilir. Not: Bu bir beta özelliktir. |
Örnek | <UD>http://www.%E8%8A%B1%E4%BA%95.com/</UD> |
Alt etiketi | R |
İçerik Biçimi | Metin (IDN kodlamalı URL) |
UE | |
---|---|
Tanım | <UE> etiketi, arama sonucunun URL'sini sağlar. Değer, URL çıkışlı olduğundan bir URL'de sorgu parametresi olarak geçirilmeye uygundur. |
Örnek | <UE>http://www.dominos.com/</UE> |
Alt etiketi | R |
İçerik Biçimi | Metin (URL çıkışlı URL) |
XT | |
---|---|
Tanım | <XT> etiketi, M etiketiyle belirtildiği gibi tahmini toplam sonuç sayısının aslında tam toplam sonuç sayısını temsil ettiğini belirtir. Daha fazla bilgi için bu dokümanın Otomatik Filtreleme bölümüne bakın. |
Örnek | <XT /> |
Alt etiketi | RES |
İçerik Biçimi | Boş |
Görsel Arama Sorguları İçin XML Sonuçları
Bu örnek Resim isteğinde, "maymun" (q=maymun) arama terimi hakkında 5 sonuç (num=5) istenir.
http://www.google.com/cse? searchtype=image &num=2 &q=monkey &client=google-csbe &output=xml_no_dtd &cx=00255077836266642015:u-scht7a-8i
Bu istek, aşağıdaki XML sonucunu verir.
<GSP VER="3.2"> <TM>0.395037</TM> <Q>monkeys</Q> <PARAM name="cx" value="011737558837375720776:mbfrjmyam1g" original_value="011737558837375720776:mbfrjmyam1g" url_<escaped_value="011737558837375720776%3Ambfrjmyam1g" js_escaped_value="011737558837375720776:mbfrjmyam1g"/> <PARAM name="client" value="google-csbe" original_value="google-csbe" url_escaped_value="google-csbe" js_escaped_value="google-csbe"/> <PARAM name="q" value="monkeys" original_value="monkeys" url_escaped_value="monkeys" js_escaped_value="monkeys"/> <PARAM name="num" value="2" original_value="2" url_escaped_value="2" js_escaped_value="2"/> <PARAM name="output" value="xml_no_dtd" original_value="xml_no_dtd" url_escaped_value="xml_no_dtd" js_escaped_value="xml_no_dtd"/> <PARAM name="adkw" value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" original_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" url_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" js_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A"/> <PARAM name="hl" value="en" original_value="en" url_escaped_value="en" js_escaped_value="en"/> <PARAM name="oe" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/> <PARAM name="ie" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/> <PARAM name="boostcse" value="0" original_value="0" url_escaped_value="0" js_escaped_value="0"/> <Context> <title>domestigeek</title> </Context> <ARES/> <RES SN="1" EN="2"> <M>2500000</M> <NB> <NU>/images?q=monkeys&num=2&hl=en&client=google-csbe&cx=011737558837375720776:mbfrjmyam1g&boostcse=0&output=xml_no_dtd &ie=UTF-8&oe=UTF-8&tbm=isch&ei=786oTsLiJaaFiALKrPChBg&start=2&sa=N </NU> </NB> <RG START="1" SIZE="2"/> <R N="1" MIME="image/jpeg"> <RU>http://www.flickr.com/photos/fncll/135465558/</RU> <U> http://farm1.static.flickr.com/46/135465558_123402af8c.jpg </U> <UE> http://farm1.static.flickr.com/46/135465558_123402af8c.jpg </UE> <T>Computer <b>Monkeys</b> | Flickr - Photo Sharing!</T> <RK>0</RK> <BYLINEDATE>1146034800</BYLINEDATE> <S>Computer <b>Monkeys</b> | Flickr</S> <LANG>en</LANG> <IMG WH="500" HT="305" IID="ANd9GcQARKLwzi-t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"> <SZ>88386</SZ> <IN/> </IMG> <TBN TYPE="0" WH="130" HT="79" URL="http://t0.gstatic.com/images?q=tbn:ANd9GcQARKLwzi- t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"/> </R> <R N="2" MIME="image/jpeg"> <RU> http://www.flickr.com/photos/flickerbulb/187044366/ </RU> <U> http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg </U> <UE> http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg </UE> <T> one. ugly. <b>monkey</b>. | Flickr - Photo Sharing! </T> <RK>0</RK> <BYLINEDATE>1152514800</BYLINEDATE> <S>one. ugly. <b>monkey</b>.</S> <LANG>en</LANG> <IMG WH="400" HT="481" IID="ANd9GcQ3Qom0bYbee4fThCQVi96jMEwMU6IvVf2b8K5vERKVw- EF4tQQnDDKOq0"><SZ>58339</SZ> <IN/> </IMG> <TBN TYPE="0" WH="107" HT="129" URL="http://t1.gstatic.com/images?q=tbn:ANd9GcQ3Qom0bYbee4fThCQ Vi96jMEwMU6IvVf2b8K5vERKVw-EF4tQQnDDKOq0"/> </R> </RES> </GSP>
Görsel Arama: XML Etiketleri
Aşağıdaki tabloda, görsel arama sorguları için XML yanıtlarında kullanılan diğer XML etiketleri gösterilmektedir.
Aşağıdaki tanımlarda bazı alt etiketlerin yanında belirli semboller gösterilebilir. Bu semboller ve anlamları aşağıdaki gibidir:
* = alt etiketin sıfır veya daha fazla örneği
+ = alt etiketin bir veya daha fazla örneği
RG | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Tanım | <RG> etiketi, tek bir görsel arama sonucunun ayrıntılarını içerir. |
|||||||||
Özellikler |
| |||||||||
Alt etiketi | RES |
RU | |
---|---|
Tanım | <RU tag> etiketi, her görsel arama sonucunun ayrıntılarını içerir. |
Alt etiketi | R |