XML API referansı

Bu sayfada, yalnızca Google Site Search müşterileri tarafından kullanılabilen Custom Search JSON API'nin XML sürümü ele alınmaktadır.

1. Genel Bakış
2. Programlanabilir Arama Motoru İstek Biçimi
   1. İsteklere Genel Bakış
   2. Sorgu Terimleri
   3. İstek Parametreleri
      1. Örnek Web Arama Sorguları
      2. WebSearch Sorgu Parametresi Tanımları
      3. Gelişmiş Arama
      4. Gelişmiş Arama Sorgusu Parametreleri
      5. Özel Sorgu Terimleri
      6. Örnek Resim Sorguları
      7. Görsel Arama Sorgu Parametreleri
      8. İstek sınırları
   4. Sorguları ve Sonuç Sunumunu Uluslararası Hale Getirme
      1. Karakter Kodlama
      2. Arayüz Dilleri
      3. Basitleştirilmiş ve Geleneksel Çince Arama
   5. Sonuçları Filtreleme
      1. Arama sonuçlarını otomatik olarak filtreleme
      2. Dil ve ülke filtreleme
      3. Güvenli Arama ile yetişkinlere uygun içerikleri filtreleme
3. XML Sonuçları
   1. Google XML Sonuçları DTD'si
   2. XML yanıtı hakkında
   3. Normal, Görsel ve Gelişmiş Arama Sorgularıyla İlgili XML Sonuçları
      1. Normal/Gelişmiş Arama: Örnek Sorgu ve XML Sonucu
      2. Normal/Gelişmiş Arama: XML Etiketleri
      3. Görsel Arama Sorguları İçin XML Sonuçları
      4. Görsel Arama: Örnek Sorgu ve XML Sonucu
      5. Görsel Arama: XML Etiketleri

Genel Bakış

Google WebSearch hizmeti, Google Site Search müşterilerinin Google arama sonuçlarını kendi web sitelerinde göstermelerini sağlar. WebSearch hizmeti, arama sonuçlarını sunmak için basit bir HTTP tabanlı protokol kullanır. Arama yöneticileri, arama sonuçlarını isteme ve bu sonuçları son kullanıcıya sunma şekli üzerinde tam kontrole sahiptir. Bu belgede, Google arama isteği ve sonuç biçimlerinin teknik ayrıntıları açıklanmaktadır.

Uygulamanız, Google Web Arama 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

• İstek Genel Bakış
• Sorgu Terimleri
• İstek Parametreleri
• Örnek Web Arama Sorguları
• WebSearch Query Parameter Definitions (WebSearch Sorgusu Parametre Tanımları)
• Örnek Resim Sorguları
• Görsel Arama Sorgusu Parametre Tanımları
• Gelişmiş Arama
  
• Gelişmiş Arama Sorgu Parametreleri
• Özel Sorgu Terimleri
• İstek sınırları

İsteğe Genel Bakış

Google arama isteği, standart bir HTTP GET komutudur. Sorgularınızla ilgili bir parametre koleksiyonu içerir. Bu parametreler, istek URL'sine "ve" (&) karakterleriyle ayrılmış ad=değer çiftleri olarak eklenir. Parametreler arasında arama sorgusu gibi veriler ve HTTP isteğinde bulunan motoru tanımlayan benzersiz bir motor kimliği (cx) yer alır. WebSearch veya Image Search 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. Bir 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. Sorgularda şunlar belirtilebilir:

• Dahil edilecek veya hariç tutulacak kelimeler ya da ifadeler
  • Arama sorgusundaki tüm kelimeler (varsayılan)
  • Arama sorgusunda tam kelime öbeği
  • Arama sorgusundaki herhangi bir kelime veya ifade
• Arama terimlerini bulmak için belgenin hangi bölümüne bakmalısınız?
  • Belgenin herhangi bir yerinde (varsayılan)
  • Yalnızca belgedeki bağlantılarda
• Belgelerin kendileriyle ilgili kısıtlamalar
  • Belirli dosya türlerindeki dokümanları (ör. PDF dosyaları veya Word belgeleri) dahil etme ya da hariç tutma
• Arama yapmak yerine belirli bir URL hakkında bilgi döndüren özel URL sorguları
  • Bir URL hakkında genel bilgiler (ör. Open Directory kategorisi, snippet veya dil) döndüren sorgular
  • Bir URL'ye bağlantı veren web sayfaları grubunu döndüren sorgular
  • Belirli bir URL'ye benzer bir grup web sayfası döndüren sorgular

Varsayılan Arama

Arama sorgusu parametre değerleri URL'de kod dışına alınmalıdır. Arama sorgusundaki tüm boşluk dizilerinin yerine artı işareti ("+") koymanız gerektiğini unutmayın. Bu konu, bu belgenin URL'de Kod Dışına Alma 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 tüm terimleri içeren dokümanları döndürür.

İstek Parametreleri

Bu bölümde, arama isteğinde bulunurken kullanabileceğiniz parametreler listelenmektedir. Parametreler iki listeye ayrılır. İlk liste, tüm arama istekleriyle alakalı parametreleri içerir. İkinci listede yalnızca gelişmiş arama istekleriyle alakalı olan parametreler yer alır.

Üç 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 referans olmadan (xml_no_dtd) döndürülebilir. Bu değeri xml_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 çok tercih edilen istek parametreleri şunlardır:

• num: İstenen arama sonuçlarının sayısı
• q: Arama terimleri
• start: Sonuçların başlangıç dizini

Örnek Web Arama Sorguları

Aşağıdaki örneklerde, farklı sorgu parametrelerinin nasıl kullanıldığını göstermek için birkaç WebSearch HTTP isteği yer almaktadır. Farklı sorgu parametrelerinin tanımları, bu belgenin WebSearch Sorgu Parametresi Tanımları ve Gelişmiş Arama Sorgu Parametreleri bölümlerinde verilmiştir.

Bu istek, "red sox" (q=red+sox) sorgu terimi için ilk 10 sonucu (start=0&num=10) istiyor. Sorgu ayrıca sonuçların Kanada web sitelerinden (cr=countryCA) gelmesi ve Fransızca (lr=lang_fr) yazılması gerektiğini belirtiyor. Son olarak sorgu, gerekli olan client, output ve cx parametrelerinin değerlerini belirtiyor.

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ılıyor. Bu istekte q parametresi yerine as_q parametresi (as_q=red+sox) kullanılıyor. Ayrıca, "Yankees" kelimesini içeren tüm belgeleri arama sonuçlarından hariç tutmak için as_eq parametresini kullanır (as_eq=yankees).

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ı

    <!DOCTYPE GSP SYSTEM "google.dtd">

Gelişmiş Arama

Resmin altında listelenen ek sorgu parametreleri, gelişmiş arama sorgularıyla ilgilidir. Gelişmiş arama gönderdiğinizde çeşitli parametrelerin (ör. as_eq, as_epq, as_oq vb.) değerleri, söz konusu aramanın sorgu terimlerine dahil edilir. Resimde Google'ın Gelişmiş Arama sayfası gösteriliyor. Resimde, her gelişmiş arama parametresinin adı, kırmızı metinle, sayfadaki ilgili parametrenin alanının içinde veya yanında yazılır.

Gelişmiş Arama Sorgu Parametreleri

Özel Sorgu Terimleri

Google Web Arama, Google arama motorunun ek özelliklerine erişen çeşitli özel sorgu terimlerinin kullanılmasına olanak tanır. Bu özel sorgu terimleri, q istek parametresinin değerine dahil edilmelidir. Diğer sorgu terimleri gibi, özel sorgu terimlerinin de URL'de kod dışına alınması gerekir. Birkaç özel sorgu terimi iki nokta üst üste (:) içerir. Bu karakter de URL olarak kod dışına alınmalıdır. URL olarak kod dışına alınmış değeri %3A'dır.

Ö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 yer almaktadır. Farklı sorgu parametrelerinin tanımları, bu belgenin Resim Sorgusu Parametresi Tanımları bölümlerinde verilmiştir.

Bu istekte, "monkey" (q=monkey) sorgu terimi için .png dosya türünde ilk 5 sonuç (start=0&num=5) isteniyor. Son olarak, sorgu client, output ve cx parametreleri için değerler belirtir. Bu üç parametrenin de girilmesi zorunludur.

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

İstek Sınırları

Aşağıdaki grafikte, Google'a gönderdiğiniz arama istekleriyle ilgili sınırlamalar listelenmektedir:

Sorguları ve sonuç sunumunu uluslararası hale getirme

Google WebSearch hizmeti, birden fazla dildeki dokümanları aramanıza olanak tanır. HTTP isteğinizi yorumlamak ve XML yanıtınızı kodlamak için kullanılması gereken karakter kodlamasını (ie ve oe arama parametrelerini kullanarak) belirtebilirsiniz. Sonuçları yalnızca belirli dillerde yazılmış dokümanları içerecek şekilde de filtreleyebilirsiniz.

Aşağıdaki bölümlerde, birden fazla dilde arama yapmayla ilgili sorunlar ele alınmaktadır:

• Karakter Kodlama
• Arayüz Dilleri
• Basitleştirilmiş ve Geleneksel Çince Arama

Karakter Kodlaması

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ı karakter dizisi olarak çözer. Web Arama 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 üzere 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 sunuyorsanı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 genel bilgi için lütfen http://www.w3.org/TR/REC-html40/charset.html adresini ziyaret edin.

Arayüz Dilleri

Grafik arayüzünüzün dilini belirlemek için hl istek parametresini kullanabilirsiniz. hl parametre değeri, özellikle dil kısıtlaması (lr parametresi kullanılarak) açıkça belirtilmediğinde uluslararası sorgularda XML arama sonuçlarını etkileyebilir. Bu tür durumlarda hl parametresi, kullanıcının giriş diliyle aynı dildeki arama sonuçlarını öne çıkarabilir.

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 dillerde yazılmış dokümanlarla kısıtlamak için lr istek parametresini kullanabilirsiniz.

lr parametresi, arama sonuçlarına dahil edilecek (veya hariç tutulacak) birden fazla dil belirtmenize olanak tanımak için Boole operatörlerini destekler.

Aşağıdaki örneklerde, farklı dillerdeki dokümanları 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, bu operatörlerin kullanımıyla ilgili ayrıntılı bilgi için ise Boole Operatörleri bölümüne bakın.

Basitleştirilmiş ve Geleneksel Çince Arama

Basitleştirilmiş Çince ve Geleneksel Çince, Çince dilinin iki yazım varyantıdır. Aynı kavram, her varyantta farklı şekilde yazılabilir. Google Web Arama hizmeti, varyantlardan birinde verilen bir sorgu için her iki varyanttaki sayfaları içeren sonuçlar döndürebilir.

Bu özelliği kullanmak için:

1. c2coff istek parametresini 0 olarak ayarlayın
   ve
2. Aşağıdakilerden birini yapın:
   • lr istek parametresini ayarlamayın
     veya
   • lr istek parametresini lr=lang_zh-TW|lang_zh-CN olarak ayarlayın.

Aşağıdaki örnekte, hem basitleştirilmiş hem de geleneksel Çince sonuç isteğine dahil edeceğiniz sorgu parametreleri gösterilmektedir. (client gibi ek zorunlu bilgilerin örneğe dahil edilmediğini unutmayın.)

search?hl=zh-CN
    &lr=lang_zh-TW|lang_zh-CN
    &c2coff=0

Sonuçları Filtreleme

Google Web Arama, arama sonuçlarınızı filtrelemenin çeşitli yollarını sunar:

• Arama Sonuçlarını Otomatik Olarak Filtreleme
• Dil ve ülke filtreleme
• Güvenli Arama ile Yetişkinlere Uygun İçerikleri Filtreleme

Arama sonuçlarını otomatik olarak 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 doküman aynı bilgileri içeriyorsa yalnızca en alakalı doküman arama sonuçlarınıza dahil edilir.

• Ana Makine İzleyici: Aynı siteden çok sayıda arama sonucu döndürülüyorsa Google, söz konusu siteden gelen tüm sonuçları göstermeyebilir veya sonuçları sıralamada normalde olacağından daha aşağıda gösterebilir.
  

Bu filtreler, çoğu arama sonucunun kalitesini önemli ölçüde artırdığı için normal arama isteklerinde bu filtreleri etkin bırakmanızı öneririz. Ancak arama isteğinizde filter sorgu parametresini 0 olarak ayarlayarak bu otomatik filtreleri atlayabilirsiniz.

Dil ve ülke filtreleme

Google WebSearch, tüm web dokümanlarının bulunduğu bir ana dizinden 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ı belirli dillerde yazılmış veya belirli ülkelerden gelen doküman alt kümeleriyle kısıtlamak için sırasıyla 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ümandaki 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 için lütfen lr parametresinin tanımını, Belirli Dillerde Yazılmış Dokümanları Arama bölümünü ve lr parametresinin değerleri olarak kullanılabilecek Dil Koleksiyonu Değerleri'ni de inceleyin.

Google WebSearch, 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ğerleri olarak kullanılabilecek Ülke Koleksiyonu Değerleri'ne de bakın.

Not: Arama sonuçlarınızı özelleştirmek için dil değerlerini ve ülke değerlerini birleştirebilirsiniz. Örneğin, Fransa veya Kanada'dan gelen ve Fransızca yazılmış dokümanlar ya da Hollanda'dan gelen ve İngilizce yazılmamış dokümanlar isteyebilirsiniz. Hem lr hem de cr parametreleri Boole operatörlerini destekler.

Yetişkinlere uygun içerikleri Güvenli Arama ile filtreleme

Birçok Google müşterisi, yetişkinlere yönelik içerik barındıran sitelerle ilgili arama sonuçlarını göstermek istemez. Güvenli Arama filtremizi kullanarak yetişkinlere uygun içerik barındıran arama sonuçlarını filtreleyebilir ve bunları sonuçlardan kaldırabilirsiniz. Google'ın filtreleri, anahtar kelimeleri, ifadeleri ve URL'leri kontrol etmek için tescilli teknolojiyi kullanır. Hiçbir filtre %100 doğru olmasa da Güvenli Arama, yetişkinlere uygun içeriklerin büyük çoğunluğunu arama sonuçlarınızdan kaldırır.

Google, web'i sürekli olarak tarayarak ve kullanıcı önerilerinden gelen güncellemeleri dahil ederek Güvenli Arama'yı olabildiğince güncel ve kapsamlı tutmak için çalışır.

Güvenli Arama aşağıdaki dillerde kullanılabilir:

Google'ın yetişkinlere uygun içeriklerle ilgili sonuçlarınızı filtreleme derecesini safe sorgu parametresini kullanarak 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'yı etkinleştirdiyseniz ve sonuçlarınızda rahatsız edici içerik barındıran sitelerle karşılaşırsanız lütfen sitenin URL'sini safesearch@google.com adresine e-postayla gönderin. Sitenin durumunu inceleyeceğiz.

XML Sonuçları

• Google XML Sonuçları DTD'si
• XML yanıtı hakkında
• XML Normal ve Gelişmiş Arama Sorgularının Sonuçları
• Normal/Gelişmiş Arama: Örnek Sorgu ve XML Sonucu
• Normal/Gelişmiş Arama: XML Etiketleri

Google XML Sonuçları DTD'si

Google, tüm arama sonucu türlerinin XML biçimini açıklamak 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. Bu nedenle, DTD'deki tanımlar bu belgedeki tanımlara göre daha az kısıtlayıcı olabilir.

Bu belgede, DTD'nin WebSearch için geçerli olan yönleri açıklanmaktadır. DTD'ye baktığınızda, WebSearch üzerinde çalışıyorsanız burada belgelenmemiş etiketleri ve özellikleri güvenle yoksayabilirsiniz. Tanım, DTD ile doküman arasında farklılık gösteriyorsa bu durum bu dokümanda belirtilir.

Google, XML sonuçlarını en son DTD'ye referans vererek veya vermeden döndürebilir. DTD, arama yöneticilerinin ve XML ayrıştırıcılarının Google'ın XML sonuçlarını anlamasına yardımcı olan bir kılavuzdur. Google'ın XML dilbilgisi 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ırmamalısınız. Google, DTD'yi nadiren günceller ve bu istekler gereksiz gecikmeye ve bant genişliği koşullarına neden olur.

Google, XML sonuçları almak için xml_no_dtd çıkış biçimini kullanmanızı önerir. Arama isteğinizde xml çıktı biçimini belirtirseniz tek fark, XML sonuçlarına aşağıdaki satırın eklenmesidir:

<!DOCTYPE GSP SYSTEM "google.dtd">

En son DTD'ye http://www.google.com/google.dtd adresinden erişebilirsiniz.

DTD'deki tüm özelliklerin şu anda kullanılamayabileceğini veya desteklenmeyebileceğini lütfen unutmayın.

XML yanıtı hakkında

• XML etiketi tanımlarında aksi belirtilmedikçe tüm öğe değerleri, görüntülemeye 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ş özellikleri ve etiketleri yoksaymalıdır. Bu sayede, Google XML çıkışına daha fazla özellik eklese bile uygulamanızda değişiklik yapmadan çalışmaya devam edebilirsiniz.
• XML etiketlerine değer olarak dahil edilen belirli karakterler için çıkış karakteri kullanılmalıdır. XML işlemciniz bu öğeleri uygun karakterlere geri dönüştürmelidir. Öğeleri düzgün şekilde dönüştürmezseniz tarayıcı, örneğin & karakterini "&" olarak oluşturabilir. XML Standardı belgelerinde bu karakterler açıklanır. Bu karakterler aşağıdaki tabloda yeniden verilmiştir:

  Karakter	Kaçış karakteri kullanılan formlar	Varlık	Karakter Kodu
  Ve işareti	&	&	&
  Tek Tırnak İşareti	'	'	'
  Çift Tırnak İşareti	"	"	"
  Büyüktür	>	>	>
  Küçüktür	<	&lt;	&#60;

Normal ve Gelişmiş Arama Sorguları İçin XML Sonuçları

Normal/Gelişmiş Arama: Örnek Sorgu ve XML Sonucu

Bu örnek WebSearch isteğinde, "futbol" (q=socer) arama terimiyle ilgili 10 sonuç (num=10) isteniyor. Bu örnekte "futbol" kelimesi kasıtlı olarak 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 olduğ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ında aynı XML etiketleri grubu kullanılır. Bu XML etiketleri, yukarıdaki XML örneğinde gösterilmekte ve aşağıdaki tablolarda açıklanmaktadır.

Aşağıdaki XML etiketleri, etiket adına göre alfabetik olarak listelenmiştir. Her etiket tanımı, etiketin açıklamasını, etiketin XML sonucunda nasıl görüneceğini gösteren bir örneği ve etiketin içerik biçimini içerir. Etiket başka bir XML etiketinin alt etiketiyse veya etiketin kendi alt etiketleri ya da özellikleri varsa bu bilgiler de etiketin tanım tablosunda 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:

This example uses the refinement label golf_courses to
filter search results about Palm Springs:
    q=Palm+Springs+more:golf_courses

The URL-escaped version of this query is:
    q=Palm+Springs+more%3Agolf_courses

Görsel Arama Sorguları İçin XML Sonuçları

Bu örnek görsel isteğinde, "maymun" (q=monkey) arama terimiyle ilgili 5 sonuç (num=5) isteniyor.

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ıyla ilgili XML yanıtlarında kullanılan ek 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: