Dokumentacja interfejsu API w formacie XML

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

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

Omówienie

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

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

Format żądania WebSearch

Żądanie – informacje

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

Wyszukiwane hasła

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

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

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

Domyślna wyszukiwarka

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

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

q=horses+cows+pigs

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

Parametry żądania

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

Wymagane są 3 parametry żądania:

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

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

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

Przykładowe zapytania internetowe

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

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

http://www.google.com/search?
  start=0
  &num=10
  &q=red+sox
  &cr=countryCA
  &lr=lang_fr
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

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

http://www.google.com/search?
  start=0
  &num=10
  &as_q=red+sox
  &as_eq=Yankees
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

Definicje parametrów zapytania w wyszukiwarce Google

c2coff
Opis

Opcjonalnie. Parametr c2coff włącza i wyłącza uproszczony widok oraz wyszukiwanie w języku chińskim tradycyjnym.

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

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

klient
Opis

Wymagany. Parametr client musi mieć 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. Możesz użyć wartości logicznej operatorów w parametrze cr .

Google WebSearch określa kraj dokumentu na podstawie analizowanie:

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

Zobacz parametr kraju (cr) Sekcja Wartości zawierająca listę prawidłowych wartości tego parametru.
Przykłady q=Frodo&cr=countryNZ

CCX
Opis

Wymagany. Parametr cx określa unikalny kodu, który identyfikuje niestandardowy wyszukiwarki. Aby pobierać wyniki wyszukiwania z tej wyszukiwarki, musisz użyć parametru cx.

Aby znaleźć wartość parametru cx, otwórz Panel sterowania > Kody karty w wyszukiwarce. w sekcji „Wklej ten kod na stronie, na której ma się znajdować pole wyszukiwania . Wyniki wyszukiwania będą wyświetlane na stronie hostowanej przez Google.
Przykłady q=Frodo&cx=00255077836266642015:u-scht7a-8i

filtr
Opis

Opcjonalnie. Parametr filter aktywuje się lub dezaktywuje automatyczne filtrowanie wyników wyszukiwania Google. Zapoznaj się z sekcją Automatyczne filtrowanie w tym artykule. dokumentu, w którym można znaleźć więcej informacji na temat filtrów wyników wyszukiwania Google.

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

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

Uwaga: domyślnie Google stosuje filtry do wszystkich w celu poprawy jakości tych wyników.
Przykłady q=google&filter=0

gl
Opis

Opcjonalnie. Wartość parametru gl to dwuliterowy kod kraju. W przypadku wyników wyszukiwania w internecie parametr gl zwiększa wyniki wyszukiwania, których kraj pochodzenia pasuje do . Lista prawidłowych wartości znajduje się w sekcji Kody krajów.

Określanie wartości parametru gl w żądaniach WebSearch powinno zwiększyć trafność wyników. Jest to szczególnie istotne w przypadku klientów międzynarodowych, a dokładniej: klientów z krajów anglojęzycznych innych niż Stany Zjednoczone.
Przykłady

Ta prośba o zwiększenie liczby dokumentów napisanych w Wielkiej Brytanii w języku Wyniki wyszukiwania w internecie:
q=pizza&gl=uk

hl
Opis

Opcjonalnie. Parametr hl określa język interfejsu (język hosta). Poprawa wyników wydajności i jakości wyników wyszukiwania, zdecydowanie zalecamy ustawienie tego parametru wprost.

Zobacz sekcję Języki interfejsu w artykule Internacjonalizacja zapytań. i prezentacji wyników, aby uzyskać więcej informacji i obsługi języków interfejsu. aby zobaczyć listę obsługiwanych języków.
Przykłady

To żądanie jest kierowane na reklamy wina w języku francuskim. (Vin to czyli francuskie określenie wina).

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

wysoka jakość
Opis

Opcjonalnie. Parametr hq dołącza określone hasła zapytania do zapytanie, tak jakby były one połączone za pomocą operatora logicznego AND.

Przykłady

To żądanie wyszukuje hasło „pizza” I „ser”. Wyrażenie jest takie samo jak q=pizza+cheese.

q=pizza&hq=cheese

ie
Opis

Opcjonalnie. Parametr ie ustawia znak schemat kodowania, który powinien być używany do interpretacji ciągu zapytania. domyślna wartość parametru ie to latin1.

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

Więcej informacji znajdziesz w sekcji Kodowanie znaków Sekcja Schematy, w której znajdziesz listę możliwych wartości ie.
Przykłady q=google&ie=utf8&oe=utf8
lr
Opis

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

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

  • domena najwyższego poziomu (TLD) adresu URL dokumentu,
  • metatagi języka w dokumencie
  • głównego języka użytego w tekście dokumentu.
  • języki dodatkowe użyte w tekście dokumentu (jeśli występują).

Zobacz Język (lr) sekcji wartości kolekcji, gdzie znajdziesz listę prawidłowych wartości dla tego .
Przykłady q=Frodo&lr=lang_en

numer
Opis

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

Domyślną wartością parametru num jest 10, a maksymalna wynosi 20. Jeśli poprosisz o więcej niż 20 wyników, tylko 20 wyniki.

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

Oe
Opis

Opcjonalnie. Parametr oe ustawia znak schemat kodowania, który powinien być używany do dekodowania wyniku XML. domyślna wartość parametru oe to latin1.

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

Więcej informacji znajdziesz w sekcji Kodowanie znaków Sekcja Schematy, w której znajdziesz listę możliwych wartości oe.
Przykłady q=google&ie=utf8&oe=utf8

output
Opis

Wymagany. Parametr output określa format wyników XML. Jedyna poprawna wartości tego parametru to xml i xml_no_dtd. Wykres poniżej wyjaśnia, czym różnią się te wartości parametrów.

Wartość Format wyjściowy
xml_no_dtd Wyniki XML nie będą zawierać Instrukcja !DOCTYPE. (Zalecane)
xml Wyniki XML zawierają tag Google Odniesienie do DTD. Drugi wiersz wyniku wskaże dokument. typ definicji (DTD), którego używają wyniki: 
    <!DOCTYPE GSP SYSTEM "google.dtd">
Przykłady output=xml_no_dtd
output=xml

q
Opis

Opcjonalnie. Parametr q określa wyszukiwanie wprowadzone przez użytkownika. Mimo że ten parametr jest opcjonalny, musi określać wartość co najmniej jednego z parametrów zapytania (as_epq, as_lq, as_oq, as_q); , aby zobaczyć wyniki wyszukiwania.

Istnieje też wiele specjalnych haseł, które można stosować jest używane w parametrze q . Listę i definicje tych terminów znajdziesz w sekcji Specjalne hasła wyszukiwania.

Panel sterowania wyszukiwarki Google zawiera raport dotyczący zapytań przesłanych za pomocą parametru q.

Uwaga: wartość podana dla parametru q musi zawierać kod zmiany znaczenia.
Przykłady q=vacation&as_oq=london+paris

bezpieczeństwo
Opis

Opcjonalnie. Parametr safe wskazuje, jak należy filtrować wyniki wyszukiwania pod kątem treści dla dorosłych i na treściach pornograficznych. 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 bardziej rygorystyczną wersję filtra SafeSearch

Przeczytaj sekcję Filtrowanie treści dla dorosłych z filtrem SafeSearch, aby dowiedzieć się więcej o tej funkcji.
Przykłady q=adult&safe=high

rozpocznij
Opis

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

Parametr start działa w: spójnik z parametrem num, który określa które wyniki wyszukiwania mają zwrócić. Pamiętaj, że dla zapytania nie zostanie nigdy zwróconych więcej niż 1000 wyników, nawet jeśli do zapytania pasuje więcej niż 1000 dokumentów. Jeśli więc ustawisz wartość początkową na 1000 lub więcej, nie będzie żadnych wyników.
Przykłady start=10

sortuj
Opis

Opcjonalnie. Parametr sort określa, że wyniki mają być sortowane zgodnie z podanym wyrażeniem. Na przykład posortuj je według daty.
Przykłady

sort=date

ud
Opis

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

http://www.花井鮨.com

Prawidłowe wartości tego parametru to 1 (domyślnie), co oznacza, że wynik XML powinien obejmują adresy URL zakodowane przez IDN oraz 0, co oznacza, że wynik XML nie powinien zawierać zakodowanych przez IDN Adresy URL. Jeśli parametr ud ma wartość 1, URL zakodowany przez IDN będzie widoczny w w tagu UD w wynikach XML.

Jeśli parametr ud ma wartość 0, adres URL z przykładu powyżej będzie miał postać wyświetlany jako:

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

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

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



Parametry zapytania wyszukiwania zaawansowanego

as_dt
Opis

Opcjonalnie. Parametr as_dt określa, czy , aby uwzględnić lub wykluczyć wyniki z witryny wymienionej w parametrze as_sitesearch. wartości i i e oznaczają odpowiednio uwzględnianie i wykluczanie.
Przykłady as_dt=i,as_dt=e

as_epq
Opis

Opcjonalnie. Parametr as_epq określa które musi zawierać wszystkie dokumenty w wynikach wyszukiwania. Dostępne opcje użyj też hasła z wyszukiwaniem frazy, aby wyszukaj wyrażenie.
Przykłady as_epq=abraham+lincoln

as_eq
Opis

Opcjonalnie. Parametr as_eq identyfikuje słowo lub wyrażenie, które nie powinno się pojawić w żadnym dokumencie w wynikach wyszukiwania wyników. Możesz też użyć zapytania wyklucz w celu zagwarantowania, że dane słowo lub wyrażenie nie pojawi się w dokumenty w zestawie wyników wyszukiwania.
Przykłady

q=bass&as_eq=music.

as_lq
Opis

Opcjonalnie. Parametr as_lq określa, że wszystkie wyniki wyszukiwania powinny zawierać link do określonego adresu URL. Możesz też dla tego typu zapytań użyj hasła link:.

Przykłady

as_lq=www.google.com

as_nlo
Opis

Opcjonalnie. Parametr as_nlo określa wartość początkową dla parametru zakres wyszukiwania. Użyj wyrażeń as_nlo i as_nhi, aby dołączyć wyszukiwanie uwzględniające warunki zakresu as_nlo...as_nhi do zapytania.

Przykłady

Poniżej ustawiany jest 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 as_nlo i as_nhi, aby dołączyć element uwzględniającego zakres wyszukiwania as_nlo...as_nhi do zapytania.
Przykłady

Poniżej ustawiany jest zakres wyszukiwania od 5 do 10 włącznie:

as_nlo=5&as_nhi=10
as_oq
Opis

Opcjonalnie. Parametr as_oq udostępnia dodatkowe wyszukiwane hasła do sprawdzenia w dokumencie, przy czym każdy dokument musi zawierać co najmniej jeden z dodatkowych elementów wyszukiwane hasła. Możesz też użyć zapytania Wartość logiczna LUB w przypadku tego typu zapytania.
Przykłady

q=vacation&as_oq=London+Paris

as_q
Opis

Opcjonalnie. Parametr as_q umożliwia wyszukiwanie do sprawdzenia w dokumencie. Parametr ten jest również często stosowany aby umożliwić użytkownikom określenie dodatkowych haseł do wyszukania w obrębie zestawu wyników wyszukiwania.
Przykłady

q=president&as_q=John+Adams

as_qdr
Opis

Opcjonalnie. Parametr as_qdr prosi o wyszukiwanie wyników z określonego okresu (krótki zakres dat). Obsługiwane są te wartości:

d[number] żąda wyników z określonej liczby ostatnich dni.
Wyniki żądania w[number] z określonej liczby ubiegłych tygodni.
Wyniki żądania m[number] pochodzą z określonej liczby ostatnich miesięcy.
Wyniki żądania y[number] pochodzą z określonej liczby ubiegłych lat.
Przykłady

W tym przykładzie żądamy wyników z ostatniego roku:

as_qdr=y

W tym przykładzie żądamy wyników z ostatnich 10 dni:

as_qdr=d10
as_sitesearch
Opis

Opcjonalnie. Parametr as_sitesearch pozwala określić, że wszystkie wyniki wyszukiwania powinny być stronami z konkretnej witryny. Ustawiając parametr as_dt, możesz go też używać do wykluczania stron danej witryny z wyników wyszukiwania.
Przykłady

q=vacation&as_sitesearch=www.google.com

Specjalne hasła w zapytaniach

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

Linki wsteczne [link:]
Opis

Wyszukiwane hasło link: pobiera zestaw stron internetowych które odsyłają do konkretnego adresu URL. Wyszukiwane hasło powinno mieć format link:URL, bez spacji między znakiem zapytania link: a adresem URL.

Wersja link: ze zmianą znaczenia w adresie URL to link%3A.

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

Uwaga: nie możesz podać żadnych innych haseł, gdy za pomocą funkcji link:.
Przykłady

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

Wartość logiczna LUB wyszukiwanie [ LUB ]
Opis

Zapytanie OR pobiera dokumenty, które zawierają jeden serii (co najmniej 2 haseł). Aby używać zapytania OR hasła, wyszukiwane hasło OR musi być zapisane wielkimi literami między każdym wyrazem w serii.

Możesz też użyć żądania as_oq , aby przesłać wyszukiwanie dowolnego hasła ze zbioru haseł.

Uwaga: jeśli określa zapytanie „Londyn+LUB+Paryż”, wyniki wyszukiwania będą obejmowały dokumenty zawierające co najmniej jedno z tych dwóch 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 Wyszukiwane hasło: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 czekoladek:

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

Wyszukaj wakacje, czekoladki i Londyn lub paryż, czekoladę z jak najmniejszą wagą:

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

Szukaj wakacji, czekoladek i kwiatów w dokumentach, które zawierają również Londyn lub Paryż:

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

Szukaj wakacji oraz jednego z Londynu lub Paryża, a następnie wyszukaj dla czekolady lub kwiatów:

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

Wyklucz wyszukiwane hasło [-]
Opis

Zapytanie wykluczające (-) ogranicza wyniki dla konkretnego żądania wyszukiwania dokumentów, które nie zawierają konkretnego słowa lub wyrażenia. Aby użyć wykluczającego wyszukiwanego hasła, należy na początku słowo lub wyrażenie, które ma zostać wykluczone z pasujących dokumentów ze znakiem „-” (znak minusa).

Wersja - ze zmianą znaczenia w adresie URL to %2D.

Wykluczające wyszukiwane hasło jest przydatne, gdy wyszukiwane hasło obejmuje więcej niż jedno znaczenie. Na przykład: „bas” może zwrócić wyniki o rybach lub muzyce. Jeśli szukałeś(-aś) dokumentów na temat: możesz wykluczyć z wyników wyszukiwania dokumenty związane z muzyką za pomocą wykluczającego wyszukiwanego hasła.

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

Wykluczenie typu pliku [ -filetype: ]
Opis

Zapytanie -filetype: wyklucza dokumenty z określonego rozszerzenia pliku, na przykład „.pdf”; lub „.doc” z wyszukiwarki wyników. Zapytanie powinno być w formacie -filetype:EXTENSION bez spacji między znakiem zapytania -filetype: a parametrem z określonym rozszerzeniem.

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

Uwaga: możesz wykluczyć wiele elementów. typy plików z wyników wyszukiwania, dodając więcej zapytań -filetype: do wyszukiwanego hasła. Musisz mieć 1 zapytanie -filetype: w zapytaniu 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)
  • Lotos 1-2-3 (tydzień 1, tydzień 2, tydzień 3, tydzień 4, tydzień 5, tydzień, tydzień, tydzień)
  • Lotus WordPro (LWP)
  • Macwrite (MW)
  • Microsoft Excel (xls),
  • Microsoft PowerPoint (ppt),
  • Microsoft Word (dokument)
  • Microsoft Works (WKS, WPS, WDB)
  • Microsoft Write (wri)
  • Tekst sformatowany RTF (RTF)
  • Shockwave Flash (SWF)
  • Tekst (ans, txt).

W przyszłości możemy dodać więcej typów plików. Jest aktualna znajdziesz w najczęstszych pytaniach na temat typów plików w Google.
Przykłady

Ten przykład zwraca dokumenty, w których występuje słowo „Google”. ale że tam nie są dokumentami PDF:
q=Google+%2Dfiletype%3Apdf

Ten przykład zwraca dokumenty, w których występuje słowo „Google”. ale nie obejmuje dokumentów PDF ani Worda:
q=Google+%2Dfiletype%3Apdf+%2Dfiletype%3Adoc

Filtrowanie typu pliku [ filetype: ]
Opis

Zapytanie filetype: ogranicza wyniki wyszukiwania do dokumenty z określonym rozszerzeniem, np. „.pdf”; lub „.doc”. Zapytanie powinno mieć format filetype:EXTENSION z parametrem brak spacji między wyszukiwanym hasłem filetype: a określonym .

Wersja filetype: ze zmianą znaczenia w adresie URL to filetype%3A.

Możesz ograniczyć wyszukiwanie do dokumentów pasujących do jednego z kilku rozszerzeń plików, dodając filetype: dodatkowe hasła do Twojego zapytania. W zapytaniu powinno się zawierać jedno hasło filetype: dla każdego rozszerzenia pliku, które powinno zostać uwzględnione w wynikach wyszukiwania. Jeśli w zapytaniu filetype: jest kilka haseł, musisz je rozdzielić za pomocą zapytania OR.

Domyślnie wyniki wyszukiwania uwzględniaj dokumenty z dowolnym rozszerzeniem pliku.

Typy plików obsługiwane przez Google:

  • Adobe Portable Document Format (pdf)
  • Adobe PostScript (ps)
  • Lotos 1-2-3 (tydzień 1, tydzień 2, tydzień 3, tydzień 4, tydzień 5, tydzień, tydzień, tydzień)
  • Lotus WordPro (LWP)
  • Macwrite (MW)
  • Microsoft Excel (xls),
  • Microsoft PowerPoint (ppt),
  • Microsoft Word (dokument)
  • Microsoft Works (WKS, WPS, WDB)
  • Microsoft Write (wri)
  • Tekst sformatowany RTF (RTF)
  • Shockwave Flash (SWF)
  • Tekst (ans, txt).

W przyszłości możemy dodać więcej typów plików. Jest aktualna znajdziesz w najczęstszych pytaniach na temat typów plików w Google.
Przykłady

Ten przykład zwraca dokumenty PDF, w których pojawia się słowo „Google”:
q=Google+filetype%3Apdf

Ten przykład zwraca dokumenty PDF i Word, które zawierają wzmiankę o "Google":
q=Google+filetype%3Apdf+OR+filetype%3Adoc

Uwzględnij hasło zapytania [+]
Opis

Wyszukiwane hasło „include” (+) określa, że słowo lub wyrażenie musi wystąpić we wszystkich dokumentach uwzględnionych w wynikach wyszukiwania. Aby użyć funkcji np. wyszukiwane hasło, przed słowem lub wyrażeniem, które muszą zostać występują we wszystkich wynikach wyszukiwania ze znakiem „+” (znak plusa).

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

Wstaw + przed powszechnym słowem, które Google są zwykle odrzucane przed zidentyfikowaniem wyników wyszukiwania.
Przykłady Dane wejściowe użytkownika: Star Wars Episode +I
Wyszukiwane hasło: q=Star+Wars+Episode+%2BI

Tylko linki, wyszukiwanie, wszystkie hasła [ allinlinks: ]
Opis

Zapytanie allinlinks: wymaga dokumentów w wyniki wyszukiwania, tak aby zawierały wszystkie słowa z zapytania w adresie URL . Zapytanie powinno być w formacie allinlinks:, po którym następują słowa zawarte w zapytaniu.

Jeśli Twoje zapytanie zawiera zapytanie allinlinks: Google sprawdza jedynie, czy linki URL w dokumentach w zapytaniu, ignorując pozostały tekst w dokumentach, tytuły i adresy URL poszczególnych dokumentów. Pamiętaj, że dokument Adres URL różni się od linków znajdujących się w dokumencie.

Wersja allinlinks: ze zmianą znaczenia w adresie 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

Wyszukiwanie wyrażenia („”) umożliwia wyszukanie możesz uzupełniać wyrażenia, umieszczając je w cudzysłowach lub i połączysz je łącznikami.

Wersja " (cudzysłowu) ze zmianą znaczenia w adresie URL to %22.

Wyszukiwanie wyrażeń jest szczególnie przydatne, gdy przeprowadzasz pod kątem znanych cytatów i nazw własnych.

Możesz też użyć żądania as_epq, , aby przesłać wyszukiwanie wyrażenia.
Przykłady Dane wejściowe użytkownika:"Abraham Lincoln"
Wyszukiwane hasło: q=%22Abraham+Lincoln%22

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

Zapytanie allintext: wymaga, aby każdy dokument w wyniki wyszukiwania tak, aby zawierały wszystkie słowa z zapytania treść dokumentu. Zapytanie powinno być w formacie allintext:, po którym następują wyrazy użyte w zapytaniu.

Jeśli Twoje zapytanie zawiera zapytanie allintext: Google sprawdzi tylko treść dokumentów pod kątem słów w zapytaniu, ignorując linki w tych dokumentach, tytuły i adresy URL dokumentów.

Wersja allintext: ze zmianą znaczenia w adresie URL to allintext%3A.
Przykłady Ten przykład określa, że słowa „Google” i „szukaj” musi występować w treści wszystkich dołączonych dokumentów w wynikach wyszukiwania:
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. wyszukiwane hasło powinno mieć format intitle:WORD bez spacji między wyszukiwanym hasłem intitle: a następnym słowem.

Uwaga: możesz podać więcej musi znaleźć się w tytule dokumentu, umieszczając wyszukiwane hasło intitle: przed każdym takim słowem. Dostępne opcje użyj też zapytania allintitle:, aby określ, że wszystkie słowa zapytania muszą być zawarte w tytułach dokumentów dostępnych w wynikach wyszukiwania.

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

W tym przykładzie słowo „Google” musi występować w tytuły dokumentów w wynikach wyszukiwania oraz słowo „szukaj” musi występować w dowolnym miejscu w tytułach, adresach URL, linkach ani w treści wiadomości tych dokumentów:
Dane wejściowe użytkownika:intitle:Google search
Wyszukiwane hasło:q=intitle%3AGoogle+search

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

Zapytanie allintitle: ogranicza wyniki wyszukiwania do dokumenty, które zawierają wszystkie słowa zapytania zawarte w tytule dokumentu. Do użyj wyszukiwanego hasła allintitle:, dodaj „allintitle:” w na początku wyszukiwanego hasła.

Uwaga: umieszczenie allintitle: na początku zapytania jest równoważne z umieszczeniem operatora intitle: przed każdym słowem użytym w wyszukiwaniu. zapytania.

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

W tym przykładzie określono, że słowa „Google” i „szukaj” musi występować w tytułach dowolnych 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:]
Opis

Zapytanie inurl: ogranicza wyniki wyszukiwania do dokumenty zawierające określone słowo w adresie URL dokumentu. wyszukiwane hasło powinno mieć format inurl:WORD bez spacji między wyszukiwanym hasłem inurl: a następnym słowem.

Zapytanie inurl: hasło ignoruje znaki interpunkcyjne i używa tylko pierwszego słowa po operatorze inurl:. Możesz podać więcej niż jedno słowo, które musi znaleźć się w URL dokumentu, umieszczając hasło inurl: przed każdego takiego słowa. Możesz też użyć zapytania allinurl:, aby określić, że w adresach URL muszą znajdować się wszystkie słowa zapytania. dokumentów widocznych w wynikach wyszukiwania.

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

W tym przykładzie słowo „Google” musi występować w adresy URL dokumentów w wynikach wyszukiwania oraz słowo „szukaj” muszą występować w tytułach, adresach URL, linkach oraz tekście głównym tych dokumenty:
Dane wejściowe użytkownika: inurl:Google search
Wyszukiwane hasło: q=inurl%3AGoogle+search

Wyszukiwanie adresów URL, wszystkie hasła [allinurl:]
Opis

Zapytanie allinurl: ogranicza wyniki wyszukiwania do dokumenty, które zawierają wszystkie słowa zapytania w adresie URL dokumentu. Do użyj wyszukiwanego hasła allinurl:, dodaj allinurl: na początku wyszukiwanego hasła.

Wyszukiwane hasło allinurl: ignoruje znaki interpunkcyjne, więc działa tylko w słowach, a nie w adresach URL Na przykład allinurl: uk/scotland ograniczy wyniki prowadzi do dokumentów zawierających słowo „pl” i „szkocja” w adresach URL, ale nie będzie wymagać, aby te dwa słowa występowały kolejność lub rozdzielone ukośnikiem.

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

W tym przykładzie określono, że słowa „Google” i „szukaj” musi występować w adresach URL wszystkich dokumentów w wynikach wyszukiwania:
Dane wejściowe użytkownika: allinurl: Google search
Wyszukiwane hasło: q=allinurl%3A+Google+search


Informacje o dokumencie internetowym [info:]
Opis

Zapytanie info: pobiera informacje ogólne na temat adresu URL, dopóki ten adres zostanie uwzględniony w indeksie wyszukiwarki Google. Zapytanie powinno mieć format info:URL bez spacji między wyszukiwanym hasłem info: a adresem URL.

Wersja info: ze zmianą znaczenia w adresie URL to info%3A.

Uwaga: nie możesz podać żadnych innych haseł, gdy za pomocą funkcji info:.
Przykłady Dane wejściowe użytkownika: info:www.google.com
Wyszukiwane hasło: q=info%3Awww.google.com

Przykładowe zapytania o obraz

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

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

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

Parametry zapytania wyszukiwania grafiki

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

imgsz
Opis

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

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

Opcjonalnie. Zwraca obrazy określonego typu, którym może być:

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

imgc
Opis

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

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

imgcolor
Opis

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

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

as_rights
Opis

Opcjonalnie. Filtry na podstawie licencji. Obsługiwane wartości:

  • 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 ograniczenia dotyczące żądań wyszukiwania, które wysyłasz wyślij do Google:

Komponent Limit Komentarz
Długość żądania wyszukiwania 2048 bajtów  
Liczba wyszukiwanych haseł 10 zawiera hasła z tymi parametrami: q, as_epq, as_eq, as_lq, as_oq, as_q
Liczba wyników 20 Jeśli dla parametru num ustawisz liczbę większą niż 20, zwróconych zostanie tylko 20 wyników. Do żeby uzyskać więcej wyników, trzeba wysyłać kilka próśb zwiększ wartość parametru start o każdego żądania.

Prezentacja internacjonalizacji zapytań i wyników

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

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

Kodowanie znaków

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

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

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

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

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

Języki interfejsu

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

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

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

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

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

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

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

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

lr=lang_jp

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

lr=lang_it|lang_de

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

lr=(-lang_hu).(-lang_cs)

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

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

Aby skorzystać z tej funkcji:

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

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

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

Wyniki filtrowania

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

Automatyczne filtrowanie wyników wyszukiwania

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

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

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

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

Filtrowanie języka i kraju

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

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

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

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


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

Google WebSearch określa kraj dokumentu na podstawie analizy:

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

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

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

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

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

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

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

niderlandzki
angielski
francuski
Niemiecki 		włoski
portugalski (Brazylia)
hiszpański
chiński tradycyjny

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

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

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

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

Wyniki XML

Wyniki XML w Google – DTD

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

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

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

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

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

<!DOCTYPE GSP SYSTEM "google.dtd">

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

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

Informacje o odpowiedzi XML

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

    Znak Formularze Escape 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 XML dla zwykłych i zaawansowanych zapytań

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

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

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

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

<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?>

<GSP VER="3.2">
   <TM>0.452923</TM>
   <Q>socer</Q>

<PARAM name="cx" value="00255077836266642015:u-scht7a-8i" original_value="00255077836266642015%3Au-scht7a-8i"/>
   <PARAM name="hl" value="en" original_value="en"/>
   <PARAM name="q" value="socer" original_value="socer"/>
   <PARAM name="output" value="xml" original_value="xml"/>
   <PARAM name="client" value="google-csbe" original_value="google-csbe"/>
   <PARAM name="num" value="10" original_value="10"/>
   <Spelling>
      <Suggestion q="soccer"><b><i>soccer</i></b></Suggestion>
   </Spelling>
   <Context>

<title>Sample Vacation CSE</title>
    <Facet>
      <FacetItem>
        <label>restaurants</label>
        <anchor_text>restaurants</anchor_text>
      </FacetItem>
      <FacetItem>
        <label>wineries</label>
        <anchor_text>wineries</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>golf_courses</label>
        <anchor_text>golf courses</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
     <FacetItem>
        <label>hotels</label>
        <anchor_text>hotels</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>nightlife</label>
        <anchor_text>nightlife</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>soccer_sites</label>
        <anchor_text>soccer sites</anchor_text>
      </FacetItem>
    </Facet>
   </Context>
   <RES SN="1" EN="10">
      <M>6080</M>
      /*
       * The FI tag after the comment indicates that the result
       * set has been filtered. If the number of results were exact, the
       * FI tag would be replaced by an XT tag in the same format.
       */
      <FI />
      <NB>
         /*
          * Since the request is for the first page of results, the PU tag,
          * which contains a link to the previous page of search results,
          * is not included in this XML result. If the sample result did include
          * a previous page of results, it would be listed here, in the same format
          * as the NU tag on the following line
          */
         <NU>/search?q=socer&hl=en&lr=&ie=UTF-8&output=xml&client=test&start=10&sa=N</NU>
      </NB>
      <R N="1">
         <U>http://www.soccerconnection.net/</U>
         <UE>http://www.soccerconnection.net/</UE>
         <T>SoccerConnection.net</T>
              <CRAWLDATE>May 21, 2007</CRAWLDATE>
         <S><b>soccer</b>; players; coaches; ball; world cup;<b>...</b></S>
  <Label>transcodable_pages</Label>
    <Label>accessible</Label>
         <Label>soccer_sites</Label>
         <LANG>en</LANG>
         <HAS>
            <DI>
               <DT>SoccerConnection.net</DT>
               <DS>Post your <b>soccer</b> resume directly on the Internet.</DS>
            </DI>
            <L/>
            <C SZ="8k" CID="kWAPoYw1xIUJ"/>
            <RT/>
         </HAS>
      </R>
      /*
       * The result includes nine more results, each enclosed by an R tag.
       */
   </RES>
</GSP>

Wyszukiwanie standardowe/zaawansowane: tagi XML

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

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

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

? = opcjonalny subtag
* = zero lub więcej wystąpień subtagu
+ = co najmniej jedno wystąpienie subtagu
O B P D P P P I L P N O P P S C X

anchor_text
Definicja

Tag &lt;anchor_text&gt; określa tekst, który wyświetlany użytkownikom w celu zidentyfikowania doprecyzowania etykieta powiązana z zestawem wyników wyszukiwania. Od etykiet zawężenia wyszukiwania zastąp znaki niealfanumeryczne znakami podkreślenia, nie wyświetlają wartość tagu <label> w interfejsie. Zamiast tego użyj wartości tag &lt;anchor_text&gt;.

Przykład <anchor_text>golf kursy</Anchor_text>
Subtag FacetItem
Format treści Tekst

ZABLOKUJ
Definicja

Ten tag zawiera zawartość bloku w wierszu treści wyniku promocji. Każdy blok zawiera tagi podrzędne T, U i L. Niepusty tag T oznacza, że blok zawiera tekst. niepuste tagi U i L oznaczają, że blok zawiera link (z adresem URL podanym w podtagu U i tekstem kotwicy w podtagu L).
Subtagi T, U, L
Subtag BODY_LINE
Format treści Pusta

BODY_LINE
Definicja

Ten tag zawiera zawartość wiersza w treści promowanego wyniku. Każda linia treści 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 &lt;C&gt; wskazuje, że usługa WebSearch może pobrać wersję tego adresu URL wyniku wyszukiwania z pamięci podręcznej. Nie można pobieraj strony z pamięci podręcznej za pomocą interfejsu API XML, ale możesz przekierowywać użytkowników na www.google.com, treści.
Atrybuty
Nazwa Format Opis
SZ Tekst (liczba całkowita + „k”) Podaje rozmiar wersji z pamięci podręcznej wyniku wyszukiwania 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 jako obserwowane:
cache:CIDtext:escapedURL

Adres URL ze znakami zmiany znaczenia jest dostępny w tagu UE.
Przykład <C SZ="6k" CID=&quot;kvOXK_cYSSgJ&quot; />
Subtag MA
Format treści Pusta

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

Kontekst
Definicja

Tag &lt;Context&gt; zawiera listę wartości etykiety zawężające wyszukiwania powiązane z zestawem wyników wyszukiwania.
Przykład &lt;Context&gt;
Subtagi title, Facet+
Format treści Kontener

CRAWLDATE
Definicja

Tag &lt;CRAWLDATE&gt; określa datę podczas indeksowania. Parametr CRAWLDATE nie jest zwracany dla każdej strony wyników wyszukiwania.
Przykład <CRAWLDATE>21 maja, 2005</CRAWLDATE>
Subtag P
Format treści Tekst

DI
Definicja

Tag &lt;DI&gt; zawiera informacje z Open Directory Project. informacje o kategorii (ODP) dla pojedynczego wyniku wyszukiwania.
Przykład &lt;DI&gt;
Subtagi DT?, DS?
Subtag MA
Format treści Pusta

DS
Definicja

Tag &lt;DS&gt; zawiera podsumowanie dotyczące w katalogu ODP.
Przykład <DS>Opublikuj <b>piłka</b> wznowić bezpośrednio na Internet.</DS>
Subtag DI
Format treści Tekst (może zawierać HTML)

DT
Definicja

Tag &lt;DT&gt; podaje tytuł pojedynczej osoby wymienionych w katalogu ODP.
Przykład &lt;DT&gt;SoccerConnection.net&lt;/DT&gt;
Subtag DI
Format treści Tekst (może zawierać HTML)

Aspekt
Definicja

Tag <Facet> zawiera logiczną grupę tagów &lt;FacetItem&gt;. Dostępne opcje utwórz można je grupować za pomocą Wyszukiwarki niestandardowej Format specyfikacji XML wyszukiwarki. Jeśli ich nie utworzysz grupowania, wyniki_xml_tag_Context><Context> tag będzie zawierają do do czterech tagów <Facet>. Elementy w każdym tagu <Facet> zostaną zgrupowane na potrzeby wyświetlania, ale mogą nie mieć funkcji logicznej relacji.
Przykład <Facet>
Subtagi FacetItem+, title+
Subtag Kontekst
Format treści Kontener

FacetItem
Definicja

Tag &lt;FacetItem&gt; zawiera informacje. etykiety zawężającej zakres powiązanej z zestawem wyników wyszukiwania.
Przykład &lt;FacetItem&gt;
Subtagi etykieta, anchor_text+
Subtag Facet
Format treści FacetItem

FI
Definicja Tag &lt;FI&gt; pełni rolę flagi , który wskazuje, czy przeprowadzono filtrowanie dokumentów. Zobacz sekcję Automatyczne filtrowanie. w tym dokumencie, znajdziesz więcej informacji o wynikach wyszukiwania Google filtry.
Przykład <FI />
Subtag RES
Format treści Pusta

GSP
Definicja

Tag &lt;GSP&gt; hermetyzuje wszystkie dane zwracane w wynikach wyszukiwania Google XML. „GSP” to skrót od „Google Search Protocol”.
Atrybuty
Nazwa Format Opis
VER Tekst (liczba całkowita) Atrybut VER określa wersję danych wyjściowych wyników wyszukiwania. bieżąca wersja wyjściowa to „3.2”.
Przykład <GSP VER="3.2">
Subtagi PARAM+, Q, RES?, TM
Format treści Pusta

MA
Definicja Tag &lt;HAS&gt; zawiera informacje o specjalnym wyszukiwaniu parametrów żądania obsługiwanych w przypadku konkretnego adresu URL.

Uwaga: definicja <HAS> dla WebSearch jest bardziej restrykcyjny niż w DTD.

Subtagi Zrobić to, L?, C?, RT?
Subtag P

ISURL
Definicja Google zwraca tag &lt;ISURL&gt;. , jeśli powiązane zapytanie jest adresem URL.
Subtag GSP
Format treści Pusta

L
Definicja obecność tagu &lt;L&gt;, wskazuje, że usługa WebSearch może znaleźć inne witryny zawierające linki do strony adresu URL tego wyniku wyszukiwania. Aby znaleźć takie witryny, należy użyć specjalnego zapytania link:.
Subtag MA
Format treści Pusta

etykieta
Definicja

Tag <label> określa etykietę zawężania. możesz użyć do filtrowania otrzymanych wyników wyszukiwania. Aby użyć funkcji etykietę zawężania, dodaj ciąg more:[[wartość tagu etykiety]] do wartość parametru q w żądaniu HTTP wysyłanym do Google jako w poniższym przykładzie. Pamiętaj, że ta wartość musi być z kodem zmiany znaczenia przed wysłaniem zapytania do Google.

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 &lt;Label&gt;, który wskazuje etykietę zawężania; powiązane z konkretnym adresem URL w wynikach wyszukiwania.
Przykład &lt;label&gt;golf_courses&lt;/label&gt;
Subtag FacetItem
Format treści Tekst

LANG
Definicja

Tag &lt;LANG&gt; zawiera najdokładniejsze oszacowanie przez Google język wyniku wyszukiwania.
Przykład <translate>pl</LANGUAGE>
Subtag P
Format treści Tekst

M
Definicja

Tag &lt;M&gt; podaje szacowane sumy liczbę wyników dla danego wyszukiwania.

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

Przykład <M>16 200 000</M>
Subtag RES
Format treści Tekst

NB
Definicja

Tag &lt;NB&gt; zawiera informacje nawigacyjne – linki do następnej strony wyników wyszukiwania lub do poprzedniej strony wyników wyszukiwania – dla zestawu wyników.

Uwaga: ten tag występuje tylko w przypadku jeśli dostępnych jest więcej wyników.
Przykład &lt;NB&gt;
Subtagi NU?, PU?
Subtag RES
Format treści Pusta

NU
Definicja

Tag &lt;NU&gt; zawiera względny link do na następnej stronie 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)

PARAM
Definicja

Tag &lt;PARAM&gt; identyfikuje parametr wejściowy przesłany w żądaniu HTTP powiązanym z wynikiem XML. Informacje o parametrze znajdują się tutaj: atrybutów tagu – „name”, „value” (wartość pierwotna), „original_value” – i będą 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 danych wejściowych w formacie HTML .
original_value Tekst Pierwotna wersja wartości wejściowej parametru ze zmianą znaczenia w adresie URL.
Przykład <PARAM name="cr" value=&quot;countryNZ&quot; oryginalna_wartość="krajNZ" />
Subtag GSP
Format treści Złożony

PU
Definicja

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

P
Definicja

Tag &lt;Q&gt; określa wyszukiwane hasło. przesłanego w żądaniu HTTP powiązanym z wynikiem XML.
Przykład

<Q>pizza</Q>
Subtag GSP
Format treści Tekst

R
Definicja

Tag &lt;R&gt; zawiera szczegóły elementu danego wyniku wyszukiwania.

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

Atrybuty
Nazwa Format Opis
N Tekst (liczba całkowita) Wskazuje indeks (od 1) tego elementu wyniku wyszukiwania.
MIME Tekst Wskazuje typ MIME wyszukiwania wynik.
Subtagi U, UE, T?, CRAWLDATE, S?, LANG?, MA
Subtag RES

RES
Definicja

Tag &lt;RES&gt; zawiera w sobie ciąg z wynikami wyszukiwania i szczegółowymi informacjami na ich temat.
Atrybuty
Nazwa Format Opis
SN Tekst (liczba całkowita) Wskazuje indeks (w postaci liczby 1) wartości pierwszy wynik wyszukiwania zwrócony w tym zestawie wyników.
PL Tekst (liczba całkowita) Wskazuje indeks (od 1) ostatniej wartości wyniku wyszukiwania zwróconego w tym zestawie wyników.
Przykład <RES SN="1" PL="10">
Subtagi M, FI?, XT?, NB, R*
Subtag GSP
Format treści Pusta

S
Definicja

Tag &lt;S&gt; zawiera fragment wyszukiwanego hasła w którym wyszukiwane hasła są wyróżnione pogrubieniem. Podziały wiersza: dołączane do fragmentu, aby zapewnić jego prawidłowe zawijanie tekstu.
Przykład <S>Waszyngton (CNN) – stawka za zakończenie Spór w Senacie o prezydenta &lt;b&gt;Buszy&#39;s&lt;/b&gt; polecane przez sądy niech 5 nominowanych kandydaci awansuje do ostatecznego głosowania, zachowując przy tym &lt;b&gt;...&lt;b&gt;...&lt;/b&gt;<S>
Subtag P
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 znajdują się odpowiednio w tagach podrzędnych T i U. Wiersze tekstu głównego i linków są zawarte w subtagach BODY_LINE.
Subtagi BODY_LINE*, T, U
Subtag SL_RESULTS
Format treści Pusta

SL_RESULTS
Definicja

Tag w kontenerze na potrzeby wyników promowanych. Jedna z tych opcji pojawi się za każdym razem, gdy w wynikach wyszukiwania masz jakąś promocję. Subtag SL_MAIN zawiera dane głównych wyników.
Subtagi SL_MAIN*
Subtag P
Format treści Pusta

Pisownia
Definicja

Tag <Spelling> zawiera zmienną sugestia pisowni dla przesłanego zapytania. Ten tag pojawia się tylko w pierwszej strony wyników wyszukiwania. Sugestie pisowni są dostępne w tych językach: angielskim, chińskim, japońskim i koreańskim.

Uwaga: Google będzie zwracać tylko propozycje pisowni dla zapytania, w których znajduje się wartość parametru gl małe litery.
Przykład <Pisownia>
Subtagi Sugestia
Subtag GSP
Format treści Pusta

Sugestia
Definicja Tag &lt;Suggestion&gt; zawiera element sugestia użycia innej pisowni dla przesłanego zapytania. Za pomocą zawartość tagu, aby zasugerować użytkownikowi wyszukiwarki alternatywną pisownię. Wartością atrybutu q jest wartość Sugestia pisowni ze zmianą znaczenia w adresie URL, której można użyć jako hasła w zapytaniu.
Atrybuty
Nazwa Format Opis
q Tekst Atrybut q określa Wersja sugestii pisowni ze zmianą znaczenia w adresie URL.
Przykład <Sugestia q=&quot;soccer&quot;&gt;&amp;lt;b&amp;gt;&amp;lt;i&amp;gt;soccer&amp;lt;/i&amp;gt;&amp;lt;/b&amp;gt;&lt;/Suggestion&gt;
Subtag Pisownia
Format treści Tekst (HTML)

T
Definicja Tag &lt;T&gt; zawiera tytuł wyniku.
Przykład <T>Wschodnie wybrzeże Amiki Pizzeria</T>
Subtag P
Format treści Tekst (HTML)

tytuł
Definicja

Tag &lt;Context&gt; (jako element podrzędny tagu &lt;Context&gt;) zawiera nazwę Twojej Wyszukiwarki niestandardowej.

Tag <title> – jako element podrzędny tagu <Facet> – podaje tytuł zestawu aspektów.
Przykład

Jako element podrzędny <Context>: <title>Moje wyszukiwanie Engine&lt;/title&gt;

Jako dziecko osoby (<Facet>): <title>facet tytuł</title>
Subtag Kontekst, Facet
Format treści Tekst

TM
Definicja

Tag &lt;TM&gt; określa łączny czas działania serwera. potrzebne do zwrócenia wyników wyszukiwania, mierzone w sekundach.
Przykład <TM>0,100445</TM>
Subtag GSP
Format treści Tekst (liczba zmiennoprzecinkowa)

TT
Definicja Tag &lt;TT&gt; umożliwia wyszukiwanie wskazówkę.
Przykład <TT>&lt;i&gt;Wskazówka: dla większości w przeglądarkach, naciśnięcie klawisza Return daje taki sam efekt jak kliknięcie lub przycisk Szukaj.</TT>
Subtag GSP

U
Definicja Tag &lt;U&gt; zawiera adres URL, danego wyniku.
Przykład &lt;U&gt;http://www.dominos.com/&lt;/U&gt;
Subtag P
Format treści Tekst (bezwzględny URL)

UD
Definicja

Tag &lt;UD&gt; zawiera kod IDN zakodowany (międzynarodowa nazwa domeny) wyniku wyszukiwania. Wartość pozwala które będą wyświetlane w lokalnych językach. Na przykład parametr Adres URL http://www.%E8%8A%B1%E4%BA%95.com zakodowany przez IDN może zostać zdekodowany i wyświetlany jako http://www.花用鮨.com. Ten tag &lt;UD&gt; będzie uwzględniany w wynikach wyszukiwania tylko dla następujących zawierające parametr ud.

Uwaga: jest to funkcja w wersji beta.
Przykład &lt;UD&gt;http://www.%E8%8A%B1%E4%BA%95.com/&lt;/UD&gt;
Subtag P
Format treści Tekst (adres URL zakodowany przez IDN)

UE
Definicja Tag &lt;UE&gt; zawiera adres URL, danego wyniku. Wartość jest zastępowana kodem zmiany znaczenia w adresie URL, dzięki czemu jest odpowiednia .
Przykład &lt;UE&gt;http://www.dominos.com/&lt;/UE&gt;
Subtag P
Format treści Tekst (adres URL ze zmianą znaczenia)

XT
Definicja Tag &lt;XT&gt; wskazuje, że szacowana łączna liczba wyników, określona w tagu M, faktycznie odzwierciedla dokładne łączną liczbę wyników. Zobacz sekcję Automatyczne Filtrowanie w tym dokumencie.
Przykład <XT />
Subtag RES
Format treści Pusta


Wyniki XML dla zapytań w wyszukiwarce grafiki

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

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

To żądanie zwraca poniższy wynik XML. 


<GSP VER="3.2">
  <TM>0.395037</TM>
  <Q>monkeys</Q>

  <PARAM name="cx" value="011737558837375720776:mbfrjmyam1g" original_value="011737558837375720776:mbfrjmyam1g" url_<escaped_value="011737558837375720776%3Ambfrjmyam1g" js_escaped_value="011737558837375720776:mbfrjmyam1g"/>
  <PARAM name="client" value="google-csbe" original_value="google-csbe" url_escaped_value="google-csbe" js_escaped_value="google-csbe"/>
  <PARAM name="q" value="monkeys" original_value="monkeys" url_escaped_value="monkeys" js_escaped_value="monkeys"/>
  <PARAM name="num" value="2" original_value="2" url_escaped_value="2" js_escaped_value="2"/>
  <PARAM name="output" value="xml_no_dtd" original_value="xml_no_dtd" url_escaped_value="xml_no_dtd" js_escaped_value="xml_no_dtd"/>
  <PARAM name="adkw" value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" original_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" url_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" js_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A"/>
  <PARAM name="hl" value="en" original_value="en" url_escaped_value="en" js_escaped_value="en"/>
  <PARAM name="oe" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/>
  <PARAM name="ie" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/>
  <PARAM name="boostcse" value="0" original_value="0" url_escaped_value="0" js_escaped_value="0"/>

  <Context>
    <title>domestigeek</title>
  </Context>

  <ARES/>
  <RES SN="1" EN="2">
    <M>2500000</M>
    <NB>
      <NU>/images?q=monkeys&num=2&hl=en&client=google-csbe&cx=011737558837375720776:mbfrjmyam1g&boostcse=0&output=xml_no_dtd
        &ie=UTF-8&oe=UTF-8&tbm=isch&ei=786oTsLiJaaFiALKrPChBg&start=2&sa=N
      </NU>
    </NB>
    <RG START="1" SIZE="2"/>
      <R N="1" MIME="image/jpeg">
        <RU>http://www.flickr.com/photos/fncll/135465558/</RU>
        <U>
          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        </U>
        <UE>
          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        </UE>
        <T>Computer <b>Monkeys</b> | Flickr - Photo Sharing!</T>
        <RK>0</RK>
        <BYLINEDATE>1146034800</BYLINEDATE>
        <S>Computer <b>Monkeys</b> | Flickr</S>
        <LANG>en</LANG>
        <IMG WH="500" HT="305" IID="ANd9GcQARKLwzi-t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs">
          <SZ>88386</SZ>
          <IN/>
        </IMG>
        <TBN TYPE="0" WH="130" HT="79" URL="http://t0.gstatic.com/images?q=tbn:ANd9GcQARKLwzi-
t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"/>
      </R>
      <R N="2" MIME="image/jpeg">
        <RU>
          http://www.flickr.com/photos/flickerbulb/187044366/
        </RU>
        <U>
          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        </U>
        <UE>
          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        </UE>
        <T>
          one. ugly. <b>monkey</b>. | Flickr - Photo Sharing!
        </T>
        <RK>0</RK>
        <BYLINEDATE>1152514800</BYLINEDATE>
        <S>one. ugly. <b>monkey</b>.</S>
        <LANG>en</LANG>
        <IMG WH="400" HT="481" IID="ANd9GcQ3Qom0bYbee4fThCQVi96jMEwMU6IvVf2b8K5vERKVw-
           EF4tQQnDDKOq0"><SZ>58339</SZ>
          <IN/>
        </IMG>
        <TBN TYPE="0" WH="107" HT="129" URL="http://t1.gstatic.com/images?q=tbn:ANd9GcQ3Qom0bYbee4fThCQ
          Vi96jMEwMU6IvVf2b8K5vERKVw-EF4tQQnDDKOq0"/>
      </R>
  </RES>
</GSP>

Wyszukiwarka grafiki: tagi XML

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

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

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

RG
Definicja

Tag &lt;RG&gt; zawiera szczegóły pojedynczego wyniku wyszukiwania grafiki.
Atrybuty
Nazwa Format Opis
N Tekst (liczba całkowita) Wskazuje indeks (od 1) tego elementu wyniku wyszukiwania.
MIME Tekst Wskazuje typ MIME wyszukiwania wynik.
Subtag RES
RU
Definicja

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