Dokumentacja interfejsu API w formacie XML

Ta strona dotyczy wersji XML interfejsu Custom Search JSON API, który jest dostępny tylko dla klientów Google Site Search.

  1. Omówienie
  2. Format żądań wyszukiwarki niestandardowej
    1. Omówienie prośby
    2. Wyszukiwane hasła
    3. Parametry żądania
      1. Przykładowe zapytania w WebSearch
      2. Definicje parametrów zapytań WebSearch
      3. Szukanie zaawansowane
      4. Parametry wyszukiwania zaawansowanego
      5. Specjalne warunki zapytania
      6. Przykładowe zapytania dotyczące obrazów
      7. Parametry zapytania dotyczącego wyszukiwania 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 (uproszczonym i tradycyjnym)
    5. Filtrowanie wyników
      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 w formacie XML
    1. DTD z wyników XML Google
    2. Informacje o odpowiedzi XML
    3. Wyniki XML dla zapytań zwykłych, graficznych i zaawansowanych
      1. Wyszukiwanie regularne/zaawansowane: przykładowe zapytanie i wynik XML
      2. Wyszukiwanie regularne/zaawansowane: tagi XML
      3. Wyniki XML dla zapytań graficznych
      4. Wyszukiwarka grafiki: przykładowe zapytanie i wynik XML
      5. Wyszukiwarka grafiki: tagi XML

Opis

Usługa Google WebSearch umożliwia klientom Wyszukiwarki Google w witrynie wyświetlanie wyników wyszukiwania Google we własnych witrynach. Do wyświetlania wyników wyszukiwania usługa WebSearch używa prostego protokołu HTTP. Administratorzy wyszukiwarki mają pełną kontrolę nad sposobem żądania wyników wyszukiwania oraz nad sposobem ich prezentowania użytkownikowi. W tym dokumencie znajdziesz szczegóły techniczne dotyczące żądań wyszukiwania w Google i formatów wyników.

Aby pobrać wyniki wyszukiwania Google, aplikacja wysyła do Google proste żądanie HTTP. Następnie Google zwraca wyniki wyszukiwania w formacie XML. Wyniki w formacie XML umożliwiają dostosowanie sposobu ich wyświetlania.

Format żądania WebSearch

Żądanie – informacje

Żądanie wyszukiwarki Google to standardowe polecenie HTTP GET. Zawiera zbiór parametrów odpowiednich dla Twoich zapytań. Te parametry są umieszczane w adresie URL żądania w postaci par nazwa=wartość rozdzielonych znakami „&”. Parametry obejmują takie dane jak wyszukiwane hasło i unikalny identyfikator wyszukiwarki (cx), który identyfikuje wyszukiwarkę wysyłającą żądanie HTTP. Usługa WebSearch lub Wyszukiwarka obrazów zwraca wyniki XML w odpowiedzi na żądania HTTP.

Wyszukiwane hasła

Większość żądań wyszukiwania zawiera co najmniej 1 wyszukiwane hasło. Wyszukiwane hasło pojawia się jako wartość parametru w żądaniu wyszukiwania.

Zapytania mogą określać kilka typów informacji, które mają służyć do filtrowania i porządkowania wyników wyszukiwania zwracanych przez Google. Zapytania mogą określać:

  • Słowa lub wyrażenia do uwzględnienia lub wykluczenia
    • Wszystkie słowa w zapytaniu (domyślnie)
    • Dokładne wyrażenie w wyszukiwanym haśle
    • Dowolne słowo lub wyrażenie w zapytaniu
  • W którym miejscu dokumentu możesz wyszukać 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 lub wykluczanie dokumentów określonych typów plików (np. plików PDF lub dokumentów Worda)
  • Specjalne zapytania pod adresem URL, które zwracają informacje o danym adresie URL, a nie przeprowadzają wyszukiwanie.
    • Zapytania, które zwracają ogólne informacje o adresie URL, takie jak kategoria, fragment czy język
    • Zapytania, które zwracają zestaw stron internetowych zawierających linki do określonego 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 adresu URL. Pamiętaj, że znak plusa („+”) musisz zastąpić znakiem plusa („+”) w każdej sekwencji odstępów w zapytaniu. Jest to dokładniej omówione w sekcji Zmiana znaczenia adresu URL w tym dokumencie.

Wyszukiwane hasło jest przesyłane do usługi WebSearch za pomocą parametru q. Przykładowe wyszukiwane hasło:

q=horses+cows+pigs

Domyślnie usługa Google WebSearch zwraca tylko te dokumenty, które zawierają wszystkie terminy w zapytaniu.

Parametry żądania

W tej sekcji znajdziesz parametry, których możesz używać podczas tworzenia żądania wyszukiwania. Parametry zostaną podzielone na 2 listy. Pierwsza lista zawiera parametry dotyczące wszystkich żądań wyszukiwania. Druga lista zawiera parametry, które mają zastosowanie tylko do żądań wyszukiwania zaawansowanego.

Wymagane są 3 parametry żądania:

  • Parametr client musi być ustawiony na google-csbe
  • Parametr output określa format zwracanych wyników XML. Wyniki mogą być zwracane z odwołaniem do pliku DTD Google lub bez niego (xml_no_dtd). Zalecamy ustawienie tej wartości na xml_no_dtd. Uwaga: jeśli nie określisz tego parametru, wyniki będą zwracane w formacie HTML, a nie XML.
  • Parametr cx, który reprezentuje unikalny identyfikator wyszukiwarki.

Najczęściej używane parametry żądania inne niż wymienione powyżej to:

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

Przykładowe zapytania w internecie

Poniższe przykłady pokazują kilka żądań HTTP WebSearch, aby pokazać, jak używane są różne parametry zapytania. Definicje różnych parametrów zapytania znajdziesz w tym dokumencie w sekcjach Definicje parametrów zapytań WebSearch i Parametry zapytania zaawansowanego.

To żądanie zawiera pierwsze 10 wyników (start=0&num=10) dla wyszukiwanego hasła „red sox” (q=red+sox). Zapytanie określa też, że wyniki powinny pochodzić z kanadyjskich witryn (cr=countryCA) i powinien być napisany w języku francuskim (lr=lang_fr). Na koniec zapytanie określa wartości parametrów client, output i cx, które 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 parametrów zapytania wyszukiwania zaawansowanego, aby jeszcze bardziej dostosować zapytanie. To żądanie używa parametru as_q (as_q=red+sox) zamiast parametru q. Używa też parametru as_eq, aby wykluczać z wyników wyszukiwania wszystkie dokumenty zawierające słowo „Yankees” (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 zapytań WebSearch

c2coff
Opis

Opcjonalnie. Parametr c2coff włącza lub wyłącza funkcję wyszukiwania w języku chińskim tradycyjnym i uproszczonym.

Domyślna wartość tego parametru to 0 (zero), co oznacza, że funkcja jest włączona. Wartości parametru c2coff:

Wartość Działanie
1 Wyłączono
0 Włączono
Przykłady q=google&c2coff=1

client
Opis

Wymagany. Parametr client musi być ustawiony na wartość google-csbe.
Przykłady q=google&client=google-csbe

cr
Opis

Opcjonalnie. Parametr cr ogranicza wyniki wyszukiwania do dokumentów pochodzących z danego kraju. W wartości parametru cr możesz użyć operatorów logicznych.

Google WebSearch określa kraj dokumentu na podstawie analizy:

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

Listę prawidłowych wartości tego parametru znajdziesz w sekcji Wartości parametru kraju (cr).
Przykłady q=Frodo&cr=countryNZ

cx
Opis

Wymagany. Parametr cx określa unikalny kod identyfikujący Twoją wyszukiwarkę. Aby pobierać z niej wyniki wyszukiwania, musisz określić Wyszukiwarka niestandardowa za pomocą parametru cx.

Aby sprawdzić wartość parametru cx, w wyszukiwarce otwórz Panel sterowania > kartę Kody. Znajdziesz ją w polu tekstowym w sekcji „Wklej ten kod w miejscu na stronie, na której ma być wyświetlane pole wyszukiwania”. Wyniki wyszukiwania będą wyświetlane na stronie hostowanej przez Google.
Przykłady q=Frodo&cx=00255077836266642015:u-scht7a-8i

filter
Opis

Opcjonalnie. Parametr filtr aktywuje lub wyłącza automatyczne filtrowanie wyników wyszukiwania Google. Więcej informacji o filtrach wyników wyszukiwania Google znajdziesz w sekcji Automatyczne filtrowanie w tym dokumencie.

Domyślna wartość parametru filter to 1. Oznacza ona, że funkcja jest włączona. Prawidłowe wartości tego parametru to:

Wartość Działanie
1 Wyłączono
0 Włączono

Uwaga: domyślnie Google stosuje filtrowanie do wszystkich wyników wyszukiwania, aby poprawić ich jakość.
Przykłady q=google&filter=0

gl
Opis

Opcjonalnie. Wartość parametru gl to dwuliterowy kod kraju. W przypadku wyników wyszukiwania WebSearch parametr gl zwiększa wyniki wyszukiwania, których kraj pochodzenia jest zgodny z wartością parametru. Listę prawidłowych wartości znajdziesz w sekcji Kody krajów.

Określenie wartości parametru gl w żądaniach WebSearch powinno zwiększyć trafność wyników. Dotyczy to zwłaszcza klientów międzynarodowych, a w szczególności klientów z krajów anglojęzycznych poza Stanami Zjednoczonymi.
Przykłady

To żądanie zwiększa liczbę dokumentów napisanych w Wielkiej Brytanii w wynikach wyszukiwania WebSearch:
q=pizza&gl=uk

hl
Opis

Opcjonalnie. Parametr hl określa język interfejsu (język hosta). Jeśli chcesz zwiększyć skuteczność i jakość wyników wyszukiwania, zdecydowanie zalecamy wyraźne ustawienie tego parametru.

Więcej informacji znajdziesz w sekcji Języki interfejsu w artykule Internacjonalizacja zapytań i wyników, a lista obsługiwanych języków znajdziesz w sekcji Obsługiwane języki interfejsu.
Przykłady

To żądanie jest kierowane na reklamy wina w języku francuskim. (Vin to francuska nazwa wina).

q=vin&ip=10.10.10.10&ad=w5&hl=fr

w wysokiej rozdzielczości
Opis

Opcjonalnie. Parametr hq dołącza określone hasła do zapytania w taki sposób, jakby zostały połączone z operatorem logicznym AND.

Przykłady

Wynikiem wyszukiwania jest „pizza” ORAZ „ser”. Wyrażenie jest takie samo jak q=pizza+cheese.

q=pizza&hq=cheese

ie
Opis

Opcjonalnie. Parametr ie określa schemat kodowania znaków, który powinien być używany do interpretacji ciągu zapytania. Domyślną wartością ie jest latin1.

W sekcji Kodowanie znaków znajdziesz informacje o tym, kiedy warto używać tego parametru.

Listę możliwych wartości ie znajdziesz w sekcji Schematy kodowania znaków.
Przykłady q=google&ie=utf8&oe=utf8
lr
Opis

Opcjonalnie. Parametr lr (ograniczenie języka) ogranicza wyniki wyszukiwania do dokumentów napisanych w danym języku.

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

  • domeny najwyższego poziomu (TLD) adresu URL dokumentu,
  • metatagów języka w dokumencie
  • głównego języka użytego w tekście dokumentu.
  • ewentualne języki dodatkowe, które są używane w tekście dokumentu;

Listę prawidłowych wartości tego parametru znajdziesz w sekcji Wartości zbierania danych języka (lr).
Przykłady q=Frodo&lr=lang_en

num
Opis

Opcjonalnie. Parametr num określa liczbę wyników wyszukiwania do zwrócenia.

Domyślna wartość num to 10, a maksymalna – 20. Jeśli poprosisz o więcej niż 20 wyników, zostanie zwróconych tylko 20.

Uwaga: jeśli łączna liczba wyników wyszukiwania jest mniejsza od wymaganej, zwracane są wszystkie dostępne wyniki wyszukiwania.
Przykłady q=google&num=10

oe
Opis

Opcjonalnie. Parametr oe określa schemat kodowania znaków, którego należy użyć do zdekodowania wyniku XML. Domyślną wartością oe jest latin1.

W sekcji Kodowanie znaków znajdziesz informacje o tym, kiedy warto używać tego parametru.

Listę możliwych wartości oe znajdziesz w sekcji Schematy kodowania znaków.
Przykłady q=google&ie=utf8&oe=utf8

wynik
Opis

Wymagany. Parametr output określa format wyników XML. Jedyne prawidłowe wartości tego parametru to xml i xml_no_dtd. W tabeli poniżej objaśniamy różnice między tymi wartościami.

Wartość Format wyjściowy
xml_no_dtd Wyniki XML nie będą zawierać instrukcji !DOCTYPE. (Zalecana czynność)
xml Wyniki XML będą zawierać odwołanie do DTD Google. Drugi wiersz wyniku określa typ definicji dokumentu (DTD), który jest używany w wynikach: 
    <!DOCTYPE GSP SYSTEM "google.dtd">
Przykłady output=xml_no_dtd
output=xml

q
Opis

Opcjonalnie. Parametr q określa zapytanie wpisane przez użytkownika. Mimo że ten parametr jest opcjonalny, musisz podać wartość co najmniej jednego z parametrów zapytania (as_epq, as_lq, as_oq lub as_q), aby uzyskać wyniki wyszukiwania.

Jest też wiele specjalnych zapytań, których możesz użyć jako części wartości parametru q. Lista i definicje tych terminów znajdziesz w sekcji Specjalne warunki zapytania.

Panel sterowania wyszukiwarki Google zawiera raport o najczęstszych zapytaniach przesyłanych z wykorzystaniem parametru q.

Uwaga: wartość parametru q musi zawierać zmianę znaczenia w adresie URL.
Przykłady q=vacation&as_oq=london+paris

bezpieczeństwo
Opis

Opcjonalnie. Parametr safe wskazuje sposób filtrowania wyników wyszukiwania pod kątem treści pornograficznych i dla dorosłych. Wartość domyślna parametru safe to off. Prawidłowe wartości parametrów:

Wartość Działanie
off Wyłącz filtr SafeSearch
medium Włącz filtr SafeSearch
high Włącz bardziej rygorystyczną wersję filtra SafeSearch

Więcej informacji o tej funkcji znajdziesz w sekcji Filtrowanie treści dla dorosłych przy użyciu filtra SafeSearch.
Przykłady q=adult&safe=high

start
Opis

Opcjonalnie. Parametr start wskazuje pierwszy pasujący wynik, który powinien zostać uwzględniony w wynikach wyszukiwania. Parametr start używa indeksu liczonego od zera, co oznacza, że pierwszy wynik to 0, drugi to 1 itd.

Parametr start w połączeniu z parametrem num określa, które wyniki wyszukiwania należy zwrócić. Pamiętaj, że dla każdego zapytania zostanie zwróconych maksymalnie 1000 wyników, nawet jeśli do zapytania pasuje więcej niż 1000 dokumentów. Dlatego przy ustawieniu wartości co najmniej 1000 nie otrzymasz żadnych wyników.
Przykłady start=10

sortuj
Opis

Opcjonalnie. Parametr sort określa, że wyniki są sortowane według podanego wyrażenia. na przykład według daty.
Przykłady

sort=date

ud
Opis

Opcjonalnie. Parametr ud wskazuje, czy odpowiedź XML powinna zawierać adres URL zakodowany w formacie IDN. Kodowanie IDN (International Domains Name) umożliwia wyświetlanie domen z użyciem języków lokalnych, na przykład:

http://www.花井鮨.com

Prawidłowe wartości tego parametru to 1 (domyślnie), co oznacza, że wynik XML powinien zawierać adresy URL zakodowane w IDN oraz 0 – wynik XML nie powinien zawierać adresów URL zakodowanych w IDN. Jeśli parametr ud ma wartość 1, adres URL zakodowany w IDN pojawi się w tagu UD w wynikach XML.

Jeśli parametr ud ma wartość 0, adres URL w przykładzie powyżej będzie wyglądał tak:

http://www.xn--elq438j.com.

Uwaga: jest to funkcja w wersji beta.
Przykłady q=google&ud=1

Dodatkowe parametry zapytania wymienione pod obrazem mają zastosowanie do zapytań zaawansowanych. Gdy przesyłasz wyszukiwanie zaawansowane, w wyszukiwanych hasłach uwzględniane są wartości kilku parametrów (np. as_eq, as_epq, as_oq itp.). Obraz pokazujący stronę Szukanie zaawansowane Google Na obrazie nazwa każdego parametru szukania zaawansowanego jest zapisana red tekstem w polu na stronie, którego dotyczy dany parametr, lub obok niego.



Parametry zapytania wyszukiwania zaawansowanego

as_dt
Opis

Opcjonalnie. Parametr as_dt określa, czy mają być uwzględniane czy wykluczane wyniki z witryny wymienionej w parametrze as_sitesearch. Wartości i i e oznaczają odpowiednio uwzględnienie i wykluczenie.
Przykłady as_dt=i,as_dt=e

as_epq
Opis

Opcjonalnie. Parametr as_epq wskazuje wyrażenie, które muszą zawierać wszystkie dokumenty w wynikach wyszukiwania. Aby wyszukać wyrażenie, możesz też użyć wyszukiwania wyrażenia.
Przykłady as_epq=abraham+lincoln

as_eq
Opis

Opcjonalnie. Parametr as_eq określa słowo lub wyrażenie, które nie powinno występować w żadnym dokumencie w wynikach wyszukiwania. Możesz też użyć funkcji wykluczania, aby dane słowo lub wyrażenie nie występowało w dokumencie wśród wyników wyszukiwania.
Przykłady

q=bass&as_eq=music.

as_lq
Opis

Opcjonalnie. Parametr as_lq wskazuje, że wszystkie wyniki wyszukiwania powinny zawierać link do określonego adresu URL. W przypadku tego typu zapytania możesz też użyć hasła link:.

Przykłady

as_lq=www.google.com

as_nlo
Opis

Opcjonalnie. Parametr as_nlo określa wartość początkową zakresu wyszukiwania. Użyj funkcji as_nlo i as_nhi, aby dołączyć do zapytania zakres wyszukiwania obejmujący as_nlo...as_nhi.

Przykłady

Ta opcja ustawia zakres wyszukiwania od 5 do 10 włącznie:

as_nlo=5&as_nhi=10
as_nhi
Opis

Opcjonalnie. Parametr as_nhi określa wartość końcową zakresu wyszukiwania. Użyj funkcji as_nlo i as_nhi, aby dołączyć do zapytania zakres wyszukiwania obejmujący as_nlo...as_nhi.
Przykłady

Ta opcja ustawia zakres wyszukiwania od 5 do 10 włącznie:

as_nlo=5&as_nhi=10
as_oq
Opis

Opcjonalnie. Parametr as_oq zawiera dodatkowe wyszukiwane hasła do sprawdzenia w dokumencie. Każdy dokument w wynikach wyszukiwania musi zawierać co najmniej 1 z dodatkowych wyszukiwanych haseł. Na potrzeby tego typu zapytania możesz też użyć hasła logicznego LUB.
Przykłady

q=vacation&as_oq=London+Paris

as_q
Opis

Opcjonalnie. Parametr as_q zawiera wyszukiwane hasła, które należy sprawdzić w dokumencie. Ten parametr jest też często używany do określania przez użytkowników dodatkowych haseł do wyszukania w zbiorze wyników wyszukiwania.
Przykłady

q=president&as_q=John+Adams

as_qdr
Opis

Opcjonalnie. Parametr as_qdr wysyła żądanie wyszukiwania z wybranego okresu (krótkiego zakresu dat). Dostępne wartości:

d[number] prosi o wyniki z określonej liczby ostatnich dni.
w[number] żądań wyników z określonej liczby poprzednich tygodni.
m[number] prosi o wyniki z określonej liczby ostatnich miesięcy.
y[number] żądań wyników z określonej liczby ubiegłych lat.
Przykłady

W tym przykładzie prosimy o wyniki z ubiegłego roku:

as_qdr=y

W tym przykładzie prosimy o wyniki z ostatnich 10 dni:

as_qdr=d10
as_sitesearch
Opis

Opcjonalnie. Parametr as_sitesearch pozwala określić, że wszystkie wyniki wyszukiwania powinny pochodzić ze stron danej witryny. Dzięki ustawieniu parametru as_dt możesz też używać go do wykluczania stron z danej witryny z listy wyników wyszukiwania.
Przykłady

q=vacation&as_sitesearch=www.google.com

Specjalne wyszukiwane hasła

Google WebSearch umożliwia stosowanie kilku specjalnych haseł w zapytaniach, które zapewniają dostęp do dodatkowych możliwości wyszukiwarki Google. Te specjalne hasła zapytania powinny być uwzględnione w wartości parametru żądania q. Podobnie jak w przypadku innych haseł, specjalne hasła zapytania muszą zawierać kod zmiany znaczenia w adresie URL. Liczba specjalnych haseł w zapytaniu zawiera dwukropek (:). Ten znak musi też zawierać kod zmiany znaczenia adresu URL, a jego wartość to %3A.

Linki wsteczne [link:]
Opis

Wyszukiwane hasło link: pobiera zestaw stron internetowych, które zawierają linki do określonego adresu URL. Zapytanie powinno mieć format link:URL bez spacji między hasłem link: a adresem URL.

Wersja elementu link: ze zmianą znaczenia adresu URL to link%3A.

Możesz też użyć parametru żądania as_lq, by przesłać żądanie link:.

Uwaga: gdy używasz link:, nie możesz określać innych zapytań.
Przykłady

http://www.google.com/search?q=link%3Awww.example.com

Wartość logiczna LUB wyszukiwanie [LUB ]
Opis

Wyszukiwane hasło OR pobiera dokumenty zawierające 1 z serii (2 lub więcej) haseł. Aby użyć wyszukiwanego hasła OR, musisz wstawić wyszukiwane hasło OR wielkimi literami między poszczególne hasła w serii.

Możesz też użyć parametru żądania as_oq, aby wyszukać dowolne hasło w zestawie.

Uwaga: jeśli w żądaniu wyszukiwania pojawi się zapytanie „London+LUB+Paryż”, w wynikach wyszukiwania pojawią się dokumenty zawierające co najmniej 1 z tych słów. W niektórych przypadkach dokumenty w wynikach wyszukiwania mogą zawierać oba te słowa.
Przykłady

Wyszukaj Londyn lub Paryż:

Dane wejściowe użytkownika:london OR paris Hasło zapytania:q=london+OR+paris

Wyszukaj wakacje i Londyn albo Paryż:

Wyszukiwane hasło:q=vacation+london+OR+paris

Wyszukaj wakacje i jedno z Londynu, Paryża lub czekoladki:

Wyszukiwane hasło:  q=vacation+london+OR+paris+OR+chocolates

Wyszukaj hasła „wakacje” i czekoladki, a także hasła „Londyn” lub „Paryż”, przy czym najmniejsza waga jest przypisana do czekolady:

Wyszukiwane hasło:  q=vacation+london+OR+paris+chocolates

Wyszukaj wakacje, czekoladki i kwiaty w dokumentach, które zawierają też „Londyn” lub „Paryż”:

Wyszukiwane hasło:  q=vacation+london+OR+paris+chocolates+flowers

Wyszukaj wakacje, Londyn albo Paryż, a także czekoladki lub kwiaty:

Wyszukiwane hasło:  q=vacation+london+OR+paris+chocolates+OR+flowers

Wyklucz hasło zapytania [-]
Opis

Zapytanie wykluczające (-) ogranicza wyniki konkretnego żądania do dokumentów, które nie zawierają określonego słowa lub wyrażenia. Aby użyć wykluczającego zapytania, przed słowem lub wyrażeniem, które ma zostać wykluczone z pasujących dokumentów, musisz poprzedzić słowo lub wyrażenie znakiem minusa.

Wersja elementu - ze zmianą znaczenia adresu URL to %2D.

Hasło wykluczające jest przydatne, gdy wyszukiwane hasło ma więcej niż 1 znaczenie. Na przykład słowo „bas” może zwrócić wyniki dotyczące ryb lub muzyki. Jeśli szukasz dokumentów o rybach, możesz wykluczyć je z wyników wyszukiwania, używając wyszukiwanego hasła.

Możesz też użyć parametru żądania as_eq, aby wykluczyć z wyników wyszukiwania dokumenty pasujące do określonego słowa lub wyrażenia.
Przykłady Dane wejściowe użytkownika: bass -music
Wyszukiwane hasło: q=bass+%2Dmusic

Wykluczenie typu pliku [ -filetype: ]
Opis

Zapytanie -filetype: wyklucza z wyników wyszukiwania dokumenty o konkretnym rozszerzeniu plików, np. „.pdf” lub „.doc”. Zapytanie powinno mieć format -filetype:EXTENSION bez spacji między wyszukiwanym hasłem -filetype: a podanym rozszerzeniem.

Wersja elementu -filetype: ze zmianą znaczenia adresu URL to %2Dfiletype%3A.

Uwaga: możesz wykluczyć z wyników wyszukiwania wiele typów plików, dodając do zapytania więcej haseł (-filetype:). W zapytaniu musisz podać 1 hasło -filetype: dla każdego rozszerzenia pliku, które powinno zostać wykluczone z wyników wyszukiwania.

Typy plików obsługiwane przez Google:

  • Adobe Portable Document Format (pdf)
  • Adobe PostScript (ps)
  • Lotos 1-2-3 (tydz.1, tydz., 3, tydz.4, tydz.5, wki, tydz., wku)
  • Lotos WordPro (LWP)
  • Macwrite (MW)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt),
  • Microsoft Word (dokument)
  • Microsoft Works (wks, wps, wdb)
  • Microsoft zapisu (wri)
  • Tekst sformatowany RTF (rtf)
  • Shockwave Flash (swf)
  • Tekst (ans, txt).

W przyszłości możemy dodać więcej typów plików. Aktualną listę funkcji możesz zawsze znaleźć w artykule Google dotyczącym najczęstszych pytań dotyczących typów plików.
Przykłady

W tym przykładzie zwracamy dokumenty zawierające słowo „Google”, które nie są dokumentami PDF:
q=Google+%2Dfiletype%3Apdf

W tym przykładzie zwracamy dokumenty zawierające słowo „Google”, ale z wykluczeniem dokumentów PDF i Word:
q=Google+%2Dfiletype%3Apdf+%2Dfiletype%3Adoc

Filtrowanie typu pliku [ filetype: ]
Opis

Zapytanie filetype: ogranicza wyniki wyszukiwania do dokumentów z określonym rozszerzeniem plików, takim jak „.pdf” lub „.doc”. Zapytanie powinno mieć format filetype:EXTENSION bez spacji między wyszukiwanym hasłem filetype: a określonym rozszerzeniem.

Wersja elementu filetype: ze zmianą znaczenia adresu URL to filetype%3A.

Możesz ograniczyć wyniki wyszukiwania do dokumentów pasujących do jednego z kilku rozszerzeń plików, dodając do zapytania więcej haseł filetype:. W zapytaniu powinny występować jedno wyszukiwane hasło filetype: dla każdego rozszerzenia pliku, które powinno znaleźć się w wynikach wyszukiwania. Kolejne wyszukiwane hasła filetype: należy rozdzielić przy użyciu hasła OR.

Domyślnie wyniki wyszukiwania obejmują dokumenty z każdym rozszerzeniem.

Typy plików obsługiwane przez Google:

  • Adobe Portable Document Format (pdf)
  • Adobe PostScript (ps)
  • Lotos 1-2-3 (tydz.1, tydz., 3, tydz.4, tydz.5, wki, tydz., wku)
  • Lotos WordPro (LWP)
  • Macwrite (MW)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt),
  • Microsoft Word (dokument)
  • Microsoft Works (wks, wps, wdb)
  • Microsoft zapisu (wri)
  • Tekst sformatowany RTF (rtf)
  • Shockwave Flash (swf)
  • Tekst (ans, txt).

W przyszłości możemy dodać więcej typów plików. Aktualną listę funkcji możesz zawsze znaleźć w artykule Google dotyczącym najczęstszych pytań dotyczących typów plików.
Przykłady

Ten przykład zwraca dokumenty PDF zawierające słowo „Google”:
q=Google+filetype%3Apdf

W tym przykładzie zwracamy dokumenty PDF i Word, które zawierają słowo „Google”:
q=Google+filetype%3Apdf+OR+filetype%3Adoc

Uwzględnij hasło zapytania [+]
Opis

Operator zapytania „include” (+) określa, że dane słowo lub wyrażenie musi występować we wszystkich dokumentach uwzględnionych w wynikach wyszukiwania. Aby użyć takiego zapytania, przed słowem lub wyrażeniem, które musi występować we wszystkich wynikach wyszukiwania, dodaj znak „+” (znak plusa).

Wersja + (znak plusa) ze zmianą znaczenia adresu URL to %2B.

Należy użyć znaku + przed popularnym słowem, które Google zwykle odrzuca przed znalezieniem wyników wyszukiwania.
Przykłady Dane wejściowe użytkownika: Star Wars Episode +I
Wyszukiwane hasło: q=Star+Wars+Episode+%2BI

Tylko linki Szukaj, wszystkie terminy [ allinlinks: ]
Opis

Wyszukiwane hasło allinlinks: wymaga, aby dokumenty w wynikach wyszukiwania zawierały wszystkie podane słowa w linkach z adresami URL. Zapytanie powinno być w formacie allinlinks:, po którym następują zawarte w nim słowa.

Jeśli zapytanie zawiera wyszukiwane hasło allinlinks:, Google sprawdzi tylko linki URL w dokumentach pod kątem słów podanych w zapytaniu, ignorując inne fragmenty tekstu w dokumentach, tytuły dokumentów i adresy URL poszczególnych dokumentów. Adres URL dokumentu różni się od adresów URL zawartych w dokumencie.

Wersja elementu allinlinks: ze zmianą znaczenia adresu URL to allinlinks%3A.
Przykłady Dane wejściowe użytkownika:allinlinks: Google search
Wyszukiwane hasło:q=allinlinks%3A+Google+search

Wyszukiwanie wyrażeń
Opis

Wyszukiwane hasło (") umożliwia wyszukiwanie całych wyrażeń poprzez umieszczenie ich w cudzysłowie lub połączenie ich za pomocą łączników.

Wersja " (znajdująca się w cudzysłowie) zakodowana w adresie URL to %22.

Wyszukiwanie wyrażeń przydaje się zwłaszcza wtedy, gdy szukasz słynnych cytatów lub nazw własnych.

Aby wyszukać wyrażenie, możesz też użyć parametru żądania as_epq.
Przykłady Dane wejściowe użytkownika:"Abraham Lincoln"
Wyszukiwane hasło: q=%22Abraham+Lincoln%22

Wyszukiwanie tylko tekstowe, wszystkie hasła [allintext:]
Opis

Wyszukiwane hasło allintext: wymaga, aby każdy dokument w wynikach wyszukiwania zawierał wszystkie słowa podane w zapytaniu w treści dokumentu. Zapytanie powinno być w formacie allintext:, po którym występują określone słowa.

Jeśli zapytanie zawiera wyszukiwane hasło allintext:, Google sprawdzi treść dokumentów pod kątem słów użytych w zapytaniu tylko w treści dokumentów, ignorując linki w tych dokumentach oraz w tytułach i adresach URL dokumentów.

Wersja elementu allintext: ze zmianą znaczenia adresu URL to allintext%3A.
Przykłady Ten przykład określa, że we wszystkich dokumentach w wynikach wyszukiwania muszą występować słowa „Google” i „wyszukiwarka”:
Dane wejściowe użytkownika:allintext:Google search
Wyszukiwane hasło:q=allintext%3AGoogle+search

Wyszukiwanie tytułu, pojedyncze hasło [intitle:]
Opis

Zapytanie intitle: ogranicza wyniki wyszukiwania do dokumentów zawierających określone słowo w tytule. Zapytanie powinno mieć format intitle:WORD bez spacji między wyszukiwanym hasłem intitle: a następującym słowem.

Uwaga: możesz podać więcej niż 1 słowo, które musi zawierać się w tytule dokumentu, umieszczając przed każdym z nich zapytanie intitle:. Możesz też użyć hasła allintitle:, aby określić, że wszystkie słowa zapytania muszą być uwzględnione w tytułach dokumentów znajdujących się w wynikach wyszukiwania.

Wersja elementu intitle: ze zmianą znaczenia adresu URL to intitle%3A.
Przykłady

W tym przykładzie w tytułach wszystkich dokumentów w wynikach wyszukiwania musi występować słowo „Google”, a słowo „wyszukiwanie” musi występować w dowolnym miejscu w tytułach, adresach URL, linkach lub w treści tych dokumentów:
Dane wejściowe użytkownika:intitle:Google search
Hasło zapytania:q=intitle%3AGoogle+search

Wyszukiwanie tytułu, wszystkie hasła [allintitle:]
Opis

Zapytanie allintitle: ogranicza wyniki wyszukiwania do dokumentów zawierających wszystkie podane słowa w tytule. Aby użyć hasła allintitle:, umieść na jego początku „allintitle:”.

Uwaga: umieszczenie allintitle: na początku wyszukiwanego hasła jest równoważne z umieszczeniem operatora intitle: przed każdym słowem w zapytaniu.

Wersja elementu allintitle: ze zmianą znaczenia adresu URL to allintitle%3A.
Przykłady

Ten przykład określa, że w tytułach wszystkich dokumentów w wynikach wyszukiwania muszą występować słowa „Google” i „wyszukiwarka”:
Dane wejściowe użytkownika: allintitle: Google search
Wyszukiwane hasło: q=allintitle%3A+Google+search

Wyszukiwanie URL, pojedyncze hasło [inurl:]
Opis

Zapytanie inurl: ogranicza wyniki wyszukiwania do dokumentów zawierających określone słowo w adresie URL dokumentu. Zapytanie powinno mieć format inurl:WORD bez spacji między wyszukiwanym hasłem inurl: a następującym słowem.

Zapytanie inurl: ignoruje znaki interpunkcyjne i używa tylko pierwszego słowa po operatorze inurl:. Możesz określić więcej niż 1 słowo, które musi być zawarte w adresie URL dokumentu, umieszczając przed każdym z nich hasło zapytania inurl:. Możesz też użyć wyszukiwanego hasła allinurl:, aby wskazać, że wszystkie słowa w zapytaniu muszą być zawarte w adresach URL dokumentów znajdujących się w wynikach wyszukiwania.

Wersja elementu inurl: ze zmianą znaczenia adresu URL to inurl%3A.
Przykłady

W tym przykładzie w adresach URL wszystkich dokumentów w wynikach wyszukiwania musi występować słowo „Google”, a słowo „wyszukiwanie” musi występować w dowolnym miejscu w tytułach, adresach URL, linkach lub w treści tych dokumentów:
Dane wejściowe użytkownika: inurl:Google search
Hasło zapytania: q=inurl%3AGoogle+search

Wyszukiwanie adresu URL, wszystkie hasła [allinurl:]
Opis

Zapytanie allinurl: ogranicza wyniki wyszukiwania do dokumentów zawierających wszystkie słowa zapytania w adresie URL dokumentu. Aby użyć hasła allinurl:, umieść na jego początku ciąg allinurl:.

Zapytanie allinurl: ignoruje znaki interpunkcyjne, więc działa tylko na słowach, a nie w komponentach adresu URL. Na przykład allinurl: uk/scotland ograniczy wyniki do dokumentów zawierających w adresach URL słowa „uk” i „szkocja”, ale nie będzie wymagać, aby te 2 wyrazy pojawiały się w określonej kolejności lub były rozdzielone ukośnikiem.

Wersja elementu allinurl: ze zmianą znaczenia adresu URL to allinurl%3A.
Przykłady

Ten przykład określa, że w adresach URL dokumentów w wynikach wyszukiwania muszą występować słowa „Google” i „wyszukiwarka”:
Dane wejściowe użytkownika: allinurl: Google search
Wyszukiwane hasło: q=allinurl%3A+Google+search


Informacje o dokumencie internetowym [info:]
Opis

Wyszukiwane hasło info: pobiera ogólne informacje o adresie URL, o ile adres ten znajduje się w indeksie wyszukiwania Google. Zapytanie powinno mieć format info:URL bez spacji między wyszukiwanym hasłem info: a adresem URL.

Wersja info: ze zmianą znaczenia adresu URL to informacje%3A.

Uwaga: gdy używasz info:, nie możesz określać innych zapytań.
Przykłady Dane wejściowe użytkownika: info:www.google.com
Wyszukiwane hasło: q=info%3Awww.google.com

Przykładowe zapytania graficzne

Poniższe przykłady pokazują kilka żądań HTTP dotyczących obrazów, aby pokazać, jak używane są różne parametry zapytania. Definicje różnych parametrów zapytania znajdziesz w tym dokumencie w sekcjach Definicje parametrów zapytań graficznych.

To żądanie prosi o 5 pierwszych wyników (start=0&num=5) dla hasła „małpa” (q=monkey), pliku typu .png. Na koniec zapytanie określa wartości parametrów client, output i cx. Wszystkie 3 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 w wyszukiwarce grafiki

as_filetype
Opis

Opcjonalnie. Zwraca obrazy określonego typu. Dozwolone wartości to bmp, gif, png, jpg oraz svg.
Przykłady q=google&as_filetype=png

Obrazy
Opis

Opcjonalnie. Zwraca obrazy o określonym rozmiarze, gdzie rozmiar może być jednym z tych elementów:

  • icon (mały)
  • small|medium|large|xlarge (średnia)
  • xxlarge (duży)
  • huge (bardzo duży)

Przykłady q=google&as_filetype=png&imgsz=icon

typ obrazu
Opis

Opcjonalnie. Zwraca obrazy określonego typu, który może być jednym z tych elementów:

  • clipart (klip)
  • face (twarz)
  • lineart (liniowy)
  • news (wiadomości)
  • photo (zdjęcie)
Przykłady q=google&as_filetype=png&imgtype=photo

Obrazy
Opis

Opcjonalnie. Zwraca obrazy czarno-białe, w skali szarości lub kolorowe:

  • mono (czarno-białe)
  • gray (skala szarości)
  • color (kolor)
Przykłady q=google&as_filetype=png&imgc=gray

kolor obrazu
Opis

Opcjonalnie. Zwraca obrazy w określonym kolorze dominującym:

  • yellow
  • green
  • teal
  • blue
  • purple
  • pink
  • white
  • gray
  • black
  • brown
Przykłady q=google&as_filetype=png&imgcolor=yellow

as_rights
Opis

Opcjonalnie. Filtry działające na podstawie licencjonowania. Obsługiwane wartości to między innymi:

  • cc_publicdomain
  • cc_attribute
  • cc_sharealike
  • cc_noncommercial
  • cc_nonderived
Przykłady q=cats&as_filetype=png&as_rights=cc_attribute

Limity żądań

W tabeli poniżej znajdziesz informacje o ograniczeniach dotyczących żądań wyszukiwania wysyłanych do Google:

Komponent Limit Komentarz
Długość żądania wyszukiwania 2048 bajtów  
Liczba wyszukiwanych haseł 10 zawiera hasła w następujących parametrach: q, as_epq, as_eq, as_lq, as_oq, as_q.
Liczba wyników 20 Jeśli ustawisz w parametrze num wartość większą niż 20, zwróconych zostanie tylko 20 wyników. Aby uzyskać więcej wyników, musisz wysłać wiele żądań i zwiększać wartość parametru start z każdym żądaniem.

Prezentacja internacjonalizacji zapytań i wyników

Usługa Google WebSearch umożliwia wyszukiwanie dokumentów w wielu językach. Możesz określić kodowanie znaków, które powinno być używane do interpretowania żądania HTTP i do zakodowania odpowiedzi XML (za pomocą parametrów wyszukiwania ie i oe). Możesz też filtrować wyniki, aby uwzględnić tylko dokumenty napisane w określonych językach.

Te sekcje zawierają omówienie problemów związanych z wyszukiwaniem w wielu językach:

Kodowanie znaków

Serwery wysyłają dane, takie jak strony internetowe, do klientów użytkownika (takich jak przeglądarki) w postaci sekwencji zakodowanych bajtów. Następnie klient użytkownika dekoduje bajty do postaci sekwencji znaków. Wysyłając żądania do usługi WebSearch, możesz określić schematy kodowania zarówno dla zapytania wyszukiwania, jak i otrzymywanej odpowiedzi XML.

Możesz użyć parametru żądania ie, aby określić mechanizm kodowania znaków w żądaniu HTTP. Możesz też użyć parametru oe, aby określić schemat kodowania, którego Google ma użyć do kodowania odpowiedzi XML. Jeśli używasz schematu kodowania innego niż ISO-8859-1 (lub latin1), podaj prawidłowe wartości parametrów ie i oe.

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

Pełną listę wartości, których możesz używać w parametrach ie i oe, znajdziesz w dodatku do schematów kodowania znaków.

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

Języki interfejsu

Możesz użyć parametru żądania hl, aby określić język interfejsu graficznego. Wartość parametru hl może mieć wpływ na wyniki wyszukiwania XML, zwłaszcza w przypadku zapytań międzynarodowych, gdy ograniczenie języka (za pomocą parametru lr) nie jest wyraźnie określone. W takich przypadkach parametr hl może promować wyniki wyszukiwania w tym samym języku co język wprowadzania użytkownika.

Zalecamy wyraźne ustawienie parametru hl w wynikach wyszukiwania, aby dla każdego zapytania Google wybierało wyniki wyszukiwania najwyższej jakości.

Pełną listę prawidłowych wartości parametru hl znajdziesz w sekcji Obsługiwane języki interfejsu.

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

Za pomocą parametru żądania lr możesz ograniczyć wyniki wyszukiwania do dokumentów napisanych w określonym języku lub w zbiorze języków.

Parametr lr obsługuje operatory logiczne, umożliwiając określenie wielu języków, które powinny być uwzględnione (lub wykluczone) z wyników wyszukiwania.

Poniższe przykłady pokazują, jak można używać operatorów logicznych do wysyłania żądań dokumentów 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

W przypadku dokumentów napisanych w języku innym niż węgierski lub czeski:

lr=(-lang_hu).(-lang_cs)

Pełną listę możliwych wartości parametru lr i Operatory logiczne znajdziesz w sekcji Language Collection Value (Wartości zbioru języków).

Chiński uproszczony i chiński tradycyjny to 2 warianty pisma. Ta sama koncepcja może być inaczej pisana w każdym z wariantów. Po uwzględnieniu zapytania w jednym z wariantów usługa Google WebSearch może zwrócić wyniki zawierające strony w obu wariantach.

Aby skorzystać z tej funkcji:

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

Poniższy przykład pokazuje parametry zapytania, które należy uwzględnić w żądaniu wyników w języku chińskim uproszczonym i tradycyjnym. (Pamiętaj, że ten przykład nie zawiera żadnych dodatkowych informacji, takich jak informacje o kliencie).

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

Filtrowanie wyników

Google WebSearch udostępnia kilka sposobów filtrowania wyników wyszukiwania:

Automatyczne filtrowanie wyników wyszukiwania

Starając się wyświetlać jak najlepsze wyniki wyszukiwania, Google stosuje 2 metody, aby automatycznie odfiltrowywać wyniki wyszukiwania, które są na ogół niepożądane:

  • Powielone treści – jeśli wiele dokumentów zawiera te same informacje, w wynikach wyszukiwania znajdzie się tylko najtrafniejszy dokument z tego zestawu.

  • Nagromadzenie hostów – jeśli z tej samej witryny pochodzi wiele wyników wyszukiwania, Google może nie pokazać wszystkich wyników lub wyświetlać niższe
    pozycje w rankingu niż byłoby to możliwe.

Zalecamy pozostawienie tych filtrów włączonych w przypadku typowych wyszukiwań, ponieważ znacznie podnoszą one jakość większości wyników wyszukiwania. Możesz jednak pominąć te filtry automatyczne, ustawiając w żądaniu wyszukiwania parametr zapytania filter na 0.

Filtrowanie języka i kraju

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

Możesz użyć parametrów żądań lr i cr, aby ograniczyć wyniki wyszukiwania do podzbiorów dokumentów napisanych w określonych językach lub pochodzących z określonych krajów.

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

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


Aby uzyskać więcej informacji o ograniczaniu wyników na podstawie języka, zapoznaj się z definicją parametru lr, sekcją Wyszukiwanie dokumentów spisanych w określonych językach oraz Wartościami zbioru języków, których można użyć jako wartości parametru lr.

Google WebSearch określa kraj dokumentu na podstawie analizy:

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

Aby dowiedzieć się więcej o ograniczaniu wyników według kraju pochodzenia, zapoznaj się z definicją parametru cr oraz wartościami zbierania danych dotyczących krajów, które mogą być używane jako wartości parametru cr.

Uwaga: aby dostosowywać wyniki wyszukiwania, możesz połączyć wartości językowe i krajowe. Możesz na przykład poprosić o dokumenty napisane w języku francuskim, pochodzące z Francji lub Kanady lub pochodzące z Holandii, które nie są napisane w języku angielskim. 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 witryn zawierających treści dla dorosłych. Filtr SafeSearch umożliwia odfiltrowanie wyników wyszukiwania zawierających treści dla dorosłych i ich usunięcie. Filtry Google sprawdzają słowa kluczowe, wyrażenia i adresy URL przy użyciu zastrzeżonej technologii. Choć żaden filtr nie jest skuteczny w 100%, SafeSearch usuwa z wyników wyszukiwania zdecydowaną większość treści dla dorosłych.

Staramy się, aby filtr SafeSearch był stale aktualny i kompleksowy, stale indeksując zawartość sieci i dostosowując aktualizacje na podstawie sugestii użytkowników.

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

Niderlandzki
angielski
francuski
niemiecki 		włoski
portugalski (Brazylia)
Hiszpański
Chiński tradycyjny

Za pomocą parametru safe możesz dostosować stopień, w jakim Google filtruje wyniki wyszukiwania pod kątem treści dla dorosłych. W tabeli poniżej znajdziesz informacje o ustawieniach filtra SafeSearch i jego wpływie na wyniki wyszukiwania:

Poziom filtra SafeSearch Opis
wysoki Umożliwia bardziej rygorystyczną wersję filtra SafeSearch.
medium Blokuje strony internetowe zawierające pornografię i inne treści o charakterze jednoznacznie seksualnym.
wyłączono Treści dla dorosłych nie są odfiltrowywane z wyników wyszukiwania.

* Domyślnym ustawieniem filtra SafeSearch jest wyłączony.

Jeśli masz włączony filtr SafeSearch i znajdziesz witryny, które zawierają w wynikach obraźliwe treści, wyślij e-maila z adresem URL takiej witryny na adres safesearch@google.com, a my ją zbadamy.

Wyniki w formacie XML

DTD z wyników XML Google

Do opisania formatu XML wszystkich typów wyników wyszukiwania Google używa tego samego pliku DTD. Wiele tagów i atrybutów ma zastosowanie do wszystkich typów wyszukiwania. Niektóre tagi można jednak stosować tylko w przypadku określonych typów wyszukiwania. W związku z tym definicje zawarte w DTD mogą być mniej restrykcyjne niż definicje podane w tym dokumencie.

W tym dokumencie opisano te aspekty DTD, które mają zastosowanie w przypadku WebSearch. Jeśli pracujesz z WebSearch, podczas przeglądania pliku DTD możesz bezpiecznie zignorować tagi i atrybuty, które nie zostały tu opisane. Jeśli definicja w DTD i dokumentacji różni się od podanej w dokumentacji, zostanie to odnotowane w tym dokumencie.

Google może zwracać wyniki XML z odniesieniem do najnowszego DTD lub bez niego. DTD to przewodnik, który pomaga administratorom wyszukiwania i parserom XML zrozumieć wyniki wyszukiwania XML w Google. Gramatyka XML Google może się od czasu do czasu zmieniać, dlatego nie konfiguruj parsera do sprawdzania każdego wyniku XML za pomocą DTD.

Poza tym nie należy konfigurować parsera XML tak, aby pobierał DTD za każdym razem, gdy przesyłasz żądanie wyszukiwania. Google rzadko aktualizuje DTD, co wiąże się z niepotrzebnymi wymaganiami dotyczącymi opóźnień i przepustowości.

Do uzyskiwania wyników XML zalecamy używanie formatu wyjściowego xml_no_dtd. Jeśli w żądaniu wyszukiwania określisz format xml output, jedyną różnicą będzie uwzględnienie tego wiersza w wynikach XML:

<!DOCTYPE GSP SYSTEM "google.dtd">

Najnowszy plik DTD znajdziesz na http://www.google.com/google.dtd.

Pamiętaj, że nie wszystkie funkcje dostępne na 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 w definicjach tagów XML zaznaczono inaczej.
  • Niektóre wartości elementów to adresy URL, które przed wyświetleniem muszą zostać zakodowane w języku HTML.
  • Parser XML powinien ignorować nieudokumentowane atrybuty i tagi. Dzięki temu aplikacja może działać bez modyfikacji, jeśli Google doda więcej funkcji do danych wyjściowych XML.
  • W przypadku niektórych znaków znajdujących się jako wartości w tagach XML należy zmienić znaczenie znaków. Twój procesor XML powinien przekonwertować te elementy z powrotem na odpowiednie znaki. Jeśli nie konwertujesz elementów prawidłowo, przeglądarka może np. wyświetlić znak & jako „&amp;". Standard XML dokumentuje te znaki. Są one odtwarzane w tabeli poniżej:

    Znak Formularze ze zmianą znaczenia Element Kod znaku
    Znak & i &amp; &#38;
    Pojedynczy cudzysłów ' &apos; &#39;
    Podwójny cudzysłów ” &quot; &#34;
    Większe niż > &gt; &#62;
    Mniejsze niż < &lt; &#60;

Wyniki XML dla zapytań regularnych i zaawansowanych

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

To przykładowe żądanie w WebSearch zawiera 10 wyników (num=10) dotyczących wyszukiwanego hasła „socer” (q=socer), które jest celowo błędnie napisanym słowem „piłka nożna”.

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 w wyniku XML znajduje się kilka komentarzy, które wskazują, gdzie pojawią się niektóre tagi, których nie ma w wyniku.

<?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 na zwykłe i zaawansowane żądania wyszukiwania korzystają z tego samego zestawu tagów XML. Te tagi XML zostały przedstawione w powyższym przykładzie w formacie XML i zostały omówione w tabelach poniżej.

Tagi XML poniżej są uporządkowane alfabetycznie według nazwy tagu. Każda definicja tagu zawiera opis tagu, przykład pokazujący, jak tag będzie wyglądał w wynikach XML, oraz format jego treści. Jeśli tag jest tagiem podrzędnym innego tagu XML albo ma własne tagi podrzędne lub atrybuty, informacje o tym znajdziesz w tabeli definicji tagu.

W poniższych definicjach obok niektórych subtagów mogą być wyświetlane określone symbole. Znajdziesz je poniżej wraz z informacją o znaczeniu.

? = opcjonalny subtag
* = zero lub więcej wystąpień subtagu
+ = co najmniej 1 wystąpienie subtagu
P B C D P P P S P P N P P R Informacje o stanie kampanii T X

anchor_text
Definicja

Tag <anchor_text> określa tekst, który należy wyświetlać użytkownikom, aby zidentyfikować etykietę doprecyzowania powiązaną ze zbiorem wyników wyszukiwania. Etykiety zawężania wyszukiwania zastępują znaki niealfanumeryczne znakami podkreślenia, dlatego nie należy wyświetlać wartości tagu <label> w interfejsie użytkownika. Zamiast tego należy wyświetlać wartość tagu <anchor_text>.

Przykład <Anchor_text>pola golfowe</Anchor_text>
Subtag FacetItem
Format treści Tekst

ZABLOKUJ
Definicja

Ten tag zawiera treść bloku w wierszu treści wyniku promocji. Każdy blok ma tagi podrzędne T, U i L. Niepusty tag T wskazuje, że blok zawiera tekst. Niepuste tagi U i L wskazują, że blok zawiera link (adres URL podany w subtagu U i tekście kotwicy w podtagu L).
Subtagi T, U, L
Subtag BODY_LINE
Format treści Pusta

BODY_LINE
Definicja

Ten tag umieszcza treść wiersza w treści promowanego wyniku. Każdy wiersz treści składa się z kilku tagów ZABLOKUJ, które zawierają tekst lub link z adresem URL i tekstem kotwicy.
Subtagi ZABLOKUJ*
Subtag SL_MAIN
Format treści Pusta

C
Definicja

Tag <C> wskazuje, że usługa WebSearch może pobrać wersję adresu URL tego wyniku wyszukiwania z pamięci podręcznej. Za pomocą interfejsu XML API nie możesz pobierać stron z pamięci podręcznej, ale możesz przekierowywać użytkowników na stronę www.google.com.
Atrybuty
Nazwa Format Opis
SZ Tekst (liczba całkowita + „k”) Podaje rozmiar wyniku wyszukiwania przechowywanej w pamięci podręcznej w kilobajtach („k”).
ID klienta Tekst Identyfikuje dokument w pamięci podręcznej Google. Aby pobrać dokument z pamięci podręcznej, wyślij wyszukiwane hasło utworzone w ten sposób:
cache:CIDtext:EscapeURL

Adres URL ze zmianą znaczenia jest dostępny w tagu UE.
Przykład <C SZ="6k" CID="kvOXK_cYSSgJ" />
Subtag HAS
Format treści Pusta

Ścieżka konwersji
Definicja Tag <C2C> wskazuje, że wynik odnosi się do strony w języku chińskim tradycyjnym. Ten tag pojawia się tylko wtedy, gdy włączone jest wyszukiwanie w języku chińskim uproszczonym i tradycyjnym. Więcej informacji o włączaniu i wyłączaniu tej funkcji znajdziesz w definicji parametru zapytania c2coff.
Format treści Tekst

Kontekst
Definicja

Tag <Context> zawiera listę etykiet zawężających wyszukiwanie powiązanych ze zbiorem wyników wyszukiwania.
Przykład <Context>
Subtagi tytuł, aspekt+
Format treści Kontener

CRAWLDATE
Definicja

Tag <CRAWLDATE> podaje datę ostatniego indeksowania strony. CRAWLDATE nie jest zwracany w przypadku każdej strony wyników wyszukiwania.
Przykład <CRAWLDATE>21 maja 2005 r.</CRAWLDATE>
Subtag R
Format treści Tekst

DI
Definicja

Tag <DI> zawiera informacje o kategorii Open Directory Project (ODP) pojedynczego wyniku wyszukiwania.
Przykład <DI>
Subtagi DT?, DS?
Subtag HAS
Format treści Pusta

DS
Definicja

Tag <DS> zawiera podsumowanie dotyczące pojedynczej kategorii w katalogu ODP.
Przykład <DS>Opublikuj swoje CV bezpośrednio w internecie.</DS>
Subtag DI
Format treści Tekst (może zawierać kod HTML)

DT
Definicja

Tag <DT> zawiera tytuł pojedynczej kategorii wymienionej w katalogu ODP.
Przykład <DT>SoccerConnection.net</DT>
Subtag DI
Format treści Tekst (może zawierać kod HTML)

Aspekt
Definicja

Tag <Facet> zawiera logiczne grupowanie tagów <FacetItem>. Takie grupowania możesz utworzyć w formacie specyfikacji XML w wyszukiwarce niestandardowej. Jeśli nie utworzysz tych grupowania, tag results_xml_tag_Context><Context> będzie zawierał maksymalnie 4 tagi <Facet>. Elementy w każdym tagu <Facet> będą zgrupowane do celów związanych z wyświetlaniem, ale mogą nie być ze sobą logiczne.
Przykład <Facet>
Subtagi FacetItem+, title+
Subtag Kontekst
Format treści Kontener

FacetItem
Definicja

Tag <FacetItem> zawiera informacje o etykiecie zawężenia wyszukiwania powiązanej z zestawem wyników wyszukiwania.
Przykład <FacetItem>
Subtagi label, anchor_text+
Subtag Aspekt
Format treści FacetItem

FI
Definicja Tag <FI> wskazuje, czy dla wyszukiwania przeprowadzono filtrowanie dokumentów. Więcej informacji o filtrach wyników wyszukiwania Google znajdziesz w sekcji Automatyczne filtrowanie w tym dokumencie.
Przykład <FI />
Subtag Odp.
Format treści Pusta

Oferty wyróżnione w Gmailu
Definicja

Tag <GSP> zawiera wszystkie dane zwrócone w wynikach wyszukiwania Google w formacie XML. „GSP” to skrót od „Google Search Protocol”.
Atrybuty
Nazwa Format Opis
WERSJA ROBOCZA Tekst (liczba całkowita) Atrybut VER określa wersję wyników wyszukiwania. Obecna wersja wyjściowa to „3.2”.
Przykład <GSP VER="3.2">
Subtagi PARAM+, Q, RES?, TM
Format treści Pusta

HAS
Definicja Tag <HAS> zawiera informacje o wszelkich specjalnych parametrach żądania wyszukiwania obsługiwanych w przypadku określonego adresu URL.

Uwaga: definicja elementu <HAS> w WebSearch jest bardziej restrykcyjna niż w DTD.

Subtagi DI?, L?, C?, RT?
Subtag R

ISURL
Definicja Google zwraca tag <ISURL>, jeśli powiązane zapytanie jest adresem URL.
Subtag oferta wyróżniona w Gmailu
Format treści Pusta

L
Definicja Obecność tagu <L> wskazuje, że usługa WebSearch może znajdować inne witryny zawierające linki do tego adresu URL wyniku wyszukiwania. Aby znaleźć takie witryny, użyj specjalnego hasła w zapytaniu link:.
Subtag HAS
Format treści Pusta

label
Definicja

Tag <label> określa etykietę zawężenia wyszukiwania, której można używać do filtrowania otrzymywanych wyników wyszukiwania. Aby użyć etykiety zawężającej wyszukiwanie, dodaj ciąg more:[[wartość tagu etykiety]] do wartości parametru q w żądaniu HTTP wysyłanym do Google, jak pokazano w poniższym przykładzie. Zanim wyślesz zapytanie do Google, ta wartość musi zawierać zmianę znaczenia adresu URL.

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

Uwaga: tag <label> to nie to samo co tag <Label>, który wskazuje etykietę zawężania wyszukiwania powiązaną z konkretnym adresem URL w wynikach wyszukiwania.
Przykład <label>pole_golfowe</label>
Subtag FacetItem
Format treści Tekst

Język
Definicja

Tag <LANG> zawiera najbardziej prawdopodobny język wyników wyszukiwania Google.
Przykład <LANG>en</LANG>
Subtag R
Format treści Tekst

P
Definicja

Tag <M> określa szacowaną łączną liczbę wyników wyszukiwania.

Uwaga: te dane mogą być niedokładne.

Przykład <M>16200000</M>
Subtag Odp.
Format treści Tekst

NB
Definicja

Tag <NB> zawiera informacje nawigacyjne zbioru wyników, czyli linki do następnej lub poprzedniej strony wyników wyszukiwania.

Uwaga: ten tag występuje tylko wtedy, gdy dostępnych jest więcej wyników.
Przykład <NB>
Subtagi NU?, Jednostka przetwarzania?
Subtag Odp.
Format treści Pusta

NU
Definicja

Tag <NU> zawiera względny link do następnej strony wyników wyszukiwania.
Przykład <NU>/search?q=flowers&num=10&hl=pl&ie=UTF-8
&output=xml&client=test&start=10</NU>
Subtag NB
Format treści Tekst (względny URL)

PARAMETR
Definicja

Tag <PARAM> wskazuje parametr wejściowy przesłany w żądaniu HTTP powiązanym z wynikiem XML. Informacje o parametrze są zawarte w atrybutach tagów – name, value, original_value – a dla każdego parametru przesłanego w żądaniu HTTP pojawi się jeden tag PARAM.
Atrybuty
Nazwa Format Opis
name Tekst Nazwa parametru wejściowego.
value HTML Wersja wartości parametru wejściowego w formacie HTML.
original_value Tekst Oryginalna wersja wartości parametru wejściowego ze zmianą znaczenia w adresie URL.
Przykład <PARAM name="cr" value="countryNZ" original_value="countryNZ" />
Subtag oferta wyróżniona w Gmailu
Format treści Złożony

Jednostka przetwarzania
Definicja

Tag <PU> zawiera względny link do poprzedniej strony wyników wyszukiwania.
Przykład <PU>/search?q=kwiaty&num=10&hl=pl&output=xml
&client=test&start=10</PU>
Subtag NB
Format treści Tekst (względny URL)

P
Definicja

Tag <Q> określa zapytanie przesłane w żądaniu HTTP powiązanym z wynikiem XML.
Przykład

<Q>pizza</Q>
Subtag oferta wyróżniona w Gmailu
Format treści Tekst

R
Definicja

Tag <R> zawiera szczegóły poszczególnych wyników wyszukiwania.

Uwaga: definicja tagu <R> w WebSearch jest bardziej restrykcyjna niż w DTD.

Atrybuty
Nazwa Format Opis
N Tekst (liczba całkowita) Wskazuje indeks tego wyniku wyszukiwania (w oparciu o 1).
MIME Tekst Wskazuje typ MIME wyniku wyszukiwania.
Subtagi U, UE, T?, CRAWLDATE, S?, LANGUAGE?, HAS
Subtag Odp.

RES
Definicja

Tag <RES> zawiera zbiór poszczególnych wyników wyszukiwania wraz ze szczegółami.
Atrybuty
Nazwa Format Opis
SN Tekst (liczba całkowita) Wskazuje indeks (w oparciu o 1) pierwszego wyniku wyszukiwania zwróconego w tym zbiorze wyników.
PL Tekst (liczba całkowita) Wskazuje indeks (w oparciu o 1) ostatniego wyniku wyszukiwania zwróconego w tym zbiorze wyników.
Przykład <RES SN="1" EN="10">
Subtagi M, FI?, XT?, NB?, R*
Subtag oferta wyróżniona w Gmailu
Format treści Pusta

S
Definicja

Tag <S> zawiera fragment wyniku wyszukiwania, w którym wyszukiwane hasła są wyróżnione pogrubieniem. Podziały wierszy są umieszczane w wyciągu, aby zapewnić prawidłowe zawijanie tekstu.
Przykład <S>Waszyngton (CNN) – stawka mająca na celu zakończenie wyborów w sprawie prezydenta w sprawie wyborów prezydenckich z udziałem prezydenta <b&gt;Busha Busha. W wyniku wyborów 5 osób wybranych przez sąd umożliwiłoby głosowanie ostateczne, a jednocześnie zachowało się miejsce w wyborach...
Subtag R
Format treści Tekst (HTML)

SL_MAIN
Definicja

Ten tag zawiera treść wyniku promocji. Służy do analizowania promocji. Tekst kotwicy i adres URL linku z tytułem są zawarte odpowiednio w subtagach T i U. Wiersze tekstu głównego i linków są zawarte w podtagach BODY_LINE.
Subtagi BODY_LINE*, T, U
Subtag SL_RESULTS
Format treści Pusta

SL_RESULTS
Definicja

Tag kontenera na potrzeby promowanych wyników. Jeden z nich będzie wyświetlany zawsze, gdy pojawi się promocja w wynikach wyszukiwania. Subtag SL_MAIN zawiera główne dane dotyczące wyników.
Subtagi SL_MAIN*
Subtag R
Format treści Pusta

Pisownia
Definicja

Tag <Spelling> zawiera alternatywną sugestię pisowni dla przesłanego zapytania. Ten tag pojawia się tylko na pierwszej stronie wyników wyszukiwania. Sugestie pisowni są dostępne w języku angielskim, chińskim, japońskim i koreańskim.

Uwaga: Google zwraca sugestie pisowni tylko w przypadku zapytań, w których wartość parametru gl jest zapisana małymi literami.
Przykład <Spelling>
Subtagi Sugestia
Subtag oferta wyróżniona w Gmailu
Format treści Pusta

Sugestia
Definicja Tag <Suggestion> zawiera propozycję innej pisowni dla przesłanego zapytania. Dzięki treści tagu możesz zasugerować użytkownikowi przeprowadzającym wyszukiwanie inną pisownię. Wartość atrybutu q to sugestia poprawy pisowni adresu URL, której można użyć jako hasła w zapytaniu.
Atrybuty
Nazwa Format Opis
q Tekst Atrybut q określa wersję sugestii pisowni z zmianą znaczenia w adresie URL.
Przykład <Suggestion q="soccer">&lt;b&gt;&lt;i&gt;piłka&lt;/i&gt;&lt;/b&gt;</Suggestion>
Subtag Pisownia
Format treści Tekst (HTML)

T
Definicja Tag <T> zawiera tytuł wyniku.
Przykład <T>Pizzeria na Wschodnim Wybrzeżu Amici</T>
Subtag R
Format treści Tekst (HTML)

title
Definicja

Tag <title>, który jest elementem podrzędnym elementu <Context>, zawiera nazwę Wyszukiwarki niestandardowej.

Tag <title>, jako element potomny tagu <Facet>, dostarcza tytuł zestawu aspektów.
Przykład

Jako element podrzędny tagu <Context>: <title>Moja wyszukiwarka</title>

Jako element podrzędny elementu <Facet>: <title>facet title</title>
Subtag Kontekst, Aspekt
Format treści Tekst

TM
Definicja

Tag <TM> określa całkowity czas serwera potrzebny do zwrócenia wyników wyszukiwania (wyrażony w sekundach).
Przykład <TM>0,100445</TM>
Subtag oferta wyróżniona w Gmailu
Format treści Tekst (liczba zmiennoprzecinkowa)

TT
Definicja Tag <TT> zawiera wskazówkę dotyczącą wyszukiwania.
Przykład <TT>&lt;i&gt;Wskazówka: w większości przeglądarek naciśnięcie klawisza Return daje takie same wyniki jak kliknięcie przycisku wyszukiwania.&lt;/i&gt;</TT>
Subtag oferta wyróżniona w Gmailu

U
Definicja Tag <U> zawiera adres URL wyniku wyszukiwania.
Przykład <U>http://www.dominos.com/</U>
Subtag R
Format treści Tekst (bezwzględny URL)

Uniwersalna
Definicja

Tag <UD> podaje adres URL wyniku wyszukiwania zakodowany w systemie IDN (międzynarodowa nazwa domeny). Ta wartość umożliwia wyświetlanie domen w językach lokalnych. Na przykład adres URL zakodowany w IDN http://www.%E8%8A%B1%E4%BA%95.com może zostać zdekodowany i wyświetlony jako http://www.花小鮨.com. Ten tag <UD> będzie uwzględniany w wynikach wyszukiwania tylko w przypadku żądań zawierających parametr ud.

Uwaga: jest to funkcja w wersji beta.
Przykład <UD>http://www.%E8%8A%B1%E4%BA%95.com/</UD>
Subtag R
Format treści Tekst (adres URL zakodowany w formacie IDN)

UE
Definicja Tag <UE> zawiera adres URL wyniku wyszukiwania. Wartość jest zakodowana ze zmianą znaczenia, dzięki czemu jest odpowiednia do przekazywania jako parametru zapytania w adresie URL.
Przykład <UE>http://www.dominos.com/</UE>
Subtag R
Format treści Tekst (adres URL ze zmianą znaczenia dla adresu URL)

XT
Definicja Tag <XT> wskazuje, że szacowana łączna liczba wyników, określona za pomocą tagu M, faktycznie odzwierciedla dokładną łączną liczbę wyników. Więcej informacji znajdziesz w sekcji Automatyczne filtrowanie w tym dokumencie.
Przykład <XT />
Subtag Odp.
Format treści Pusta


Wyniki XML dla zapytań graficznych

To przykładowe żądanie grafiki zawiera 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

Tabela poniżej zawiera dodatkowe tagi XML używane w odpowiedziach XML na zapytania w wyszukiwarce grafiki.

W poniższych definicjach obok niektórych subtagów mogą być wyświetlane określone symbole. Znajdziesz je poniżej wraz z informacją o znaczeniu.

? = opcjonalny subtag
* = zero lub więcej wystąpień subtagu
+ = co najmniej 1 wystąpienie subtagu

RG
Definicja

Tag <RG> zawiera szczegóły poszczególnych wyników wyszukiwania grafiki.
Atrybuty
Nazwa Format Opis
N Tekst (liczba całkowita) Wskazuje indeks tego wyniku wyszukiwania (w oparciu o 1).
MIME Tekst Wskazuje typ MIME wyniku wyszukiwania.
Subtag Odp.
RU
Definicja

Tag <RU tag> zawiera szczegółowe informacje o każdym wyniku wyszukiwania grafiki.
Subtag R