XML API referansı

Bu sayfada, yalnızca Google Site Search müşterilerinin kullanabileceği Custom Search JSON API'nin XML sürümü yer almaktadır.

1. Genel Bakış
2. Programlanabilir Arama Motoru İstek Biçimi
   1. İsteğe Genel Bakış
   2. Sorgu Terimleri
   3. İstek Parametreleri
      1. Örnek WebSearch Sorguları
      2. WebSearch Sorgu Parametresi Tanımları
      3. Gelişmiş Arama
      4. Gelişmiş Arama Sorgu Parametreleri
      5. Özel Sorgu Terimleri
      6. Örnek Resim Sorguları
      7. Görsel Arama Sorgu Parametreleri
      8. İstek Sınırları
   4. Uluslararası Arama Sorguları ve Sonuç Sunumu
      1. Karakter Kodlama
      2. Arayüz dilleri
      3. Basitleştirilmiş ve Geleneksel Çince Arama
   5. Sonuçları Filtreleme
      1. Arama Sonuçlarına Otomatik Filtreleme
      2. Dil ve Ülke Filtreleme
      3. Güvenli Arama ile Yetişkinlere Uygun İçeriği Filtreleme
3. XML Sonuçları
   1. Google XML Sonuçlar DTD
   2. XML Yanıtı hakkında
   3. Normal, Görsel ve Gelişmiş Arama Sorguları için 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ı iç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 kendi web sitelerinde Google arama sonuçlarını görüntülemesine olanak sağlamaktadır. WebSearch hizmeti, arama sonuçları 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ılara sunma şekli ü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 Web Araması 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.

Web Araması İstek Biçimi

• İsteğe Genel Bakış
• Sorgu Terimleri
• İstek Parametreleri
• Örnek WebSearch Sorguları
• WebSearch Sorgu Parametresi 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 parametrelerin bir koleksiyonunu içerir. Bu parametreler, URL'de "ve" (&) karakteri ile ayrılmış ad=değer çiftleri olarak eklenir. Parametreler, arama sorgusu ve HTTP isteğinde bulunan 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ürleri belirtebilir. Sorgular şunları belirtebilir:

• Dahil edilecek veya hariç tutulacak kelimeler veya kelime öbekleri
  • Arama sorgusundaki tüm kelimeler (varsayılan)
  • Arama sorgusundaki tam ifade
  • Arama sorgusundaki herhangi bir kelime veya kelime öbeği
• Arama terimlerinin aranacağı 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ürlerine ait dokümanları (PDF dosyaları veya Word dokümanları gibi) dahil etme veya hariç tutma
• Arama yapmak yerine belirli bir URL hakkında bilgi döndüren özel URL sorguları
  • URL hakkında Open Directory kategorisi, snippet veya dil gibi genel bilgiler 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 sorgusunda, boşluk işareti yerine boşluk karakteri kullanabilirsiniz ("+" işareti). Bu, bu dokümanın URL Çıkışı bölümünde daha ayrıntılı bir şekilde açıklanmaktadı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 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 gerekir:

• 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 veya DTD'ye atıf yoluyla (xml) veya (xml_no_dtd) olmadan 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 sık kullanılan istek parametreleri şunlardır:

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

Örnek WebSearch Sorguları

Aşağıdaki örneklerde, farklı sorgu parametrelerinin nasıl kullanıldığını gösteren birkaç WebSearch HTTP isteği gösterilmektedir. Farklı sorgu parametreleriyle ilgili tanımlar, bu dokümanın WebSearch Sorgu Parametresi Tanımları ve Gelişmiş Arama Sorgusu Parametreleri bölümlerinde açıklanmıştır.

Bu istekte, "kırmızı"x" (q=red+sox) sorgu terimi için ilk 10 sonuç (start=0&num=10) sorulmaktadır. Sorgu, sonuçların Kanada'daki web sitelerinden (cr=countryCA) gelmesi ve Fransızca (lr=lang_fr) yazılması gerektiğini de belirtir. Son olarak, sorguda her üçü de zorunlu olan client, output ve cx parametrelerine ait değerler belirtilir.

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

    <!DOCTYPE GSP SYSTEM "google.dtd">

Gelişmiş Arama

Resmin altında listelenen ek sorgu parametreleri, gelişmiş arama sorgularıyla alakalıdır. Bir gelişmiş arama gönderdiğinizde bazı parametrelerin değerleri (ör. as_eq, as_epq, as_oq et sorguda tümü vb.) Resimde, Google'ın Gelişmiş Arama sayfası gösterilmektedir. Resimde, her bir gelişmiş arama parametresinin adı, söz konusu parametrenin karşılık geldiği sayfadaki alanın içinde veya yanında kırmızı metinle yazılmıştır.

Gelişmiş Arama Sorgu Parametreleri

Özel Sorgu Terimleri

Google WebSearch, 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 terimlerinde olduğu gibi özel sorgu terimleri de URL çıkışlı olmalıdır. Bazı özel sorgu terimleri iki nokta üst üste (:) içerir. Bu karakter de URL çıkışlı olmalıdır. URL çıkışlı değeri %3A olur.

Örnek Resim Sorguları

Aşağıdaki örneklerde, farklı sorgu parametrelerinin nasıl kullanıldığını gösteren birkaç Resim HTTP isteği gösterilmektedir. Farklı sorgu parametrelerinin tanımları, bu dokümanın Resim Sorgu Parametresi Tanımları bölümlerinde sağlanır.

Bu istekte, .png dosya türünün "& mayt" (q=monkey)" terimi için ilk 5 sonuç (start=0&num=5) soruluyor. Son olarak, sorgu client, output ve cx parametreleri için değerleri belirtir. Bu parametrelerin üçü de gereklidir.

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 listelenmiştir:

Sorguları Uluslararası Hale Getirme ve Sonuçlar 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). 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 açıklanmaktadır:

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

Karakter Kodlama

Sunucular, verileri (ör. web sayfaları) tarayıcılar gibi kullanıcı aracılarına şifrelenmiş bayt dizisi olarak gönderir. Ardından kullanıcı aracısı, 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ı belirleyebilirsiniz.

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 için 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 çok dil için 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 genel bilgiler 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, ö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, arama sonuçlarını kullanıcının giriş diliyle aynı dilde 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 parametresine ilişkin geçerli değerlerin tam listesi için lütfen Desteklenen Arayüz Dilleri bölümüne bakın.

Belirli Dillerde Yazılan Dokümanları Arama

Arama sonuçlarını belirli bir dilde veya dil grubunda yazılmış dokümanlarla sınırlamak için lr istek parametresini kullanabilirsiniz.

lr parametresi Boole Operatörleri'ni destekler. Böylece arama sonuçlarında yer alması (veya hariç tutulması gereken) birden çok dil belirtmenizi sağlar.

Aşağıdaki örneklerde, farklı dillerde doküman istemek için Boole Operatörleri'ni 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 olmayan dokümanlar için:

lr=(-lang_hu).(-lang_cs)

Bu operatörlerin kullanımıyla ilgili eksiksiz bir tartışma için lr parametresine yönelik olası değerlerin tam listesini ve Boole Operatörleri bölümünü görmek için Dil Toplama Değerleri bölümüne bakın.

Basitleştirilmiş ve Geleneksel Çince Arama

Basitleştirilmiş Çince ve Geleneksel Çince, Çincenin iki yazma çeşididir. Aynı kavram, her varyantta farklı şekilde yazılabilir. Varyantlardaki sorgulardan biri göz önünde bulundurulduğunda, Google Web Arama hizmeti her iki varyanttaki sayfaları da 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 ayarla

Aşağıdaki örnekte, hem basitleştirilmiş Çince hem de geleneksel Çince sonuçlar için bir isteğe dahil edilecek sorgu parametreleri gösterilmektedir. (Örnekte client gibi gerekli ek bilgilerin 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 sağlar:

• Arama Sonuçlarına Otomatik Filtreleme
• Dil ve Ülke Filtreleme
• Güvenli Arama ile Yetişkinlere Uygun İçeriği Filtreleme

Arama Sonuçlarına Otomatik Filtreleme

Mümkün olan en iyi arama sonuçlarını sağlamak amacıyla Google, genellikle istenmeyen olarak değerlendirilen arama sonuçlarını otomatik olarak filtrelemek için iki teknik kullanır:

• Yinelenen İçerik: Aynı bilgileri birden fazla doküman içeriyorsa arama sonuçlarınızda bu kümenin yalnızca en alakalı dokümanı yer alır.

• Ana Kitle Dışlama: Aynı siteden çok sayıda arama sonucu geldiyse Google, bu siteden tüm sonuçları göstermeyebilir veya sıralamada
  Normalde Gösterilenden daha düşük sonuçlar gösterebilir.

Filtreler çoğu arama sonucunun kalitesini önemli ölçüde artırdığı için tipik arama istekleri için bu filtreleri 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üman alt koleksiyonları içerir.

Arama sonuçlarını sırasıyla belirli dillerde yazılmış veya belirli ülkelerden gelen belge alt koleksiyonlarıyla sınırlandırmak için lr ve cr istek parametrelerini kullanabilirsiniz.

Google WebSearch, bir dokümanın dilini aşağıdakileri analiz ederek belirler:

• dokümanın URL'sinin üst düzey alanı (TLD)
• doküman içindeki dil meta etiketleri
• dokümanın gövde metninde kullanılan birincil dil

Dile göre sonuçları kısıtlama hakkında daha fazla bilgi için lr parametresinin değerleri olarak kullanılabilecek lr parametresinin tanımına, Belirli Dillerde Yazılan Dokümanları Arama bölümüne ve Dil Toplama Değerleri bölümüne de bakabilirsiniz.

Google WebSearch, şunları analiz ederek bir dokümanın ülkesini belirler:

• dokümanın URL'sinin üst düzey alanı (TLD)
• Web sunucusunun IP adresinin coğrafi konumu

Sonuçların kaynak ülkeye göre kısıtlanmasıyla ilgili daha fazla bilgi için lütfen cr parametresinin değerleri olarak kullanılabilecek cr parametresinin ve Ülke Toplama Değerlerinin tanımına bakın.

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

Güvenli Arama ile Yetişkinlere Uygun İçeriği Filtreleme

Birçok Google müşterisi, yetişkinlere uygun içerik barındıran siteler için arama sonuçları göstermek istemez. Güvenli Arama filtremizi kullanarak yetişkinlere uygun içeriğe sahip arama sonuçlarını filtreleyebilir ve bu sonuçları kaldırabilirsiniz. Google filtreleri, anahtar kelimeleri, kelime öbeklerini ve URL'leri kontrol etmek için özel bir teknoloji kullanır. Hiçbir filtre yüzde 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, Web'i sürekli tarayıp kullanıcı önerilerinden gelen güncellemeleri ekleyerek Güvenli Arama'yı olabildiğince güncel ve kapsamlı tutmaya çalışır.

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

Güvenli sorgu parametresini kullanarak Google'ın yetişkinlere uygun içerik için sonuçlarınızı filtreleme derecesini 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 arama sonuçlarında rahatsız edici içeriğe sahip siteler bulursanız, lütfen sitenin URL'sini safesearch@google.com adresine e-postayla gönderin. Bunu yaptığınızda siteyi inceleriz.

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ürleri için XML biçimini tanımlamak üzere aynı DTD'yi kullanır. Etiketlerin ve özelliklerin çoğu tüm arama türleri için geçerlidir. Bununla birlikte, bazı etiketler yalnızca belirli arama türleri için geçerlidir. Bu nedenle, DTD'deki tanımlar bu dokümanda belirtilen tanımlardan daha az kısıtlayıcı olabilir.

Bu dokümanda, DTD'nin Web Arama ile ilgili yönleri açıklanmaktadır. DTD'ye baktığınızda WebSearch üzerinde çalışıyorsanız burada belgelenmeyen etiketleri ve özellikleri güvenle yoksayabilirsiniz. DTD ve belgeler arasında tanım farklılık gösteriyorsa bu dokümanda bu durum belirtilmiştir.

Google, XML sonuçlarını en son DTD'ye referans vererek veya böyle bir referans olmadan 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 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ırmamanız gerekir.

Ayrıca, her arama isteği gönderdiğinizde XML ayrıştırıcınızı 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 sonuçların XML sonuçlarına 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ılamayabilir veya desteklenmeyebileceğini lütfen unutmayın.

XML Yanıtı hakkında

• XML etiket tanımlarında aksi belirtilmedikçe tüm öğe değerleri, gösterilmeye uygun olan 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. Böylece Google, XML çıkışına daha fazla özellik eklerse uygulamanız değişiklik yapılmadan çalışmaya devam eder.
• Belirli karakterler, XML etiketlerine değer olarak eklendiğinde kod dışına alınmalıdır. XML işlemciniz bu varlıkları tekrar uygun karakterlere dönüştürmelidir. Varlıkları uygun şekilde dönüştürmezseniz tarayıcı örneğin, & karakterini &&;;amp;" şeklinde 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	ve	&	&38;
  Tek Tırnak İşareti	'	'	& 39;
  Çift Tırnak İşareti	"	"	& 34;
  Büyüktür İşareti	>	>	&66;
  Küçüktür İşareti	<	&lt;	&60;

Normal ve Gelişmiş Arama Sorguları iç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, bu örnek için kasıtlı olarak yanlış yazılan 10 sonuç (num=10) soruyor.)

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 sağlar. XML sonucunda, sonuçlara 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

Hem normal arama istekleri hem de gelişmiş arama istekleri için XML yanıtları, aynı XML etiketi grubunu kullanır. Bu XML etiketleri yukarıdaki XML örneğinde gösterilmiştir 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ı bir etiket açıklaması içerir. Etiketin XML sonucunda nasıl görüneceğini ve etiket içeriğinin biçimini gösteren bir örnek aşağıda verilmiştir. 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 simgeler 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ı için XML Sonuçları

Bu örnek Resim isteği, arama terimi " maymun&q; (q=maymun) hakkında 5 sonuç (sayı=5) istiyor.

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 sağlar.

<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 ek XML etiketleri gösterilmektedir.

Aşağıdaki tanımlarda bazı alt etiketlerin yanında belirli simgeler gösterilebilir. Bu semboller ve anlamları aşağıdaki gibidir: