Dokumentacja interfejsu API w formacie XML

Ta strona odnosi się do wersji XML interfejsu Custom Search JSON API, która jest dostępna wyłącznie dla klientów Google Site Search.

1. Omówienie
2. Format żądań wyszukiwarki niestandardowej
   1. Żądanie ogółem
   2. Wyszukiwane hasła
   3. Parametry żądania
      1. Przykładowe zapytania w internecie
      2. Definicje parametrów zapytań WebSearch
      3. Szukanie zaawansowane
      4. Parametry zapytania zaawansowanego
      5. Specjalne hasła w zapytaniach
      6. Przykładowe zapytania o obraz
      7. Parametry zapytania w wyszukiwarce grafiki
      8. Limity żądań
   4. Prezentacja internacjonalizacji zapytań i wyników
      1. Kodowanie znaków
      2. Języki interfejsu
      3. Wyszukiwanie w języku chińskim tradycyjnym i uproszczonym
   5. Wyniki filtrowania
      1. Automatyczne filtrowanie wyników wyszukiwania
      2. Filtrowanie języka i kraju
      3. Filtrowanie treści dla dorosłych przy użyciu filtra SafeSearch
3. Wyniki dla plików XML
   1. DTD – wyniki XML Google
   2. Informacje o odpowiedzi XML
   3. Wyniki XML dla plików zwykłego, graficznego i Zapytania zaawansowane
      1. Wyszukiwanie zwykłe/zaawansowane: przykładowe zapytanie i wynik XML
      2. Wyszukiwanie zwykłe/zaawansowane: tagi XML
      3. Wyniki XML dla zapytań wyszukiwania grafiki
      4. Wyszukiwarka grafiki: przykładowe zapytanie i wynik XML
      5. Wyszukiwarka grafiki: tagi XML

Omówienie

Usługa Google WebSearch umożliwia korzystanie z wyszukiwarki Google w witrynie klientów wyświetlających wyniki wyszukiwania Google we własnych witrynach. Usługa WebSearch używa prostego protokołu opartego na protokole HTTP do obsługi wyszukiwania wyników. Administratorzy sieci wyszukiwania mają pełną kontrolę nad sposobem żądania wyników wyszukiwania i sposób, w jaki są one przedstawiane użytkownika końcowego. W tym dokumencie opisano szczegóły techniczne w formatach żądań i wyników.

Aby pobrać wyniki wyszukiwania Google, aplikacja wysyła do Google prostego żądania HTTP. Google zwraca wyniki wyszukiwania w formacie XML. . Wyniki w formacie XML umożliwiają dostosowanie sposób wyświetlania wyników wyszukiwania.

Format żądania WebSearch

• Wyślij prośbę Omówienie
• Wyszukiwane hasła
• Parametry żądania
• Przykładowe zapytania w internecie
• Zapytanie internetowe Definicje parametrów
• Przykładowe zapytania o obraz
• Zapytanie graficzne Definicje parametrów
• Szukanie zaawansowane
  
• Szukanie zaawansowane Parametry zapytania
• Specjalne hasła w zapytaniach
• Limity żądań

Żądanie – informacje

Żądanie wyszukiwania Google to standardowe polecenie HTTP GET. it zawiera zbiór parametrów odnoszących się zapytań. Parametry te są zawarte w adresie URL żądania jako nazwa=wartość pary rozdzielone ampersandem (&). Parametry obejmują takie jak wyszukiwane hasło i unikalny identyfikator wyszukiwarki (cx), który określa który wysyła żądanie HTTP. Usługa WebSearch lub Wyszukiwarka grafiki zwraca XML w odpowiedzi na żądania HTTP.

Wyszukiwane hasła

Większość żądań wyszukiwania zawiera co najmniej 1 zapytanie. Wyszukiwane hasło jest wyświetlana jako wartość parametru w żądaniu wyszukiwania.

Wyszukiwane hasła mogą określać kilka typów informacji do filtrowania porządkują wyniki wyszukiwania zwracane przez Google. W zapytaniach można określić:

• Słowa lub wyrażenia do uwzględnienia lub wyklucz
  • Wszystkie słowa w zapytaniu (domyślnie)
  • dokładne wyrażenie zawarte w zapytaniu,
  • Dowolne słowo lub wyrażenie w zapytaniu
• W którym miejscu w dokumencie szukać tagu wyszukiwane hasła
  • W dowolnym miejscu w dokumencie (domyślnie)
  • Tylko w treści dokumentu.
  • Tylko w tytule dokumentu
  • Tylko w adresie URL dokumentu
  • Tylko w linkach w dokumencie
• Ograniczenia dotyczące samych dokumentów
  • Uwzględnianie i wykluczanie dokumentów określonych typów plików (na przykład pliki PDF lub dokumenty Worda)
• specjalne zapytania o adresy URL, które zwracają wyniki informacji o danym adresie URL, zamiast wyszukiwać
  • Zapytania, które zwracają ogólne informacje o adresie URL, takie jak kategoria, fragment lub język usługi Open Directory
  • Zapytania zwracające zestaw stron internetowych z linkami do adresu URL
  • Zapytania, które zwracają zestaw stron internetowych podobnych do danego adresu URL

Domyślna wyszukiwarka

Wartości parametrów zapytania muszą zawierać kody zmiany znaczenia w adresie URL. Pamiętaj, że będzie podstawić znak plusa („+”) w przypadku dowolnych sekwencji odstępów w argumencie wyszukiwanego hasła. Jest to omówione dokładnie w sekcji Zmiana znaczenia adresów URL w tym dokumencie.

Wyszukiwane hasło jest przesyłane do usługi WebSearch za pomocą parametr q. O przykładowe wyszukiwane hasło to:

q=horses+cows+pigs

Domyślnie usługa Google WebSearch zwraca tylko dokumenty, które uwzględnienie wszystkich haseł w zapytaniu.

Parametry żądania

W tej sekcji wymieniono parametry, których można użyć przy tworzeniu do wyszukiwania. Parametry są podzielone na 2 listy. Pierwsza lista zawiera parametry istotne dla wszystkich żądań wyszukiwania. Druga lista zawiera parametry, które to która ma znaczenie tylko w przypadku żądań wyszukiwania zaawansowanego.

Wymagane są 3 parametry żądania:

• Parametr client musi mieć wartość google-csbe.
• Parametr output określa format zwracanych wyników XML; wyniki mogą być zwracane z ciągiem (xml) lub bez odniesienia (xml_no_dtd) do DTD Google. Zalecamy ustawianie tej wartości na xml_no_dtd. Uwaga: jeśli nie określisz tego parametru, wyniki zostaną zwrócone w HTML zamiast XML.
  
• Parametr cx, który reprezentuje unikalną wartość Identyfikator wyszukiwarki.
  

Najczęściej używane parametry żądania inne niż wspomniane powyżej są:

• num – żądana liczba wyników wyszukiwania;
• q – wyszukiwane hasła;
• start – początkowy indeks wyników,

Przykładowe zapytania internetowe

Poniższe przykłady pokazują kilka żądań HTTP WebSearch do pokazują sposoby wykorzystania różnych parametrów zapytania. Definicje w funkcji WebSearch Query podawane są różne parametry Definicje parametrów i zapytanie zaawansowane Parametry w tym dokumencie.

Ta prośba dotyczy pierwszych 10 wyników (start=0&num=10) dla wyszukiwanego hasła „red sox”. (q=red+sox). Zapytanie ma również określa, że wyniki powinny pochodzić z kanadyjskich witryn (cr=countryCA) i muszą być napisane w języku francuskim (lr=lang_fr). Zapytanie określa wartości parametrów client, output, i cx. Wszystkie 3 są wymagane.

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

W tym przykładzie użyto niektórych zapytań wyszukiwania zaawansowanego , aby jeszcze bardziej dostosować zapytanie. Żądanie to używa parametru as_q (as_q=red+sox) zamiast parametru q. Wykorzystuje też as_eq, aby wykluczyć dokumenty zawierające słowo „Yankees”. z wyniki wyszukiwania (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  

Definicje parametrów zapytania w wyszukiwarce Google

    <!DOCTYPE GSP SYSTEM "google.dtd">

Szukanie zaawansowane

Dodatkowe parametry zapytania wymienione pod obrazem odnoszą się do zapytań szukania zaawansowanego. Przy przesyłaniu wyszukiwania zaawansowanego wartości kilku parametrów (np. as_eq, as_epq, as_oq itp.) są uwzględniane w zapytaniu. odpowiednie hasła. Obraz przedstawia stronę Szukanie zaawansowane w Google. Nazwy poszczególnych elementów Parametr szukania zaawansowanego jest zapisany czerwonym tekstem w środku lub obok. pole na stronie, którego dotyczy ten parametr.

Parametry zapytania wyszukiwania zaawansowanego

Specjalne hasła w zapytaniach

Google WebSearch umożliwia stosowanie kilku specjalnych haseł wyszukiwanych w celu dostęp do dodatkowych funkcji wyszukiwarki Google. Te specjalne zapytania powinny być uwzględniane w wartości parametru żądania q. Podobnie jak w przypadku innych zapytań, specjalne hasła zapytania muszą mieć ze zmianą znaczenia w adresie URL. O w specjalnych zapytaniach znajduje się dwukropek (:). Ta postać musi też zawierać kody zmiany znaczenia adresu URL; jego wartość ze zmianą znaczenia w adresie URL to %3A.

Przykładowe zapytania o obraz

Poniższe przykłady pokazują kilka żądań HTTP dotyczących obrazów, które ilustrują sposób użycia różnych parametrów zapytań. Definicje różnych parametrów zapytania można znaleźć w tym dokumencie, w sekcji Definicje parametrów zapytania z obrazem.

W tym żądaniu należy podać 5 pierwszych wyników (start=0&num=5) dla zapytania „małpa” (q=monkey), z typem pliku .png. Zapytanie określa też wartości parametrów client, output i cx, z których wszystkie są wymagane.

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

Parametry zapytania wyszukiwania grafiki

Limity żądań

W tabeli poniżej znajdziesz ograniczenia dotyczące żądań wyszukiwania, które wysyłasz wyślij do Google:

Prezentacja internacjonalizacji zapytań i wyników

Usługa Google WebSearch umożliwia wyszukiwanie dokumentów w wiele języków. Możesz określić kodowanie znaków, które powinno mogą być używane do interpretacji żądania HTTP i do kodowania odpowiedzi XML (korzystając z wyszukiwania ie i oe, ). Możesz też filtrować wyniki, aby uwzględnić tylko dokumenty w określonych językach.

W poniższych sekcjach omówiono problemy związane z wyszukiwaniem w wiele języków:

• Znak Kodowanie
• Języki interfejsu
• chiński uproszczony i tradycyjny Szukaj

Kodowanie znaków

Serwery wysyłają dane, na przykład strony internetowe, do klientów użytkownika, takich jak w postaci sekwencji zakodowanych bajtów. Następnie klient użytkownika dekoduje bajty w sekwencję znaków. Podczas wysyłania żądań do w usłudze WebSearch możesz określić schematy kodowania dla zarówno zapytania i otrzymanej odpowiedzi XML.

Za pomocą parametru żądania ie możesz określić mechanizmu kodowania znaków w żądaniu HTTP. Dostępne opcje użyj też parametru oe, by określić kodowanie. schemat, którego Google ma użyć do kodowania odpowiedzi XML. Jeśli jesteś używając schematu kodowania innego niż ISO-8859-1 (lub latin1), upewnij się, że podajesz prawidłowe wartości dla parametrów ie i oe.

Uwaga: jeśli udostępniasz funkcję wyszukiwania dla wielu języków, zalecamy użycie wartości kodowania utf8 (UTF-8) zarówno dla parametrów ie, jak i oe.

Zapoznaj się z opisem Dodatek do schematów kodowania zawiera pełną listę wartości, które których możesz użyć dla parametrów ie i oe.

Ogólne informacje o kodowaniu znaków znajdziesz na http://www.w3.org/TR/REC-html40/charset.html.

Języki interfejsu

Parametru żądania hl można używać do: określić język Twojego interfejsu graficznego. Wartość parametru hl może mieć wpływ na wyniki wyszukiwania XML, zwłaszcza w przypadku zapytań międzynarodowych, jeśli ograniczenie językowe (za pomocą parametru lr) nie zostało wyraźnie określone. W takim W przypadku niektórych z nich parametr hl może promować wyniki wyszukiwania. w tym samym języku, co język wprowadzania użytkownika.

Sugerujemy wyraźne ustawienie parametru hl w wynikach wyszukiwania, aby mieć pewność, że Google wybiera najwyższą jakość w wynikach wyszukiwania każdego zapytania.

Zobacz obsługiwany interfejs Sekcja Języki, w której znajdziesz pełną listę prawidłowych wartości parametru hl.

Wyszukiwanie dokumentów napisanych w określonych językach

Możesz użyć parametru żądania lr, aby: ogranicz wyniki wyszukiwania do dokumentów napisanych w określonym języku języka lub zestawu języków.

Parametr lr obsługuje operatory logiczne, co pozwala określić wiele języków, które powinny być uwzględnione (lub wykluczone) z wyszukiwania wyników.

Poniższe przykłady pokazują, jak używać operatorów logicznych do wysyłania żądań dokumentów różnych językach.

W przypadku dokumentów napisanych w języku japońskim:

lr=lang_jp

W przypadku dokumentów napisanych w języku włoskim lub niemieckim:

lr=lang_it|lang_de

Dokumenty napisane w języku innym niż węgierski lub czeski:

lr=(-lang_hu).(-lang_cs)

Zobacz kolekcję językową W sekcji Wartości znajdziesz pełną listę możliwych wartości parametru lr oraz wartości logicznej w sekcji Operatorzy, aby w pełni omówić ich użycie .

Wyszukiwanie w uproszczonym i tradycyjnym języku chińskim

chiński uproszczony i chiński tradycyjny to 2 warianty pisma o języku chińskim. To samo zjawisko może być inaczej sformułowane w każdego wariantu. Po uwzględnieniu zapytania w jednym z wariantów operator Google Usługa WebSearch może zwracać wyniki obejmujące strony wersji.

Aby skorzystać z tej funkcji:

1. Ustaw parametr żądania c2coff na 0
   oraz
2. Wykonaj jedną z tych czynności:
   • Nie ustawiaj parametru żądania lr
     lub
   • Ustaw parametr żądania lr na lr=lang_zh-TW|lang_zh-CN.

Poniższy przykład pokazuje parametry zapytania, które można by uwzględnić w żądaniu wyników. zarówno w języku uproszczonym, jak i tradycyjnym. (Pamiętaj, że dodatkowe wymagane informacje, takie jak jako klient).

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

Wyniki filtrowania

Google WebSearch oferuje wiele sposobów filtrowania wyników wyszukiwania wyniki:

• Automatyczne Filtrowanie wyników wyszukiwania
• Filtrowanie języka i kraju
• Filtrowanie treści dla dorosłych za pomocą: SafeSearch

Automatyczne filtrowanie wyników wyszukiwania

Staramy się udostępniać najlepsze możliwe wyniki wyszukiwania, korzysta z dwóch technik, aby automatycznie filtrować wyniki wyszukiwania, które są zwykle uznawane za niepożądane:

• Powielone treści – jeśli wiele dokumentów zawiera informacje, to tylko najtrafniejszy dokument z tego zestawu to w wynikach wyszukiwania.

• Nagromadzenie hostów – jeśli jest wiele wyników wyszukiwania z witryna, Google może nie wyświetlać wszystkich wyników z tej witryny lub pokaż wyniki niżej w:
  w rankingu, niż byłoby to możliwe.

Zalecamy pozostawienie tych filtrów włączone w przypadku typowych żądań wyszukiwania bo filtry znacznie poprawiają jakość wyników. Automatyczne filtry można jednak pominąć, ustawiając parametr zapytania filter na 0 w do wyszukiwania.

Filtrowanie języka i kraju

Usługa Google WebSearch zwraca wyniki z indeksu głównego wszystkich dokumentów internetowych. Indeks główny zawiera podkolekcje obejmujące dokumenty pogrupowane według określonych atrybutów, w tym języka i kraju pochodzenia.

Możesz użyć parametrów żądania lr i cr, aby ograniczyć wyniki wyszukiwania do podkolekcji dokumenty napisane w określonych językach lub pochodzące z poszczególnych krajów.

Google WebSearch określa język dokumentu na podstawie analizy:

• domena najwyższego poziomu (TLD) adresu URL dokumentu,
• metatagi języka w dokumencie
• głównego języka użytego w tekście dokumentu.

Zobacz też definicję parametru lr w sekcji Wyszukiwanie dokumenty napisane w określonych językach i wartości zbioru języków, które można używane jako wartości parametru lr, co pozwala o ograniczaniu wyników na podstawie języka.

Google WebSearch określa kraj dokumentu na podstawie analizy:

• domena najwyższego poziomu (TLD) adresu URL dokumentu,
• położenie geograficzne adresu IP serwera WWW,

Zobacz też definicję parametru cr i zbioru Country Collection Wartości, których można użyć jako wartości parametru cr, aby uzyskać więcej informacji o ograniczaniu wyników według kraju: pochodzeniu danych.

Uwaga: możesz łączyć języki i wartości kraju, aby dostosować wyniki wyszukiwania. Dla: można na przykład wysłać żądanie o dokumenty napisane w języku francuskim, pochodzi z Francji lub Kanady, albo można poprosić o dokumenty pochodzi z Holandii i nie są pisane po angielsku. Parametry lr i cr obsługują operatory logiczne.

Filtrowanie treści dla dorosłych przy użyciu filtra SafeSearch

Wielu klientów Google nie chce wyświetlać wyników wyszukiwania dla hasła witryny które zawierają treści dla dorosłych. Za pomocą filtra SafeSearch możesz w wynikach wyszukiwania treści dla dorosłych i je wyeliminować. Filtry Google wykorzystują zastrzeżoną technologię do sprawdzania słów kluczowych i wyrażeń i adresy URL. Chociaż żaden filtr nie jest skuteczny w 100%, filtr SafeSearch usunąć z wyszukiwania zdecydowaną większość treści dla dorosłych, wyników.

Google dąży do tego, aby filtr SafeSearch był tak aktualny i kompleksowy, jest możliwe dzięki stałemu indeksowaniu sieci i uwzględnianiu aktualizacji na podstawie sugestii użytkowników.

Filtr SafeSearch jest dostępny w tych językach:

Możesz dostosować stopień, w jakim Google filtruje wyniki wyszukiwania treści dla dorosłych przy użyciu parametru zapytania safe. W poniższej tabeli opisano ustawienia filtra SafeSearch i sposób ich działania. wpłyną na wyniki wyszukiwania:

Jeśli włączony jest filtr SafeSearch i znajdujesz witryny zawierające obraźliwe treści w wynikach, wyślij e-maila z adresem URL strony na adres safesearch@google.com, a my zajmie się sprawą.

Wyniki XML

• Kod XML firmy Google Wyniki DTD
• Informacje o odpowiedzi XML
• XML Wyniki dla zwykłych i zaawansowanych zapytań
• Wyszukiwanie zwykłe/zaawansowane: przykładowe zapytanie i wynik XML
• Wyszukiwanie zwykłe/zaawansowane: tagi XML

Wyniki XML w Google – DTD

Google używa tego samego parametru DTD do opisania formatu XML dla wszystkich typów w wynikach wyszukiwania. Wiele tagów i atrybutów ma zastosowanie do wszystkich typów wyszukiwania. Niektóre tagi mają zastosowanie tylko do określonych typów wyszukiwania. W związku z tym definicje w DTD mogą być mniej bardziej restrykcyjne niż definicje podane w tym dokumencie.

Ten dokument opisuje te aspekty DTD, które są istotne dla WebSearch. Patrząc na kanał DTD, WebSearch, możesz bezpiecznie ignorować tagi i atrybuty, które nie są tutaj udokumentowaliśmy. Jeśli definicja różni się między DTD i dokumentacja, jest to wyszczególnione w tym dokumencie.

Google może zwracać wyniki XML z odniesieniem do lub bez niego najnowszego danych DTD. DTD to przewodnik, który pomaga administratorom wyszukiwania i parsery XML interpretują wyniki XML w Google. Ponieważ kod XML firmy Google może od czasu do czasu ulegać zmianie, nie należy konfigurować do sprawdzania poprawności każdego wyniku XML za pomocą DTD.

Ponadto nie należy konfigurować parsera XML do pobierania DTD za każdym razem, gdy przesyłasz żądanie wyszukiwania. Google aktualizuje dane DTD niezbyt często, a te żądania generują niepotrzebne opóźnienia i przepustowość .

W celu uzyskania wyników XML zalecamy używanie formatu wyjściowego xml_no_dtd. Jeśli w żądaniu wyszukiwania określisz format output xml, Jedyną różnicą jest uwzględnienie tego wiersza w wynikach XML:

<!DOCTYPE GSP SYSTEM "google.dtd">

Najnowszą wersję DTD znajdziesz na http://www.google.com/google.dtd.

Pamiętaj, że nie wszystkie funkcje DTD mogą być obecnie dostępne lub obsługiwane.

Informacje o odpowiedzi XML

• Wszystkie wartości elementów to prawidłowy kod HTML odpowiedni do wyświetlania, chyba że co nie zostało wymienione w definicjach tagów XML.
• Niektóre wartości elementów to adresy URL, które muszą zostać wcześniej zakodowane w języku HTML w których są wyświetlane.
• Parser XML powinien ignorować nieudokumentowane atrybuty i tagi. Dzięki temu aplikacja może kontynuować pracę bez modyfikacji jeśli Google doda do danych wyjściowych XML więcej funkcji.
• Konieczna jest zmiana znaczenia niektórych znaków, gdy są one zawarte w wartościach Tagi XML. Procesor XML powinien przekonwertować te encje z powrotem na odpowiednie znaki. Jeśli nie przekonwertujesz elementów prawidłowo, przeglądarka może na przykład renderować kod & jako „&”. Metoda XML Standard dokumentuje te znaki; Te postacie są powtórzono w tabeli poniżej:

  Znak	Formularze Escape	Jednostka	Kod znaku
  Znak &	&	&	&
  Pojedynczy cudzysłów	'	'	'
  Podwójny cudzysłów	"	"	"
  Większe niż	>	>	\62
  Mniejsze niż	<	&lt;	\60

Wyniki XML dla zwykłych i zaawansowanych zapytań

Wyszukiwanie standardowe/zaawansowane: przykładowe zapytanie i wynik XML

To przykładowe żądanie WebSearch wymaga podania 10 wyników (num=10) o wyszukiwaniu hasła „socer” (q=socer), czyli słowo „piłka nożna” w tym przykładzie celowo niepoprawnie napisany).

http://www.google.com/search?
    q=socer
    &hl=en
    &start=10
    &num=10
    &output=xml
    &client=google-csbe
    &cx=00255077836266642015:u-scht7a-8i 

To żądanie zwraca poniższy wynik XML. Pamiętaj, że niektóre z nich kilka komentarzy w wyniku XML, wskazując, gdzie określone tagi nie w wynikach.

<?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>

Wyszukiwanie standardowe/zaawansowane: tagi XML

Odpowiedzi XML dla zwykłych żądań wyszukiwania i wyszukiwania zaawansowanego korzystają z tego samego zestawu tagów XML. Te tagi XML są wyświetlane w w powyższym przykładzie w formacie XML, który został opisany w tabelach poniżej.

Poniższe tagi XML są wymienione alfabetycznie według nazwy tagu. Definicja tagu zawiera opis tagu, jak będzie wyglądać w wyniku XML oraz jaki będzie format tagu treści. Jeśli tag jest tagiem podrzędnym innego tagu XML lub jeśli tag zawiera subtagów lub atrybutów, te informacje są również podane tabeli definicji tagu.

Obok niektórych subtagów w sekcji podane niżej definicje. Znajdziesz je poniżej wraz z informacją o znaczeniu.

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

Wyniki XML dla zapytań w wyszukiwarce grafiki

W tym przykładowym żądaniu grafiki należy podać 5 wyników (num=5) dotyczących wyszukiwanego hasła „małpa” (q=małpa).

http://www.google.com/cse?
  searchtype=image
  &num=2
  &q=monkey
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

To żądanie zwraca poniższy wynik XML.

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

Wyszukiwarka grafiki: tagi XML

W tabeli poniżej znajdziesz dodatkowe tagi XML używane w odpowiedziach XML dla zapytań wyszukiwania grafiki.

Obok niektórych subtagów w sekcji podane niżej definicje. Znajdziesz je poniżej wraz z informacją o znaczeniu.