Dokumentacja API w formacie XML

Stay organized with collections Save and categorize content based on your preferences.

Ta strona dotyczy wersji XML interfejsu API Twojej wyszukiwarki Google w formacie JSON, która jest dostępna tylko dla klientów korzystających z wyszukiwarki Google Site Search.

  1. Przegląd
  2. Format żądania Wyszukiwarki niestandardowej
    1. Omówienie prośby
    2. Wyszukiwane hasła
    3. Parametry żądania
      1. Przykładowe zapytania WebSearch
      2. Definicje parametrów zapytania w wyszukiwarce Google
      3. Szukanie zaawansowane
      4. Zaawansowane parametry zapytania
      5. Specjalne zapytania
      6. Przykładowe zapytania o obraz
      7. Parametry zapytania w wyszukiwarce grafiki
      8. Limity żądań
    4. Międzynarodowa prezentacja zapytań i wyników
      1. Kodowanie znaków
      2. Języki interfejsu
      3. Chiński tradycyjny lub uproszczony
    5. Filtrowanie wyników
      1. Automatyczne filtrowanie wyników wyszukiwania
      2. Filtrowanie języka i kraju
      3. Filtrowanie treści dla dorosłych za pomocą filtra SafeSearch
  3. Wyniki XML
    1. Wyniki wyszukiwania XML XML DTD
    2. Odpowiedź XML
    3. Wyniki wyszukiwania XML dla zapytań zwykłych, graficznych i zaawansowanych
      1. Zwykłe/zaawansowane wyszukiwanie: przykładowe zapytanie i wynik XML
      2. Zwykłe/zaawansowane wyszukiwanie: tagi XML
      3. Wyniki wyszukiwania XML dla zapytań graficznych
      4. Wyszukiwarka grafiki: przykładowe zapytanie i wynik XML
      5. Wyszukiwarka grafiki: tagi XML

Przegląd

Usługa wyszukiwarki Google umożliwia klientom korzystającym z Wyszukiwarki Google wyświetlanie wyników wyszukiwania we własnych witrynach. Usługa WebSearch do wyświetlania wyników wyszukiwania używa prostego protokołu opartego na protokole HTTP. Administratorzy wyszukiwania mają pełną kontrolę nad sposobem wysyłania wyników wyszukiwania i udostępniania ich użytkownikom. W tym dokumencie opisano techniczne szczegóły żądania wyszukiwania Google i formatów wyników.

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

Format żądania WebSearch

Żądanie – informacje

Żądanie wyszukiwarki Google to standardowe polecenie HTTP GET. Zawiera zbiór parametrów pasujących do zapytań. Parametry te są uwzględniane w adresie URL żądania jako pary nazwa=wartość rozdzielone znakiem „&”. Obejmują one takie dane jak wyszukiwane hasło i unikalny identyfikator wyszukiwarki (cx), który identyfikuje żądanie HTTP. Usługa WebSearch lub wyszukiwarka grafiki zwraca wyniki w formacie XML w odpowiedzi na żądania HTTP.

Wyszukiwane hasła

Większość zapytań zawiera co najmniej jedno zapytanie. Wyszukiwane hasło pojawia się jako wartość parametru w żądaniu.

Wyszukiwane hasła mogą określać różne typy informacji, które mogą być wyświetlane i odfiltrowywane 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 zapytaniu,
    • Dowolne słowo lub wyrażenie w zapytaniu
  • Gdzie w dokumencie są wyszukiwane hasła
    • W dowolnym miejscu dokumentu (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 dotyczące adresów URL, które zwracają informacje o określonym adresie URL, zamiast wyszukiwać
    • Zapytania, które zwracają ogólne informacje o adresie URL, na przykład kategoria Open Directory, fragment kodu lub język
    • Zapytania, które zwracają zestaw stron internetowych zawierających linki do adresu URL
    • Zapytania, które zwracają zestaw stron internetowych podobnych do danego URL-a

Domyślne wyszukiwanie

Wartości parametrów zapytania muszą mieć zmienione znaczenie. Pamiętaj, że w wynikach wyszukiwania musisz zastąpić znak plusa ("+") wszystkimi sekwencjami odstępów. Omówiliśmy to szczegółowo w sekcji Zmiany znaczenia adresów URL w tym dokumencie.

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

q=horses+cows+pigs

Domyślnie usługa Google WebSearch zwraca tylko dokumenty zawierające wszystkie wyszukiwane hasła.

Parametry żądania

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

Wymagane są 3 parametry żądania:

  • Parametr client musi mieć wartość google-csbe.
  • Parametr output określa format zwracanych wyników w formacie XML. Wyniki mogą być zwracane za pomocą (xml) lub bez (xml_no_dtd) odwołania do DTD Google. 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 żądań 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 WebSearch

Poniżej znajdziesz kilka żądań HTTP z WebSearch, które pokazują, jak używane są różne parametry zapytania. Definicje różnych parametrów zapytania znajdziesz w sekcjach Definicje parametrów zapytania w internecie i Parametrach zaawansowanego wyszukiwania.

To żądanie wymaga pierwszych 10 wyników (start=0&num=10) dla zapytania &"red sox" (q=red+sox). Zapytanie określa też, że wyniki powinny pochodzić z kanadyjskich witryn (cr=countryCA) i być zapisane w języku francuskim (lr=lang_fr). Na koniec zapytanie określa wartości parametrów client, output i cx. Wszystkie te parametry 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 zaawansowanego zapytania, aby jeszcze bardziej dostosować zapytanie. To żądanie używa parametru as_q (as_q=red+sox) zamiast parametru q. Korzysta też z parametru as_eq, aby wykluczać z wyników wyszukiwania (as_eq=yankees) dokumenty zawierające słowo „Janki”.

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 WebSearch

C2COFF
Description

Opcjonalnie. Parametr c2coff włącza lub wyłącza funkcję wyszukiwania tradycyjnego i chińskiego.

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

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

client
Description

Required. Parametr client musi mieć wartość google-csbe.

Przykłady q=google&client=google-csbe

cr
Description

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

Wyszukiwarka Google określa kraj dokumentu na podstawie analizy:

  • domenę najwyższego poziomu (TLD) adresu URL dokumentu.
  • lokalizacja geograficzna serwera IP serwera WWW

Listę prawidłowych wartości znajdziesz w sekcji Wartości parametrów (kraj).

Przykłady q=Frodo&cr=countryNZ

xx
Description

Required. Parametr cx określa unikalny kod identyfikujący wyszukiwarkę niestandardową. Aby pobrać z niej wyniki wyszukiwania, musisz określić Wyszukiwarka niestandardową.

Wartość parametru cx znajdziesz w panelu sterowania na karcie „Kody”. Znajdziesz go w obszarze tekstowym w sekcji „#39”. Wklej ten kod na stronie, na której ma się pojawić pole wyszukiwania. Wyniki wyszukiwania będą wyświetlane na stronie hostowanej przez Google;

Przykłady q=Frodo&cx=00255077836266642015:u-scht7a-8i

filter
Description

Opcjonalnie. Parametr filter powoduje włączenie lub wyłączenie automatycznego filtrowania wyników wyszukiwania Google. Więcej informacji o filtrach wyników wyszukiwania w Google znajdziesz w sekcji Automatyczne filtrowanie.

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

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

Uwaga: domyślnie Google stosuje filtrowanie do wszystkich wyników wyszukiwania, aby poprawić jakość tych wyników.

Przykłady q=google&filter=0

gl
Description

Opcjonalnie. Wartość parametru gl to dwuliterowy kod kraju. W przypadku wyników z WebSearch parametr gl zwiększa liczbę wyników 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 poprawić trafność wyników. Dotyczy to szczególnie klientów międzynarodowych, a w szczególności klientów z krajów anglojęzycznych innych niż Stany Zjednoczone.

Przykłady

To żądanie zwiększy liczbę dokumentów pisanych w Wielkiej Brytanii w wynikach wyszukiwania w wyszukiwarce Google:
q=pizza&gl=uk


hl
Description

Opcjonalnie. Parametr hl określa język interfejsu (język hosta) interfejsu. Zdecydowanie zalecamy skonfigurowanie tego parametru bezpośrednio, aby poprawić wydajność i jakość wyników wyszukiwania.

Więcej informacji znajdziesz w sekcji dotyczącej języków interfejsu w artykule Internacjonalizacja zapytań i wyników wyszukiwania, a w artykule Obsługiwane języki.

Przykłady

To żądanie jest kierowane na wino po francusku. (Vin to francuski termin „wino”).

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

HQ
Description

Opcjonalnie. Parametr hq dołącza do zapytania określone zapytania, jakby zostały połączone z operatorem logicznym AND.

Przykłady

To żądanie zawiera hasła 'pizza' AND 'ser,'. Wyrażenie jest takie samo jak q=pizza+cheese.

q=pizza&hq=cheese


ie
Description

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

W sekcji Kodowanie znaków znajdziesz informacje o tym, kiedy może być konieczne użycie tego parametru.

Listę możliwych wartości ie znajdziesz w sekcji Schematy kodowania znaków.

Przykłady q=google&ie=utf8&oe=utf8
lr
Description

Opcjonalnie. Parametr lr (ograniczenia języka) ogranicza wyniki wyszukiwania do dokumentów napisanych w określonym języku.

Wyszukiwarka Google określa język dokumentu, analizując:

  • domenę najwyższego poziomu (TLD) adresu URL dokumentu.
  • metatagi w dokumencie
  • główny język, który jest używany w treści dokumentu;
  • języki dodatkowe (jeśli są używane) w treści dokumentu.

Listę prawidłowych wartości dla tego parametru znajdziesz w sekcji Język (lr) Wartości zbierania.

Przykłady q=Frodo&lr=lang_en

num
Description

Opcjonalnie. Parametr num określa liczbę wyników wyszukiwania, które zostaną zwrócone.

Wartość domyślna num to 10, a maksymalna to 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 żądanej liczby, zwrócone zostaną wszystkie dostępne wyniki wyszukiwania.

Przykłady q=google&num=10

Oe
Description

Opcjonalnie. Parametr oe określa schemat kodowania znaków, który powinien być użyty do dekodowania wyniku XML. Domyślna wartość oe to latin1.

W sekcji Kodowanie znaków znajdziesz informacje o tym, kiedy może być konieczne użycie tego parametru.

Listę możliwych wartości oe znajdziesz w sekcji Schematy kodowania znaków.

Przykłady q=google&ie=utf8&oe=utf8

wynik
Description

Required. 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 przedstawiono różnice w wartościach parametrów.

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

q
Description

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

W wartości parametru q można też wykorzystać wiele specjalnych haseł zapytania. Listę tych definicji znajdziesz tutaj.

Panel sterowania wyszukiwarki Google zawiera raport z najczęstszymi zapytaniami przesłanymi za pomocą parametru q.

Uwaga: wartość parametru q musi mieć zmienione znaczenie.

Przykłady q=vacation&as_oq=london+paris

bezpieczeństwo
Description

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

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

Więcej informacji o tej funkcji znajdziesz w sekcji Filtrowanie treści dla dorosłych za pomocą filtra SafeSearch.

Przykłady q=adult&safe=high

rozpocznij
Description

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

Parametr start działa w połączeniu z parametrem num, aby określić, które wyniki wyszukiwania mają zostać zwrócone. Zwróć uwagę, że gdy zapytanie zwróci co najmniej 1000 dokumentów, nie zostanie zwróconych więcej niż 1000 wyników, więc ustawienie poziomu 1000 lub większej liczby wyników nie przyniesie żadnych wyników.

Przykłady start=10

sortuj
Description

Opcjonalnie. Parametr sort określa, że wyniki mają być sortowane zgodnie z określonym wyrażeniem. Na przykład sortuj według daty.

Przykłady

sort=date


ud
Description

Opcjonalnie. Parametr ud wskazuje, czy odpowiedź XML powinna zawierać adres URL zakodowany przez IDN wyniku wyszukiwania. Kodowanie IDN (International Domain Name) umożliwia wyświetlanie domen w lokalnych językach, na przykład:

http://www.花井鮨.com

Prawidłowe wartości tego parametru to 1 (domyślny), co oznacza, że wynik w formacie XML nie powinien zawierać adresów zakodowanych w formacie IDN, a 0, co oznacza, że wynik XML nie powinien zawierać adresów zakodowanych w formacie IDN. Jeśli parametr ud jest ustawiony na 1, adres URL z kodowaniem IDN będzie w tagu UD w wynikach wyszukiwania XML.

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

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

Uwaga: funkcja jest w wersji beta.

Przykłady q=google&ud=1

Dodatkowe parametry zapytania wymienione pod obrazem odnoszą się do zapytań zaawansowanych. Gdy przesyłasz wyszukiwanie zaawansowane, wartości kilku parametrów (np. as_eq, as_epq, as_oq itd.) są uwzględniane w zapytaniach dotyczących tego wyszukiwania. Obraz przedstawia stronę szukania zaawansowanego w Google. Na zdjęciach nazwy poszczególnych parametrów wyszukiwania zaawansowanego są zapisane czerwonym tekstem w obrębie lub obok pola na stronie, której dotyczy dany parametr.



Zaawansowane parametry wyszukiwania

as_dt
Description

Opcjonalnie. Parametr as_dt określa, czy wyniki mają być uwzględniane w witrynie o nazwie as_sitesearch. Wartości i i e oznaczają odpowiednio uwzględnienie i wykluczenie.

Przykłady as_dt=i,as_dt=e

as_epq,
Description

Opcjonalnie. Parametr as_epq wskazuje wyrażenie, które musi zawierać wszystkie dokumenty w wynikach wyszukiwania. Możesz też użyć wyszukiwanego hasła wyszukiwanego wyrażenia.

Przykłady as_epq=abraham+lincoln

as_eq
Description

Opcjonalnie. Parametr as_eq identyfikuje słowo lub wyrażenie, które nie powinno występować w żadnych dokumentach w wynikach wyszukiwania. Możesz też użyć zapytania exclude, aby mieć pewność, że konkretne słowo lub wyrażenie nie będzie pojawiać się w dokumentach w wynikach wyszukiwania.

Przykłady

q=bass&as_eq=music.


as_lq,
Description

Opcjonalnie. Parametr as_lq określa, że wszystkie wyniki wyszukiwania powinny zawierać link do określonego adresu URL. Możesz też użyć zapytania link: w przypadku tego typu zapytania.

Przykłady

as_lq=www.google.com


as_nlo
Description

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

Przykłady

Oto zakres wyszukiwania z zakresu od 5 do 10 włącznie:

as_nlo=5&as_nhi=10

as_nhi
Description

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

Przykłady

Oto zakres wyszukiwania z zakresu od 5 do 10 włącznie:

as_nlo=5&as_nhi=10

as_oq
Description

Opcjonalnie. Parametr as_oq zawiera dodatkowe wyszukiwane hasła do sprawdzenia w dokumencie, przy czym każdy dokument w wynikach wyszukiwania musi zawierać co najmniej 1 z nich. W przypadku tego typu zapytania możesz też użyć hasła logicznego LUB.

Przykłady

q=vacation&as_oq=London+Paris


as_q
Description

Opcjonalnie. Parametr as_q zawiera wyszukiwane hasła do sprawdzenia w dokumencie. Ten parametr jest też często używany do określania dodatkowych haseł w zestawie wyników wyszukiwania.

Przykłady

q=president&as_q=John+Adams


as_qdr
Description

Opcjonalnie. Parametr as_qdr prosi o wyniki wyszukiwania z określonego okresu (krótki zakres dat). Obsługiwane są następujące wartości:

d[number] prosi o wyniki z określonej liczby ostatnich dni.
w[number] prosi o wyniki z określonej liczby minionych tygodni.
m[number] prosi o wyniki z określonej liczby ostatnich miesięcy.
y[number] prosi o wyniki z określonej liczby lat.

Przykłady

Ten przykład obejmuje wyniki z ostatniego roku:

as_qdr=y

Ten przykład obejmuje wyniki z ostatnich 10 dni:

as_qdr=d10

as_rq
Description

Opcjonalnie. Parametr as_rq określa, że wszystkie wyniki wyszukiwania powinny być powiązane z określonym adresem URL. Wartość parametru powinna być adresem URL. Możesz też użyć zapytania related: w przypadku tego typu zapytania.

Przykłady

Ten przykład pokazuje wyszukiwanie stron związanych z www.google.pl:
as_rq=www.google.com


as_sitesearch,
Description

Opcjonalnie. Parametr as_sitesearch pozwala określić, że wszystkie wyniki wyszukiwania powinny być stronami z danej witryny. Ustawiając parametr as_dt, możesz też użyć go, aby wykluczyć strony z danej witryny w wynikach wyszukiwania.

Przykłady

q=vacation&as_sitesearch=www.google.com


Specjalne zapytania

Wyszukiwarka Google umożliwia korzystanie z kilku specjalnych haseł, które zapewniają dodatkowe możliwości wyszukiwarki Google. Te specjalne hasła powinny być zawarte w wartości parametru żądania q. Podobnie jak w przypadku innych zapytań, specjalne warunki zapytania muszą zawierać tekst ze zmianą znaczenia. Liczba specjalnych haseł zapytania zawiera dwukropek (:). Ten znak musi też mieć zmienione znaczenie, a jego wartość zmiany znaczenia to %3A.

Wstecz [link:]
Description

Zapytanie zapytania link: pobiera zestaw stron internetowych zawierających linki do określonego adresu URL. Wyszukiwane hasło powinno być sformatowane jako link:URL bez spacji między wyszukiwanymi hasłami link: a adresem URL.

Wersja link: z kodem zmiany znaczenia adresu URL to link%3A.

Aby przesłać żądanie link:, możesz również użyć parametru żądania as_lq.

Uwaga: gdy używasz właściwości link:, nie możesz określać innych haseł.

Przykłady

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


Wartość logiczna LUB wyszukiwanie [ LUB ]
Description

Zapytanie zapytania OR pobiera dokumenty, które zawierają jeden z serii (lub więcej) zapytań. Aby użyć zapytania OR, wstaw wyszukiwane hasło OR wielkimi literami między poszczególnymi hasłami w serii.

Możesz też użyć parametru żądania as_oq, aby przesłać wyszukiwane hasło w zestawie haseł.

Uwaga: jeśli zapytanie zawiera zapytanie "Londyn+LUB+Paryż" wyniki wyszukiwania będą zawierać dokumenty zawierające co najmniej jedno z tych 2 słów. W niektórych przypadkach dokumenty znalezione w wynikach wyszukiwania mogą zawierać oba te słowa.

Przykłady

Wyszukaj Londyn lub Paryż:

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

Wyszukaj wakacje i Londyn lub Paryż:

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

Wyszukiwanie wakacji i jednego z Londynu, Paryża lub czekolady:

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

Wyszukaj wakacje i czekolady, a także londyny lub paryskie, a najmniejsze znaczenie mają czekolady:

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

Wyszukiwanie wakacji, czekoladek i kwiatów w dokumentach zawierających również Londyn lub Paryż:

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

Wyszukaj wakacje i jeden z Londynu lub Paryża albo wyszukaj jedną z czekolad albo kwiatów:

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

Wyklucz zapytanie [-]
Description

Zapytanie zapytania „-” ogranicza wyniki konkretnego zapytania do dokumentów, które nie zawierają określonego słowa lub wyrażenia. Aby użyć zapytania z wykluczonym zapytaniem, musisz poprzedzić wyraz, który chcesz wykluczyć z odpowiednich dokumentów, wpisując znak "-" (znak minusa).

Wersja - z kodem zmiany znaczenia adresu URL to %2D.

Wyszukiwane hasło jest przydatne, gdy wyszukiwane hasło ma więcej niż 1 znaczenie. Na przykład słowo &bast&bast; może zwrócić wyniki dotyczące ryb lub muzyki. Jeśli szukasz dokumentów dotyczących ryb, możesz wykluczyć je z wyników wyszukiwania, używając zapytania wykluczającego.

Możesz też użyć parametru żądania as_eq, aby wykluczyć z wyników wyszukiwania dokumenty pasujące do konkretnego słowa lub wyrażenia.

Przykłady Dane wejściowe użytkownika: bass -music
Wyszukiwane hasło: q=bass+%2Dmusic

Wykluczenie typu plików [ -filetype: ]
Description

Zapytanie zapytania -filetype: nie obejmuje dokumentów z określonym rozszerzeniem pliku, np. ".pdf" lub ".doc". Wyszukiwane hasło powinno być sformatowane jako -filetype:EXTENSION bez spacji między wyszukiwanymi hasłami -filetype: a określonym rozszerzeniem.

Wersja -filetype: z kodem zmiany znaczenia adresu URL to %2Dfiletype%3A.

Uwaga: możesz wykluczyć wiele typów plików z wyników wyszukiwania, dodając do zapytania więcej haseł typu -filetype:. Musisz podać 1 wyszukiwane hasło -filetype: w przypadku 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)
  • L1
  • IBM WordPro (LWP)
  • Macwrite (mw)
  • Microsoft Excel (XLSX),
  • Microsoft PowerPoint (ppt),
  • Microsoft Word (dokument)
  • Microsoft Works (WK, WPS, WDB)
  • Microsoft Logging (WRI)
  • Format RTF (RTF)
  • Shockwave Flash (swf)
  • Tekst (ans, txt).

W przyszłości możemy dodać więcej typów plików. Aktualną listę plików znajdziesz w najczęstszych pytaniach o typy plików w Google.

Przykłady

Ten przykład zwraca dokumenty, w których wspomniano &Google, ale nie są to dokumenty PDF:
q=Google+%2Dfiletype%3Apdf

Ten przykład zwraca dokumenty, w których występuje wzmianka o „Google"”, ale wyklucza dokumenty PDF i Word:
q=Google+%2Dfiletype%3Apdf+%2Dfiletype%3Adoc


Filtrowanie typu plików [typ pliku: ]
Description

Zapytanie filetype: ogranicza wyniki wyszukiwania do dokumentów z określonym rozszerzeniem, np. ".pdf" lub ".doc". Zapytanie powinno mieć format filetype:extension bez odstępu między wyszukiwanym hasłem filetype: a określonym rozszerzeniem.

Wersja filetype: z kodem zmiany 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 znaczników filetype:. Każde zapytanie o rozszerzenie pliku powinno się znaleźć w wynikach wyszukiwania (filetype:). Wiele haseł zapytania filetype: należy rozdzielić przy użyciu zapytania OR.

Domyślnie wyniki wyszukiwania będą obejmować dokumenty z dowolnym rozszerzeniem.

Typy plików obsługiwane przez Google:

  • Adobe Portable Document Format (PDF),
  • Adobe PostScript (ps)
  • L1
  • IBM WordPro (LWP)
  • Macwrite (mw)
  • Microsoft Excel (XLSX),
  • Microsoft PowerPoint (ppt),
  • Microsoft Word (dokument)
  • Microsoft Works (WK, WPS, WDB)
  • Microsoft Logging (WRI)
  • Format RTF (RTF)
  • Shockwave Flash (swf)
  • Tekst (ans, txt).

W przyszłości możemy dodać więcej typów plików. Aktualną listę plików znajdziesz w najczęstszych pytaniach o typy plików w Google.

Przykłady

Ten przykład zwraca dokumenty PDF, w których znajduje się wzmianka o Google:
q=Google+filetype%3Apdf

Ten przykład zwraca dokumenty PDF i słowa Worda, w których mowa o „Google”:
q=Google+filetype%3Apdf+OR+filetype%3Adoc


Uwzględnij wyszukiwane hasło [+]
Description

Termin zapytania (+) oznacza, że słowo lub wyrażenie musi występować we wszystkich dokumentach uwzględnionych w wynikach wyszukiwania. Aby zastosować wyszukiwane hasło, musisz poprzedzić słowo lub wyrażenie, które musi być uwzględnione we wszystkich wynikach wyszukiwania, używając znaku "+" (znak plusa).

Wersja + z kodem zmiany znaczenia (znak plusa) to %2B.

Przed zidentyfikowaniem wyników wyszukiwania użyj wartości + przed typowym słowem, które Google zwykle odrzuca.

Przykłady Dane wejściowe użytkownika: Star Wars Episode +I
Wyszukiwane hasło: q=Star+Wars+Episode+%2BI

Wyszukiwanie samych linków, wszystkie terminy [ allinlinks: ]
Description

Zapytanie allinlinks: wymaga, aby dokumenty w wynikach wyszukiwania zawierały wszystkie słowa podane w linkach URL. Wyszukiwane hasło powinno być sformatowane jako allinlinks:, a po nim jako słowa.

Jeśli zapytanie zawiera wyszukiwane hasło allinlinks:, Google sprawdzi w dokumentach tylko adresy URL słów znajdujące się w wyszukiwanych hasłach, ignorując inny tekst w dokumentach, tytuły dokumentów i adresy URL każdego dokumentu. Pamiętaj, że adres URL dokumentu różni się od adresów URL zawartych w dokumencie.

Wersja allinlinks: z kodem zmiany znaczenia adresu URL to allinlinks%3A.

Przykłady Dane wejściowe użytkownika:allinlinks: Google search
Wyszukiwane hasło:q=allinlinks%3A+Google+search

Wyszukiwarka wyrażeń
Description

Hasło wyszukiwane w wyrażeniu (") umożliwia wyszukanie wszystkich wyrażeń w cudzysłowie lub połączenie ich łącznikami.

Wersja " z kodem zmiany znaczenia adresu URL (cudzysłów) to %22.

Są one szczególnie przydatne, gdy szukasz słynnych cytatów lub prawidłowych nazw.

Możesz też użyć parametru żądania as_epq, aby przesłać wyszukiwane wyrażenie.

Przykłady Dane wejściowe użytkownika:"Abraham Lincoln"
Wyszukiwane hasło: q=%22Abraham+Lincoln%22

Powiązane linki [related:]
Description

Zapytanie related: pobiera zestaw stron internetowych podobnych do konkretnego adresu URL. Wyszukiwane hasło powinno być sformatowane jako related:URL bez spacji między wyszukiwanymi hasłami related: a adresem URL.

Wersja related: z kodem zmiany znaczenia adresu URL to related%3A.

Możesz też użyć parametru żądania as_rq, aby przesłać powiązane żądanie:

Uwaga: gdy używasz właściwości related:, nie możesz określać innych haseł.

Przykłady

W tym przykładzie załóżmy, że użytkownik szuka witryn podobnych do www.example.com, w których hasło to related:www.example.com.

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


Wyszukiwanie tylko tekstu, wszystkie terminy [allintext:]
Description

Zapytanie allintext: wymaga, aby każdy dokument w wynikach wyszukiwania zawierał wszystkie słowa znajdujące się w treści zapytania. Zapytanie powinno mieć format allintext: i znajdować się na nim słowa.

Jeśli zapytanie zawiera wyszukiwane hasło allintext:, Google sprawdzi tylko treść słów w zapytaniu i zignoruje linki w tych dokumentach, tytułach dokumentów i adresach URL dokumentów.

Wersja allintext: z kodem zmiany znaczenia adresu URL to allintext%3A.

Przykłady Ten przykład określa, że słowa "Google" i quot;search" muszą występować w treści wszystkich dokumentów uwzględnionych w wynikach wyszukiwania:
Dane wejściowe użytkownika:allintext:Google search
Wyszukiwane hasło:q=allintext%3AGoogle+search

Wyszukiwanie tytułów, pojedynczy termin [intitle:]
Description

Zapytanie zapytania intitle: ogranicza wyniki wyszukiwania do dokumentów zawierających określone słowo w tytule dokumentu. Zapytanie powinno mieć format intitle:WORD bez odstępu między wyszukiwanym hasłem intitle: a tym kolejnym słowem.

Uwaga: możesz określić więcej niż 1 słowo, które musi znaleźć się w tytule dokumentu. W tym celu umieść wyszukiwane hasło intitle: przed każdym z tych słów. Możesz też użyć zapytania allintitle:, aby wskazać, że wszystkie słowa zapytania muszą być uwzględniane w tytułach dokumentów znajdujących się w wynikach wyszukiwania.

Wersja intitle: z kodem zmiany znaczenia adresu URL to intitle%3A.

Przykłady

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


Wyszukiwanie tytułów, wszystkie terminy [allintitle:]
Description

Zapytanie allintitle: ogranicza wyniki wyszukiwania do dokumentów zawierających wszystkie słowa zapytania w tytule dokumentu. Aby użyć słowa zapytania allintitle:, dodaj na początku zapytania "allintitle:".

Uwaga: umieszczenie allintitle: na początku zapytania jest równoważne z umieszczeniem operatora intitle: przed każdym słowem w wyszukiwanym haśle.

Wersja allintitle: z kodem zmiany znaczenia adresu URL to allintitle%3A.

Przykłady

W tym przykładzie słowa "Google" &"search" muszą się pojawiać w tytułach dokumentów w wynikach wyszukiwania:
Dane wejściowe użytkownika: allintitle: Google search
Wyszukiwane hasło: q=allintitle%3A+Google+search


Wyszukiwanie adresów URL, pojedyncze hasło [inurl:]
Description

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 odstępu między wyszukiwanym hasłem a inurl:.

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 się znaleźć w adresie URL dokumentu, umieszczając wyszukiwane hasło inurl: przed każdym z tych słów. Możesz również użyć zapytania allinurl:, aby wskazać, że wszystkie słowa zapytania muszą być uwzględnione w adresach URL dokumentów znajdujących się w wynikach wyszukiwania.

Wersja inurl: z kodem zmiany znaczenia adresu URL to inurl%3A.

Przykłady

W tym przykładzie słowo „Google” musi znajdować się w adresach URL dowolnego dokumentu w wynikach wyszukiwania, a słowo „search"” musi występować w tytułach, adresach URL, linkach lub treści tych dokumentów:
Hasło użytkownika: q=inurl%3AGoogle+search


Wyszukiwanie adresów URL, wszystkie terminy [allinurl:]
Description

Zapytanie zapytania allinurl: ogranicza wyniki wyszukiwania do dokumentów zawierających wszystkie słowa zapytania znajdujące się w adresie URL dokumentu. Aby użyć zapytania allinurl:, dodaj allinurl: na początku zapytania.

Wyszukiwane hasło allinurl: ignoruje znaki interpunkcyjne, więc działa tylko w słowach, a nie w komponentach adresów URL. Na przykład allinurl: uk/scotland ogranicza wyniki do dokumentów zawierających w adresach URL słowa "szkoła" ale nie wymaga, aby te dwa słowa pojawiały się w określonej kolejności lub powinny być rozdzielone ukośnikami.

Wersja allinurl: z kodem zmiany znaczenia adresu URL to allinurl%3A.

Przykłady

Ten przykład określa, że słowa "Google" &"search" muszą się pojawiać w adresach URL dowolnego dokumentu w wynikach wyszukiwania:
Dane wejściowe użytkownika: allinurl: Google search
Wyszukiwane hasło: q=allinurl%3A+Google+search



Informacje o dokumencie internetowym [informacje:]
Description

Wyszukiwane hasło info: pobiera ogólne informacje o adresie URL, pod warunkiem, że znajduje się on w indeksie wyszukiwania Google. Zapytanie powinno być w formacie info:URL bez odstępu między wyszukiwanym hasłem info: a adresem URL.

Wersja info: z kodami zmiany znaczenia adresu URL to info%3A.

Uwaga: gdy używasz właściwości info:, nie możesz określać innych haseł.

Przykłady Dane wejściowe użytkownika: info:www.google.com
Wyszukiwane hasło: q=info%3Awww.google.com

Przykładowe zapytania o obraz

W poniższych przykładach pokazujemy kilka żądań HTTP obrazu, które ilustrują sposób użycia różnych parametrów zapytania. Definicje różnych parametrów zapytania znajdziesz w sekcjach Definicje parametrów zapytania w tym dokumencie.

To żądanie wymaga pierwszych 5 wyników (start=0&num=5) zapytania „"małp" (q=monkey) typu pliku .png. Zapytanie określa 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 w wyszukiwarce grafiki

as_filetype,
Description

Opcjonalnie. Zwraca obrazy określonego typu. Dozwolone wartości to bmp, gif, png, jpg i svg.

Przykłady q=google&as_filetype=png

imgsz
Description

Opcjonalnie. Zwraca obrazy o określonym rozmiarze, w którym można ustawić jedną z tych wartości:

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

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

typ obrazu
Description

Opcjonalnie. Zwraca obrazy określonego typu, które mogą być jednym z:

  • clipart (klip)
  • face (twarz)
  • lineart (liniowy)
  • news (wiadomości)
  • photo (zdjęcie)

Przykłady q=google&as_filetype=png&imgtype=photo

{/6}
Description

Opcjonalnie. Zwraca obrazy czarno-białe, tryb szarości lub kolory:

  • mono (czarno-biały)
  • gray (skala szarości)
  • color (kolor)

Przykłady q=google&as_filetype=png&imgc=gray

kolor obrazu
Description

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

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

jako_prawa
Description

Opcjonalnie. Filtry na podstawie licencji. 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ń

Wykres poniżej przedstawia ograniczenia dotyczące żądań wyszukiwania wysyłanych do Google:

Komponent Limit Komentarz
Długość zapytania 2048 bajtów  
Liczba wyszukiwanych haseł 10 obejmuje hasła w tych parametrach: q, as_epq, as_eq, as_lq, as_oq, as_q, as_rq
Liczba wyników 20 Jeśli ustawisz parametr num na 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ększyć wartość parametru start dla każdego żądania.

Międzynarodowa prezentacja 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 będzie używane do interpretacji żądania HTTP i kodowania odpowiedzi XML (przy użyciu parametrów wyszukiwania ie i oe). Możesz też filtrować wyniki, aby uwzględnić tylko dokumenty napisane w określonych językach.

W tych sekcjach opisano problemy związane z wyszukiwaniem w wielu językach:

Kodowanie znaków

Serwery, np. strony internetowe, wysyłają dane do klientów użytkownika (np. przeglądarek) w postaci zakodowanych bajtów. Klient użytkownika dekoduje bajty w sekwencję znaków. Gdy wysyłasz żądania do usługi WebSearch, możesz określić schematy kodowania zarówno dla wyszukiwanego hasła, jak i otrzymywanej odpowiedzi XML.

Aby określić mechanizm kodowania znaków w żądaniu HTTP, możesz użyć parametru żądania ie. 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), upewnij się, że określasz prawidłowe wartości parametrów ie i oe.

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

Pełną listę wartości, których możesz używać w parametrach ie i oe, znajdziesz w dodatku Schematy 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

Aby zidentyfikować język interfejsu graficznego, możesz użyć parametru żądania hl. Wartość parametru hl może wpłynąć na wyniki wyszukiwania w formacie XML, zwłaszcza w przypadku zapytań międzynarodowych, w których ograniczenie języka (korzystając z parametru lr) nie jest wyraźnie określone. W takiej sytuacji parametr hl może promować wyniki wyszukiwania w tym samym języku co język wejściowy użytkownika.

Zalecamy ustawienie parametru hl w wynikach wyszukiwania, aby mieć pewność, że Google wybiera najwyższej jakości wyniki wyszukiwania dla każdego zapytania.

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

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

Parametr żądania lr pozwala ograniczyć wyniki wyszukiwania do dokumentów napisanych w określonym języku lub zestawie języków.

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

Poniższe przykłady pokazują, jak można używać operatorów logicznych do zgłaszania próśb o dokumenty 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, które nie zostały napisane w języku węgierskim lub czeskim:

lr=(-lang_hu).(-lang_cs)

Pełną listę możliwych wartości parametru lr i operatorów logicznych znajdziesz w sekcji Operator kolekcji języka.

Chiński uproszczony i tradycyjny to 2 warianty języka chińskiego. Ten sam koncepcja może być różnie zapisywana w poszczególnych wariantach. Biorąc pod uwagę zapytanie w jednym z wariantów, usługa Google WebSearch może wyświetlić wyniki zawierające strony zawierające obie wersje.

Aby skorzystać z tej funkcji:

  1. Ustaw parametr żądania c2coff na 0.
  2. Wykonaj jedno z tych działań:
    • Nie ustawiaj parametru żądania lr.
    • Ustaw parametr żądania lr na lr=lang_zh-TW|lang_zh-CN

Poniższy przykład pokazuje parametry zapytania, które chcesz uwzględnić w żądaniu wyników w języku chińskim uproszczonym i tradycyjnym. (w przykładzie nie ma dodatkowych informacji, takich jak klient).

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

Filtrowanie wyników

Wyszukiwarka Google umożliwia filtrowanie wyników wyszukiwania na kilka sposobów:

Automatyczne filtrowanie wyników wyszukiwania

Aby zapewnić jak najlepsze wyniki wyszukiwania, Google stosuje 2 metody automatycznego filtrowania wyników, które są na ogół niechciane:

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

  • Całkowicie host – jeśli jest wiele wyników wyszukiwania z tej samej witryny, Google może nie pokazywać wszystkich wyników z tej witryny lub wyświetlać je niżej w rankingu
    niż zwykle.

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

Filtrowanie według języka i kraju

Usługa Google WebSearch zwraca wyniki z indeksu głównego wszystkich dokumentów internetowych. Indeks główny zawiera kolekcje podrzędne dokumentów 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 dokumentów napisanych w określonych językach lub pochodzących odpowiednio z określonych krajów.

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

  • domenę najwyższego poziomu (TLD) adresu URL dokumentu.
  • metatagi w dokumencie
  • główny język, który jest używany w treści dokumentu;


Definicję parametru lr znajdziesz też w sekcji Wyszukiwanie dokumentów napisanych w określonych językach i Wartości kolekcji języka, których można użyć jako wartości parametru lr, aby dowiedzieć się więcej o ograniczaniu wyników na podstawie języka.

Wyszukiwarka Google określa kraj dokumentu na podstawie analizy:

  • domenę najwyższego poziomu (TLD) adresu URL dokumentu.
  • lokalizacja geograficzna serwera IP serwera WWW

Zapoznaj się też z definicją parametru cr oraz wartości kolekcji krajów, których można użyć jako wartości parametru cr, aby dowiedzieć się więcej o ograniczaniu wyników według kraju pochodzenia.

Uwaga: możesz dostosowywać wartości języka i kraju, aby dostosować wyniki wyszukiwania. Możesz na przykład poprosić o dokumenty utworzone w języku francuskim i pochodzące z Francji lub Kanady. Możesz też poprosić o dokumenty z Holandii, które nie zostały utworzone w języku angielskim. Parametry lr i cr obsługują operatory logiczne.

Filtrowanie treści dla dorosłych za pomocą filtra SafeSearch

Wielu klientów Google nie chce wyświetlać wyników wyszukiwania dla witryn zawierających treści dla dorosłych. Korzystając z filtra SafeSearch, możesz filtrować wyniki wyszukiwania pod kątem treści dla dorosłych i eliminować je. Filtry Google korzystają z zastrzeżonej technologii do sprawdzania słów kluczowych, wyrażeń i adresów URL. Chociaż żaden filtr nie jest skuteczny w 100%, filtr SafeSearch usunie zdecydowaną większość treści dla dorosłych z wyników wyszukiwania.

Zależy nam, aby filtr SafeSearch był aktualny i jak najbardziej skuteczny, cały czas skanując internet i włączając aktualizacje z 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

Możesz dostosować stopień, w jakim Google filtruje wyniki pod kątem treści dla dorosłych, korzystając z parametru zapytania safe (bezpieczne). W tabeli poniżej przedstawiono ustawienia Google SafeSearch i ich wpływ na wyniki wyszukiwania:

Poziom filtra SafeSearch Opis
wysoki Włącza bardziej rygorystyczną wersję bezpiecznego wyszukiwania.
medium Blokuje strony internetowe zawierające treści pornograficzne lub inne treści o charakterze seksualnym.
wył. Nie filtruje treści dla dorosłych z wyników wyszukiwania.

* Domyślne ustawienie filtra SafeSearch jest wyłączone.

Jeśli masz włączony filtr SafeSearch i w wynikach wyszukiwania znajdziesz strony zawierające obraźliwe treści, wyślij e-maila na adres safesearch@google.com, a my zbadamy sprawę.

Wyniki w formacie XML

Wyniki wyszukiwania Google dla XML XML

Do opisywania formatu XML dla wszystkich typów wyników wyszukiwania Google używa tego samego DTD. Wiele tagów i atrybutów ma zastosowanie do wszystkich typów wyszukiwania. Niektóre tagi mają jednak zastosowanie tylko do określonych typów wyszukiwania. Oznacza to, że definicje w DTD mogą być mniej restrykcyjne niż definicje w tym dokumencie.

W tym dokumencie opisujemy te aspekty DTD, które są istotne dla usługi WebSearch. Podczas pracy w usłudze WebSearch możesz zignorować tagi i atrybuty, które nie są tutaj opisane. Jeśli definicja różni się od DTD i dokumentacji, w tym dokumencie znajdziesz informację o tym fakcie.

Google może zwrócić wyniki w formacie XML z odwołaniem do ostatniego pliku DTD lub bez niego. DTD to przewodnik, który pomoże administratorom wyszukiwarki i parserom XML zrozumieć wyniki w formacie XML Google. Ponieważ gramatyka XML Google może się co jakiś czas zmieniać, nie należy konfigurować parsera do używania DTD do weryfikowania każdego wyniku XML.

Poza tym nie należy konfigurować parsera XML, aby pobierać DTD za każdym razem, gdy przesyłasz żądanie wyszukiwania. Google rzadko aktualizuje DTD. Te żądania generują niepotrzebne opóźnienia i wymagania dotyczące przepustowości.

Jeśli chcesz uzyskać wyniki w formacie XML, zalecamy użycie formatu wyjściowego xml_no_dtd. Jeśli w żądaniu wyszukiwania określisz format xml output, jedyna różnica polega na uwzględnieniu takiego wiersza w wynikach wyszukiwania XML:

<!DOCTYPE GSP SYSTEM "google.dtd">

Najnowszą usługę DTD znajdziesz na http://www.google.com/google.dtd.

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

Informacje o odpowiedzi XML

  • Wszystkie wartości elementów są prawidłowymi kodami HTML odpowiednimi do wyświetlania, chyba że w definicjach tagów XML podano inaczej.
  • Niektóre wartości elementów to adresy URL, które trzeba zakodować w HTML, zanim zostaną wyświetlone.
  • Parser XML powinien ignorować nieudokumentowane atrybuty i tagi. Dzięki temu aplikacja będzie mogła działać bez modyfikacji, jeśli Google doda do interfejsu XML więcej funkcji.
  • Niektóre wartości muszą mieć zmienione znaczenie, jeśli są uwzględnione jako wartości w tagach XML. Twój procesor XML powinien przekonwertować te encje na odpowiednie znaki. Jeśli nie zrobisz tego prawidłowo, przeglądarka może na przykład wyrenderować znak & &amp;". standardowa XML dokumentuje te znaki. Te znaki są powielane w tabeli poniżej:

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

Wyniki wyszukiwania XML dla zwykłych i zaawansowanych zapytań

Standardowe lub zaawansowane wyszukiwanie: przykładowe zapytanie i wynik w formacie XML

W tej przykładowej prośbie o wyszukiwarkę szukamy 10 wyników (num=10) wyszukiwanych haseł "socer" (q=socer, które w tym przykładzie zawierają błędną pisownię "soccer").

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 powoduje wyświetlenie wyniku XML poniżej. W wynikach wyszukiwania XML może być kilka komentarzy na temat miejsc, w których powinny się pojawić określone tagi.

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

Standardowe lub zaawansowane wyszukiwanie: tagi XML

Odpowiedzi XML dla zwykłych żądań wyszukiwania i żądań zaawansowanych używają tego samego zestawu tagów XML. Te tagi XML są widoczne w powyższym przykładzie w formacie XML i zostały wyjaśnione w tabelach poniżej.

Poniższe tagi XML są ułożone alfabetycznie według nazwy tagu. Każda definicja tagu zawiera jego opis, przykład pokazujący sposób wyświetlania tagu w wynikach XML oraz format tagu. Jeśli tag jest subtagiem innego tagu XML lub ma on swoje podrzędne albo atrybuty, te informacje są również podane w tabeli definicji tagu.

Przy niektórych podtagach w definicjach mogą wyświetlać się niektóre symbole. Znajdziesz je poniżej wraz z informacją o znaczeniu.

? = opcjonalny subtag
* = co najmniej jedno wystąpienie tagu podrzędnego
+ = co najmniej jedno wystąpienie tagu podrzędnego
P D P G P I P N P P R Informacje o stanie kampanii C X

tekst_kotwicy
Definicja

Tag <Anchor_text> określa tekst, który ma być wyświetlany użytkownikom, aby można było zidentyfikować etykietę etykietki powiązaną z zestawem wyników wyszukiwania. Etykiety zawężenia zastępują znaki niealfanumeryczne ze znakami podkreślenia, więc w interfejsie użytkownika nie należy wyświetlać wartości tagu <label>. Zamiast tego powinna wyświetlić się wartość tagu <zakotwicz_tekst>.

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

ZABLOKUJ
Definicja

Ten tag obejmuje zawartość bloku w treści strony wyników promocji. Każdy blok zawiera subtagi T, U i L. Niepusty tag T oznacza, że blok zawiera tekst. Niepuste tagi U i L oznaczają, że link zawiera link (z adresem URL podanym w subtagu U i tekście kotwicy w subtagu L).

Subtagi T, U, L
Subtag TREŚĆ_ELEMENTU
Format treści Pusta

GŁÓWNA_LINE
Definicja

Ten tag zawiera treść wiersza w treści promowanego wyniku. Każdy wiersz tekstu składa się z kilku tagów BLOCK, 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 wyniku wyszukiwania z pamięci podręcznej. Za pomocą interfejsu XML API nie można pobierać stron z pamięci podręcznej, ale możesz przekierować użytkowników na stronę www.google.com dotyczącą tych treści.

Atrybuty
Nazwa Format Opis
SZ Tekst (liczba całkowita + "k") Określa rozmiar wersji wyników wyszukiwania z 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:texttext:EscapeURL

URL ze zmianą znaczenia jest dostępny w tagu UE.

Przykład <C SZ="6k" CID="kvOXK_cYSSgJ" />
Subtag HAS
Format treści Pusta

C2C,
Definicja Tag <C2C> wskazuje, że wynik odnosi się do strony w języku chińskim tradycyjnym. Ten tag pojawia się tylko wtedy, gdy włączono wyszukiwanie tradycyjne i chińskie. 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ężeń wyszukiwania powiązanych z zestawem wyników wyszukiwania.

Przykład <Kontekst<gt;
Subtagi tytuł, Facet+
Format treści Kontener

CRAWLDATE
Definicja

Tag <CRAWLDATE> określa datę ostatniego indeksowania strony. Funkcja CRAWLDATE nie jest zwracana 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) dla pojedynczego wyniku wyszukiwania.

Przykład <D>
Subtagi TT?, DS?
Subtag HAS
Format treści Pusta

DS
Definicja

Tag <DS> zawiera podsumowanie poszczególnych kategorii w katalogu ODP.

Przykład <DS>Publikuj wyniki w &&;;lt;b&gt;soccer&lt;/b&gt; wznów bezpośrednio w internecie.</DS>
Subtag DI
Format treści Tekst (może zawierać HTML)

DT
Definicja

Tag <DT> określa tytuł pojedynczej kategorii wymienionej w katalogu ODP.

Przykład <DT>SoccerConnection.net</DT>
Subtag DI
Format treści Tekst (może zawierać HTML)

Aspekt
Definicja

Tag <Facet> zawiera logiczne grupowanie <FacetItem>. Te grupy możesz tworzyć, korzystając z formatu specyfikacji XML wyszukiwarki niestandardowej. Jeśli nie utworzysz tych grup, tag wyników_xml_tag_Kontekst><Context> będzie zawierał maksymalnie 4 tagi <Facet>. Elementy każdego tagu <Facet> zostaną zgrupowane na potrzeby wyświetlania, ale mogą nie być logicznie powiązane.

Przykład <Facet>
Subtagi FacetItem+, title+
Subtag Kontekst
Format treści Kontener

Element aspektów
Definicja

Tag <FacetItem> zawiera informacje o etykietie zawężenia wyszukiwania powiązanej z zestawem wyników wyszukiwania.

Przykład <FacetItem>
Subtagi label, tekst_zakotwiczenia+
Subtag Twarz
Format treści Element aspektów

FI
Definicja Tag <FI> służy jako flaga wskazująca, czy podczas wyszukiwania zostało wykonane filtrowanie dokumentów. Więcej informacji o filtrach wyników wyszukiwania w Google znajdziesz w sekcji Automatyczne filtrowanie.
Przykład <FI />
Subtag RES
Format treści Pusta

GSP
Definicja

Tag <GSP> zawiera wszystkie dane zwrócone w wynikach wyszukiwania Google w formacie XML. "GSP" to skrót od "protokołu wyszukiwania Google.

Atrybuty
Nazwa Format Opis
Certyfikat VER 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

MA
Definicja Tag <HAS> zawiera informacje o wszystkich specjalnych parametrach żądania wyszukiwania obsługiwanych w przypadku danego adresu URL.

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

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

ISURL
Definicja Google zwraca tag <ISURL>, jeśli powiązane zapytanie jest adresem URL.
Subtag GSP
Format treści Pusta

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

etykieta
Definicja

Tag <label> określa etykietę zawężenia, która służy do filtrowania otrzymanych wyników wyszukiwania. Aby użyć etykiety zawężającej, dodaj do ciągu znaków more:[[wartość tagu etykiety]] wartość parametru q w żądaniu HTTP, jak pokazano w poniższym przykładzie. Pamiętaj, że przed wysłaniem zapytania do Google ta wartość musi zawierać kody zmiany znaczenia.

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> różni się od tagu <Label>, który identyfikuje etykietę zawężenia wyszukiwania powiązaną z określonym adresem URL w wynikach wyszukiwania.

Przykład <label>golf_courses</label>
Subtag FacetItem
Format treści Tekst

RUB
Definicja

Tag <lang> zawiera język najbardziej prawdopodobnego wyniku wyszukiwania Google.

Przykład <lang&plten
Subtag R
Format treści Tekst

M
Definicja

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

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

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

NB
Definicja

Tag <NB> zawiera informacje nawigacyjne, które prowadzą do następnej strony wyników wyszukiwania lub poprzedniej strony wyników wyszukiwania.

Uwaga: ten tag występuje tylko wtedy, gdy jest dostępnych więcej wyników.

Przykład <NB>
Subtagi NU? PU?
Subtag RES
Format treści Pusta

pn.-zach.
Definicja

Tag <NU> zawiera względny link do następnej strony wyników wyszukiwania.

Przykład <NU>/search?q=kwiaty&num=10&hl=pl&ie=UTF-8
&output=xml&client=test&start=10</NU>
Subtag Nie dotyczy
Format treści Tekst (względny URL)

PARAMETRY
Definicja

Tag <PARAM> identyfikuje parametr danych wejściowych przesłany w żądaniu HTTP powiązanym z wynikiem XML. Informacje o tym parametrze znajdują się w atrybutach tagów (nazwa, wartość, pierwotna wartość) i po jednym tagu PARAM dla każdego parametru przesłanego w żądaniu HTTP.

Atrybuty
Nazwa Format Opis
name Tekst Nazwa parametru wejściowego.
value HTML; Wersja wejściowa wartości parametru wejściowego w formacie HTML.
wartość_oryginalna Tekst Oryginalna wartość parametru ze zmianą adresu URL.
Przykład <PARAMNamequoquo;cr" value="countryNZ" original_value="countryNZ" />
Subtag GSP
Format treści Złożony

PU
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 Nie dotyczy
Format treści Tekst (względny URL)

Q
Definicja

Tag <Q> określa wyszukiwane hasło przesłane w żądaniu HTTP powiązanym z wynikiem XML.

Przykład

<Q>pizza</Q>

Subtag GSP
Format treści Tekst

C
Definicja

Tag <R> zawiera szczegóły pojedynczego wyniku wyszukiwania.

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

Atrybuty
Nazwa Format Opis
N Tekst (liczba całkowita) Wskazuje indeks (oparty na 1) tego wyniku wyszukiwania.
MIME Tekst Wskazuje typ MIME wyniku wyszukiwania.
Subtagi U, UE, T?, CRAWLDATE, S?, lang?, HAS
Subtag RES

RES
Definicja

Tag <RES> zawiera zestaw pojedynczych wyników wyszukiwania i szczegóły tych wyników.

Atrybuty
Nazwa Format Opis
SN Tekst (liczba całkowita) Wskazuje indeks (na podstawie 1) pierwszego wyniku wyszukiwania w tym zestawie wyników.
PL Tekst (liczba całkowita) Wskazuje indeks (na podstawie 1) ostatniego wyniku wyszukiwania zwróconego w tym zestawie wyników.
Przykład <RES SN="1" EN="10">
Subtagi M, FI?, XT?, NB?, R*
Subtag GSP
Format treści Pusta

RT
Definicja Obecność tagu <RT> wskazuje, że usługa WebSearch może znaleźć zestaw stron internetowych podobnych do tego adresu URL wyników wyszukiwania. Aby znaleźć ten zestaw stron internetowych, użyj hasła powiązanego :.
Subtag HAS
Format treści Pusta

s
Definicja

Tag <S> zawiera fragment wyniku wyszukiwania przedstawiający wyszukiwane hasła pogrubioną czcionką. Aby zapewnić prawidłowe zawijanie tekstu, podział wierszy jest dodawany we fragmencie.

Przykład <S>Washington (CNN) – stawka za zakończenie wyborów do Senatu, przejętą przez prezydenta i
Subtag R
Format treści Tekst (HTML)

SL_MAIN (Główna)
Definicja

Ten tag zawiera treść wyniku promocji. Służy do analizowania promocji. Tekst kotwicy i adres URL linku z tytułem znajdują się odpowiednio w tagach T i U. Wiersze tekstu i linków są umieszczone w subtagach body_LINE.

Subtagi TREŚĆ_LISTY*, T, U
Subtag SL_RESULTS
Format treści Pusta

WYNIKI_SLAJD
Definicja

Tag kontenera dla promowanych wyników. Jeden z nich pojawi się w wynikach wyszukiwania, jeśli masz promocję. Subtag SL_MAIN zawiera główne dane wyników.

Subtagi SL_MAIN*
Subtag R
Format treści Pusta

Pisownia
Definicja

Tag < poprawy pisowni> 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 dotyczące zapytań, w przypadku których wartość parametru gl jest zapisana małymi literami.

Przykład <Pisownia>
Subtagi Sugestia
Subtag GSP
Format treści Pusta

Sugestia
Definicja Tag <Suggestion> zawiera alternatywną sugestię pisowni dla przesłanego zapytania. Aby wskazać alternatywną pisownię hasła, możesz użyć treści tagu. Wartość atrybutu q to sugestia pisowni związana ze zmianą znaczenia za pomocą adresu URL, której można użyć jako hasła zapytania.
Atrybuty
Nazwa Format Description
q Tekst Atrybut q określa wersję pisowni ze zmianą znaczenia w adresie URL.
Przykład <Zaproponuj
Subtag Pisownia
Format treści Tekst (HTML)

T
Definicja Tag <T> zawiera tytuł wyniku.
Przykład <T>Amici&p.' Pizzeria Wschodnia
Subtag R
Format treści Tekst (HTML)

tytuł
Definicja

Jako element podrzędny tagu <Context> tag <title> zawiera nazwę Twojej Wyszukiwarki niestandardowej.

Jako element podrzędny tagu <Facet> tag <title> określa tytuł zestawu aspektów.

Przykład

Jako element podrzędny elementu <Context>: <title>My Search</title>

Jako element podrzędny elementu <Facet>: <title>facet</title>

Subtag Kontekst, twarz
Format treści Tekst

TM
Definicja

Tag <TM> określa całkowity czas serwera potrzebny do zwrócenia wyników wyszukiwania, mierzony w sekundach.

Przykład <TM>0.100445</TM>
Subtag GSP
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 przypadku większości przeglądarek naciskanie klawisza Return powoduje uzyskanie takich samych wyników jak kliknięcie przycisku wyszukiwania.&lt;/i&gt;</TT>
Subtag GSP

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

UD
Definicja

Tag <UD> zawiera URL wyniku wyszukiwania z kodowaniem IDN. Ta wartość umożliwia wyświetlanie domen w językach lokalnych. Na przykład adres URL zakodowany przez 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: funkcja jest 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 przez IDN)

UE
Definicja Tag <UE> zawiera adres URL wyniku wyszukiwania. Wartość jest objęta zmianą znaczenia, więc może być przekazywana jako parametr zapytania w adresie URL.
Przykład <UE>http://www.dominos.com/</UE>
Subtag R
Format treści Tekst (adres URL ze zmianą znaczenia)

x
Definicja Tag <XT> wskazuje szacowaną łączną liczbę wyników określoną w tagu M, która w rzeczywistości stanowi dokładną łączną liczbę wyników. Więcej informacji znajdziesz w sekcji Automatyczne filtrowanie w tym dokumencie.
Przykład <XT />
Subtag RES
Format treści Pusta


Wyniki XML dla zapytań dotyczących grafiki

To przykładowe żądanie obrazu dotyczy 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 powoduje wyświetlenie wyniku XML poniżej.


<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

Poniższa tabela zawiera dodatkowe tagi XML używane w odpowiedziach XML w zapytaniach o grafikę.

Przy niektórych podtagach w definicjach mogą wyświetlać się niektóre symbole. Znajdziesz je poniżej wraz z informacją o znaczeniu.

? = opcjonalny subtag
* = co najmniej jedno wystąpienie tagu podrzędnego
+ = co najmniej jedno wystąpienie tagu podrzędnego

RG
Definicja

Tag <RG> zawiera szczegółowe informacje o pojedynczym wyniku wyszukiwania grafiki.

Atrybuty
Nazwa Format Opis
N Tekst (liczba całkowita) Wskazuje indeks (oparty na 1) tego wyniku wyszukiwania.
MIME Tekst Wskazuje typ MIME wyniku wyszukiwania.
Subtag RES
RU
Definicja

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

Subtag R