XML API referansı

Bu sayfa, Custom Search JSON API'nin yalnızca Google Site Search müşterileri.

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 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çları Uluslararasılaştırma Sunumu
      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. Yetişkinlere Uygun İçeriği Güvenli Arama ile Filtreleme
3. XML Sonuçları
   1. Google XML Sonuçları DTD
   2. XML Yanıtı hakkında
   3. Normal, Resim ve XML için XML Sonuçları Gelişmiş Arama Sorguları
      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'ü etkinleştirir müşterilerin Google arama sonuçlarını kendi web sitelerinde görüntülemelerine olanak tanır. İlgili içeriği oluşturmak için kullanılan WebSearch hizmeti, arama sonuçları göstermek için HTTP tabanlı basit bir protokol kullanır sonuç. Arama yöneticilerinin, oluşturma ve satın alma işlemlerini arama sonuçlarını isteyebilir ve bu sonuçları kullanıcılara nasıl yardımcı olur. Bu belgede, Google Cloud Yardım Merkezi'nin arama isteği ve sonuç biçimlerinden bahsedeceğiz.

Uygulamanız, Google WebSearch sonuçlarını almak için Google'a basit bir HTTP isteği gönderebilirsiniz. Google daha sonra arama sonuçlarını XML olarak döndürür. biçimindedir. XML biçimli sonuçlar size, kendi görünümünü kullanarak arama sonuçlarının görüntülenme şekli.

WebSearch İstek Biçimi

• İstek gönder Genel Bakış
• Sorgu Terimleri
• İstek Parametreleri
• Örnek WebSearch Sorguları
• 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. Google işletmenizle alakalı parametre koleksiyonunu içerir daha fazla bilgi edineceksiniz. Bu parametreler istek URL'sine name=value olarak eklenir çiftler (ve) (&) karakterleriyle ayrılır. Parametreler şunları içerir: benzersiz bir arama motoru kimliği (cx) gibi veriler HTTP isteğinde bulunan arama motorunu tanımlar. WebSearch veya Görsel Arama hizmeti XML, HTTP isteklerinize yanıt olarak ortaya çıkar.

Sorgu Terimleri

Çoğu arama isteği bir veya daha fazla sorgu terimi içerir. Bir sorgu terimi arama isteğinde bir parametrenin değeri olarak görünür.

Sorgu terimleri, filtrelenecek çeşitli bilgi türlerini belirtebilir Google'ın döndürdüğü arama sonuçlarını düzenlemek için kullanılır. Sorgular:

• Eklenecek kelimeler veya kelime öbekleri hariç tut
  • Bir arama sorgusundaki tüm kelimeler (varsayılan)
  • Arama sorgusundaki tam bir kelime öbeği
  • Arama sorgusundaki herhangi bir kelime veya kelime öbeği
• Dokümanın neresinde? arama terimleri
  • 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 URL'sinde
  • Yalnızca dokümandaki bağlantılarda
• Belgelerle ilgili kısıtlamalar
  • Belirli dosya türlerindeki dokümanları dahil etme veya hariç tutma (ör. PDF dosyaları veya Word dokümanları)
• Döndürülen özel URL sorguları aramak yerine belirli bir URL hakkında bilgi
  • Bir URL hakkında genel bilgiler döndüren sorgular, örneğin Open Directory kategorisi, snippet'i veya dili
  • Bir URL'ye bağlantı veren web sayfaları grubunu döndüren sorgular
  • Belirli bir URL'ye benzer web sayfaları grubunu döndüren sorgular

Varsayılan Arama

Arama sorgusu parametre değerleri URL çıkışlı olmalıdır. Lütfen karakteri, anlamına gelir. Bu konu, bu dokümanın URL Çıkışı bölümünde daha ayrıntılı bir şekilde ele alınmaktadır.

Arama sorgusu terimi WebSearch hizmetine q parametresiyle aynı olmalıdır. CEVAP örnek arama sorgusu terimi:

q=horses+cows+pigs

Varsayılan olarak, Google WebSearch hizmeti yalnızca arama sorgusuna dahil etmektir.

İstek Parametreleri

Bu bölümde, yeni bir URL oluştururken kullanabileceğiniz arama isteği. Parametreler iki listeye ayrılır. İlk liste, tüm arama istekleriyle alakalı parametreleri içerir. İkinci liste, şunlardır: yalnızca gelişmiş arama istekleriyle alakalı olmalıdır.

Üç istek parametresi gereklidir:

• client parametresi google-csbe olarak ayarlanmalıdır
• Çıkış parametresi döndürülen XML sonuçlarının biçimini; sonuç (xml) ile döndürülebilir veya Google'ın DTD'si (xml_no_dtd) referansı olmadan. Önerilerimiz: bu değer xml_no_dtd olarak ayarlanıyor. Not: Bu parametreyi belirtmezseniz sonuçlar XML yerine HTML kullanın.
  
• Benzersiz Search Ads 360'ı temsil eden cx parametresi Motorun kimliği.
  

Bunlar dışında en sık kullanılan istek parametreleri Yukarıda bahsedilenler:

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

Örnek WebSearch Sorguları

Aşağıdaki örneklerde, Search Ads 360'ta bulunan farklı sorgu parametrelerinin nasıl kullanıldığını gösterir. Tanımlar WebSearch Sorgusu"nda farklı sorgu parametreleri sunulur. Parametre Tanımları ve Gelişmiş Arama Sorgusu Parametreler bölümleri.

Bu istekte ilk 10 sonuç isteniyor (start=0&num=10) "red sox" sorgu terimi (q=red+sox). Sorgu ayrıca sonuçların Kanada web sitelerinden (cr=countryCA) gelmesi gerektiğini belirtir Fransızca (lr=lang_fr) dilinde yazılmalıdır. Son olarak, istemci, çıkış ve ve cx parametrelerinden üçü de gereklidir.

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, Google tarafından sağlanan gelişmiş arama sorgularından parametrelerini kullanın. Bu istekte as_q kullanılıyor parametresini (as_q=red+sox) kullanarak q parametresini kullanmanız gerekir. Ayrıca "Yankees" kelimesini içeren dokümanları hariç tutmak için as_eq parametresini kullanın şuradan arama sonuçları (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 değerleri (ör. as_eq, as_epq, as_oq vb.) sorguda dikkate alınır anlamına gelir. Resimde, Google'ın Gelişmiş Arama sayfası gösterilmektedir. Resimde, her birinin adı gelişmiş arama parametresi içine veya yanına kırmızı metin yazılır sayfada bu parametreye karşılık gelen alana girin.

Gelişmiş Arama Sorgusu Parametreleri

Özel Sorgu Terimleri

Google WebSearch, bir arama sorgusunun kendisi tarafından Google arama motorunun ek özelliklerine erişme. Bu özel sorgu terimleri, q istek parametresinin değerine dahil edilmelidir. Diğer sorgu terimlerinde olduğu gibi, özel sorgu terimleri URL çıkışlı olmalıdır. CEVAP sayısı iki nokta üst üste (:) içeren özel sorgu terimleridir. Bu karakter URL çıkışlı da olmalıdır; URL çıkışlı değeri %3A şeklindedir.

Örnek Resim Sorguları

Aşağıdaki örnekler, farklı sorgu parametrelerinin nasıl kullanıldığını göstermek için birkaç Resim HTTP isteğini göstermektedir. Farklı sorgu parametrelerinin tanımları bu dokümanın Resim Sorgusu Parametre Tanımları bölümünde sağlanmıştır.

Bu istekte "maymun" sorgu terimi için ilk 5 sonuç (start=0&num=5) isteniyor (q=monkey), .png dosya türü. Son olarak sorgu, üçü de gerekli olan client, output ve cx parametreleri için değerler 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

İstek Sınırları

Aşağıdaki grafikte, belirttiğiniz arama isteklerine ilişkin sınırlamalar Google'a gönder:

Sorguları ve Sonuçları Uluslararasılaştırma Sunumu

Google WebSearch hizmeti, Google Web Arama'daki dokümanları birden çok dile çevirebilirsiniz. Dahil edilmesi gereken karakter kodlamasını HTTP isteğinizi yorumlamak ve XML yanıtınızı kodlamak için kullanılır. (ie ve oe aramasını kullanarak parametrelerinde de bulunur.) Sonuçları yalnızca dokümanları içerecek şekilde filtreleyebilirsiniz belirli dillerde yazılmış olur.

Aşağıdaki bölümlerde arama yapmayla ilgili sorunlar ele alınmaktadır: birden çok dil:

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

Karakter Kodlama

Sunucular, web sayfaları gibi verileri kullanıcı aracılarına gönderir. kodlanmış bayt dizisi olarak ayarlamanızı sağlar. Ardından kullanıcı aracısı, karakter dizisine dönüştürmenizi sağlar. kullanıyorsanız, hem web hem de trafik için kodlama şemalarını ve aldığınız XML yanıtıyla ilgili güncel bilgileri toplar.

ie istek parametresini kullanarak kodlama mekanizmasını destekler. Şunları yapabilirsiniz: kodlamayı belirtmek için oe parametresini de kullanın Google'ın XML yanıtınızı kodlamak için kullanması gereken şema. Şu durumda: ISO-8859-1 (veya latin1) dışında bir kodlama şeması kullanıyorsanız lütfen doğru değerleri belirttiğinizden emin olun. ie ve oe parametreleri içindir.

Not: Birden fazla kullanıcı için arama işlevi sağlıyorsanız için utf8 (UTF-8) kodlama değerini kullanmanızı öneririz hem ie hem de oe parametreleri için kullanılabilir.

Lütfen Karakter Kodlama Şemaları ekinde yer alan ie ve oe parametreleri için kullanabilirsiniz.

Karakter kodlama 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

hl istek parametresini kullanarak grafik arayüzünüzün dilini belirleyin. hl parametre değeri, XML arama sonuçlarını etkileyebilir. dil kısıtlaması (lr parametresi kullanılarak) açıkça belirtilmediğinde uluslararası sorgulara izin verilir. Böyle bir durumda durumlarda, hl parametresi arama sonuçlarını tanıtabilir kullanıcının giriş diliyle aynı dilde olmalıdır.

hl parametresini açık bir şekilde ayarlamanızı öneririz. Google'ın en yüksek kaliteyi seçmesini sağlamak için arama sonuçlarında arama sonuçları görürsünüz.

Lütfen Desteklenen Arayüz hl parametresine ilişkin geçerli değerlerin tam listesi için Diller bölümüne bakın.

Belirli Dillerde Yazılmış Dokümanları Arama

lr istek parametresini kullanarak arama sonuçlarını, belirli bir veya dil grubuna bağlı kalır.

lr parametresi, aşağıdakileri belirtmenize olanak tanımak için Boole Operatörlerini destekler: aramaya dahil edilmesi (veya hariç tutulması) gereken birden fazla dil sonuç.

Aşağıdaki örneklerde Google Analytics 4'te doküman istemek için Boole Operatörlerini farklı dillerde içerik sunar.

Japonca yazılan 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ış belgeler için:

lr=(-lang_hu).(-lang_cs)

Lütfen Dil Koleksiyonu'na bakın lr parametresi ve Boole Değerlerinin tam listesi için Değerler bölümü Operatörler bölümü ile ilgili kapsamlı bir açıklama işleci.

Basitleştirilmiş ve Geleneksel Çince Arama

Basitleştirilmiş Çince ve Geleneksel Çince iki yazma varyantıdır. bir diğeri. Aynı kavram projede farklı şekilde yazılabilir ekleyin. Varyantlardan birinde bir sorgu verildiğinde Google, WebSearch hizmeti, hem için de geçerlidir.

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, bir sonuç isteğine dahil edeceğiniz sorgu parametreleri gösterilmektedir Basitleştirilmiş ve geleneksel Çince dillerinde desteklenmektedir. ( istemci olarak tanımlanmamıştır.)

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

Sonuçları Filtreleme

Google WebSearch, aramanızı filtrelemek için çeşitli yollar sunar sonuç:

• Otomatik Arama sonuçlarını filtreleme
• Dil ve ülke filtreleme
• Yetişkinlere Uygun İçeriği Filtrelemek için SafeSearch

Arama Sonuçlarını Otomatik Olarak Filtreleme

Google, mümkün olan en iyi arama sonuçlarını sağlama çabasıyla, kullanılan arama sonuçlarını otomatik olarak filtrelemek için istenmeyen olarak değerlendirilir:

• Yinelenen İçerik: Birden fazla doküman aynı bilgilere sahip olacaksanız, söz konusu kümenin yalnızca en alakalı dokümanı dahil edilir.

• Barındırıcı Dışlatma: Web sitenizden çok sayıda arama sonucu veya siteyle ilgili tüm sonuçları göstermeyebilir ya da
  grubunda daha düşük sonuçları göster daha yüksek bir sıralamaya sahip olmalarına neden olabilir.

Tipik arama istekleri için bu filtreleri açık bırakmanızı öneririz çünkü filtreler çoğu aramanın kalitesini önemli ölçüde sonuç. Ancak, filter sorgu parametresini arama isteği.

Dil ve Ülke Filtreleme

Google WebSearch hizmeti, tüm Web belgelerinde geçerlidir. Ana dizin, dil dahil belirli özelliklere göre gruplandırılmış dokümanlar ve menşe ülke bilgilerini sağlamalısınız.

Arama sonuçlarını şu alt koleksiyonlarla sınırlamak için lr ve cr istek parametrelerini kullanabilirsiniz: belirli dillerde yazılmış veya kaynağı tıklayın.

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

. Ayrıca lütfen lr parametresinin tanımını, Belirli Dillerde Yazılmış Dokümanlar ve yerelleştirilebilecek Dil Koleksiyonu Değerleri daha fazlası için lr parametresi değeri olarak kullanılır sonuçları dile göre kısıtlamayla ilgili bilgiler.

Google WebSearch, dokümanda bulunduğu ülkeyi aşağıdakileri analiz ederek belirler:

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

Ayrıca lütfen cr parametresinin tanımına ve Ülke Koleksiyonu'na da bakın Sonuçların ülkesine göre kısıtlanması hakkında daha fazla bilgi için cr parametresi için değer olarak kullanılabilecek değerler kaynak.

Not: Dili birleştirebilirsiniz. değerleri ve ülke değerlerini kullanabilirsiniz. Örneğin, Fransızca ve İngilizce yazılmış belgeler isteyebilirsiniz. Fransa veya Kanada'dan gelen bir e-posta adresi de gönderebilirsiniz. ülkedir. Türkçe yazılmış değildir. lr ve cr parametreleri Boole Operatörlerini destekler.

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

Birçok Google müşterisi, arama sorgularıyla ilgili siteler yetişkinlere uygun içerik barındıran içerikler. Güvenli Arama filtremizi kullanarak, her bir yetişkinlere uygun içerik barındıran arama sonuçları için arama yapar ve bunları çıkarır. Google'ın filtreleri, anahtar kelimeleri, kelime öbeklerini kontrol etmek için özel bir teknoloji kullanır. ve URL'ler. Hiçbir filtre yüzde 100 doğru olmasa da, Güvenli Arama yetişkinlere uygun içeriğin büyük bir çoğunluğunu aramanızdan kaldırın sonuç.

Google, Güvenli Arama'yı mümkün olduğunca güncel ve kapsamlı tutmak için web'i sürekli tarayarak ve web'deki güncellemeleri uygulayarak yardımcı olabilir.

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

Google'ın sonuçlarınızı filtrelerken ne kadar safe sorgu parametresi kullanarak yetişkinlere uygun içerik. Aşağıdaki tabloda, Google'ın Güvenli Arama ayarları ve bu ayarların Ayarlarınız arama sonuçlarınızı etkileyecek:

Güvenli Arama'yı etkinleştirdiyseniz ve rahatsız edici içeriği bulursanız lütfen sitenin URL'sini safesearch@google.com adresine e-posta ile gönderdiğinizde, araştıracaktır.

XML Sonuçları

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

Google XML Sonuçları DTD

Google, her tür için XML biçimini tanımlamak üzere aynı DTD'yi kullanır. arama sonuçları. Etiketlerin ve özelliklerin çoğu, arama türleri. Bununla birlikte, bazı etiketler yalnızca belirli arama türleri. Sonuç olarak, DTD'deki tanımlar daha az bu belgede verilen tanımlardan daha kısıtlayıcı.

Bu dokümanda, DTD'nin alakalı olan yönleri açıklanmaktadır WebSearch için. Veriye Dayalı İlişkilendirme'ye baktığınızda, üzerinde çalıştığınız webSearch'e dahil olmayan etiketleri ve özellikleri burada belgeleyeceğiz. Tanımı DTD ile bu belgede belirtilmektedir.

Google, XML sonuçlarını en son DTD. DTD, arama yöneticilerine yardımcı olmaya yönelik bir rehberdir XML ayrıştırıcıları, Google'ın XML sonuçlarını anlar. Çünkü Google'ın XML biçimi dilbilgisi zaman zaman değişebileceğinden, ayrıştırıcı ile birlikte DTD'yi kullanır.

Ayrıca, XML ayrıştırıcınızı Her arama isteği gönderdiğinizde DTD. Google, DTD'yi günceller ve bu istekler gereksiz gecikme ve bant genişliğine neden olur. gereksinimlerini karşılayın.

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 XML sonuçlarına aşağıdaki satırın eklenmesidir:

<!DOCTYPE GSP SYSTEM "google.dtd">

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

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

XML Yanıtı Hakkında

• Tüm öğe değerleri, görüntülemeye uygun geçerli HTML kodu olmalıdır. aksi takdirde XML etiketi tanımlarında belirtilir.
• Bazı öğe değerleri, öğeden önce HTML olarak kodlanması gereken URL'lerdir gösterilir.
• XML ayrıştırıcınız belgelenmemiş özellikleri ve etiketleri yoksaymalıdır. Bu, uygulamanızın değişiklik yapmadan çalışmaya devam etmesini sağlar XML çıkışına daha fazla özellik ekler.
• Belirli karakterler, XML etiketleridir. XML işlemciniz bu varlıkları tekrar girin. Varlıkları düzgün bir şekilde dönüştürmezseniz tarayıcı örneğin, & karakterini "&amp" olarak değiştirin. XML Standart ifadesi bu karakterleri belgeler; bu karakterler aşağıdaki tabloda yeniden oluşturulmuş:

  Karakter	Tespit Edilemeyen 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	<	&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ğinde 10 sonuç isteniyor (num=10) hakkında (q=socer), bu kelime "futbol" 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. Lütfen unutmayın: XML sonucunda, belirli etiketlerin burada bir kontrol listesi görüntülenir.

<?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 için XML yanıtları her iki istek de aynı XML etiket grubunu kullanır. Bu XML etiketleri aşağıdaki tablolarda açıklanmıştır.

Aşağıdaki XML etiketleri, etiket adına göre alfabetik olarak listelenmiştir ve etiket tanımı, etiketin bir açıklamasını içerir; etiketin XML sonucunda nasıl görüneceğini ve içerik. Etiket başka bir XML etiketinin alt etiketiyse veya etiket kendine ait alt etiketlere veya özelliklere sahip olduğundan, bu bilgiler etiketinin tanım tablosudur.

Google Ads API'sindeki bazı alt etiketlerin yanında belirli simgeler aşağıdaki tanımlar. 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ğinde "maymun" arama terimi hakkında 5 sonuç (num=5) isteniyor (q=maymun).

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, resim arama sorguları için XML yanıtlarında kullanılan ek XML etiketleri gösterilmektedir.

Google Ads API'sindeki bazı alt etiketlerin yanında belirli simgeler aşağıdaki tanımlar. Bu semboller ve anlamları aşağıdaki gibidir: