Ta strona dotyczy wersji XML interfejsu Custom Search JSON API, który jest dostępny tylko dla klientów Google Site Search.
- Omówienie
- Format żądań wyszukiwarki niestandardowej
- Wyniki w formacie XML
Opis
Usługa Google WebSearch umożliwia klientom Wyszukiwarki Google w witrynie wyświetlanie wyników wyszukiwania Google we własnych witrynach. Do wyświetlania wyników wyszukiwania usługa WebSearch używa prostego protokołu HTTP. Administratorzy wyszukiwarki mają pełną kontrolę nad sposobem żądania wyników wyszukiwania oraz nad sposobem ich prezentowania użytkownikowi. W tym dokumencie znajdziesz szczegóły techniczne dotyczące żądań wyszukiwania w Google i formatów wyników.
Aby pobrać wyniki wyszukiwania Google, aplikacja wysyła do Google proste żądanie HTTP. Następnie Google zwraca wyniki wyszukiwania w formacie XML. Wyniki w formacie XML umożliwiają dostosowanie sposobu ich wyświetlania.
Format żądania WebSearch
- Omówienie próśb
- Wyszukiwane hasła
- Parametry żądania
- Przykładowe zapytania w WebSearch
- Definicje parametrów zapytań WebSearch
- Przykładowe zapytania dotyczące obrazów
- Definicje parametrów zapytań w wyszukiwarce grafiki
- Szukanie zaawansowane
- Parametry zapytania wyszukiwania zaawansowanego
- Specjalne warunki zapytania
- Limity żądań
Żądanie – informacje
Żądanie wyszukiwarki Google to standardowe polecenie HTTP GET
. Zawiera zbiór parametrów odpowiednich dla Twoich zapytań. Te parametry są umieszczane w adresie URL żądania w postaci par nazwa=wartość rozdzielonych znakami „&”. Parametry obejmują takie dane jak wyszukiwane hasło i unikalny identyfikator wyszukiwarki (cx
), który identyfikuje wyszukiwarkę wysyłającą żądanie HTTP. Usługa WebSearch lub Wyszukiwarka obrazów zwraca wyniki XML w odpowiedzi na żądania HTTP.
Wyszukiwane hasła
Większość żądań wyszukiwania zawiera co najmniej 1 wyszukiwane hasło. Wyszukiwane hasło pojawia się jako wartość parametru w żądaniu wyszukiwania.
Zapytania mogą określać kilka typów informacji, które mają służyć do filtrowania i porządkowania wyników wyszukiwania zwracanych przez Google. Zapytania mogą określać:
- Słowa lub wyrażenia do uwzględnienia lub wykluczenia
- Wszystkie słowa w zapytaniu (domyślnie)
- Dokładne wyrażenie w wyszukiwanym haśle
- Dowolne słowo lub wyrażenie w zapytaniu
- W którym miejscu dokumentu możesz wyszukać wyszukiwane hasła.
- W dowolnym miejscu w dokumencie (domyślnie)
- Tylko w treści dokumentu
- Tylko w tytule dokumentu
- Tylko w adresie URL dokumentu
- Tylko w linkach w dokumencie
- Ograniczenia dotyczące samych dokumentów
- Uwzględnianie lub wykluczanie dokumentów określonych typów plików (np. plików PDF lub dokumentów Worda)
- Specjalne zapytania pod adresem URL, które zwracają informacje o danym adresie URL, a nie przeprowadzają wyszukiwanie.
- Zapytania, które zwracają ogólne informacje o adresie URL, takie jak kategoria, fragment czy język
- Zapytania, które zwracają zestaw stron internetowych zawierających linki do określonego adresu URL
- Zapytania, które zwracają zestaw stron internetowych podobnych do danego adresu URL
Domyślna wyszukiwarka
Wartości parametrów zapytania muszą zawierać kody zmiany znaczenia adresu URL. Pamiętaj, że znak plusa („+”) musisz zastąpić znakiem plusa („+”) w każdej sekwencji odstępów w zapytaniu. Jest to dokładniej omówione w sekcji Zmiana znaczenia adresu URL w tym dokumencie.
Wyszukiwane hasło jest przesyłane do usługi WebSearch za pomocą parametru q. Przykładowe wyszukiwane hasło:
q=horses+cows+pigs
Domyślnie usługa Google WebSearch zwraca tylko te dokumenty, które zawierają wszystkie terminy w zapytaniu.
Parametry żądania
W tej sekcji znajdziesz parametry, których możesz używać podczas tworzenia żądania wyszukiwania. Parametry zostaną podzielone na 2 listy. Pierwsza lista zawiera parametry dotyczące wszystkich żądań wyszukiwania. Druga lista zawiera parametry, które mają zastosowanie tylko do żądań wyszukiwania zaawansowanego.
Wymagane są 3 parametry żądania:
- Parametr client musi być ustawiony na
google-csbe
- Parametr output określa format zwracanych wyników XML. Wyniki mogą być zwracane z odwołaniem do pliku DTD Google lub bez niego (
xml_no_dtd
). Zalecamy ustawienie tej wartości naxml_no_dtd
. Uwaga: jeśli nie określisz tego parametru, wyniki będą zwracane w formacie HTML, a nie XML.
- Parametr cx, który reprezentuje unikalny identyfikator wyszukiwarki.
Najczęściej używane parametry żądania inne niż wymienione powyżej to:
Przykładowe zapytania w internecie
Poniższe przykłady pokazują kilka żądań HTTP WebSearch, aby pokazać, jak używane są różne parametry zapytania. Definicje różnych parametrów zapytania znajdziesz w tym dokumencie w sekcjach Definicje parametrów zapytań WebSearch i Parametry zapytania zaawansowanego.
To żądanie zawiera pierwsze 10 wyników (start=0&num=10
) dla wyszukiwanego hasła „red sox” (q=red+sox
). Zapytanie określa też, że wyniki powinny pochodzić z kanadyjskich witryn (cr=countryCA
) i powinien być napisany w języku francuskim (lr=lang_fr
). Na koniec zapytanie określa wartości parametrów client, output i cx, które są wymagane.
http://www.google.com/search?
start=0
&num=10
&q=red+sox
&cr=countryCA
&lr=lang_fr
&client=google-csbe
&output=xml_no_dtd
&cx=00255077836266642015:u-scht7a-8i
W tym przykładzie użyto niektórych parametrów zapytania wyszukiwania zaawansowanego, aby jeszcze bardziej dostosować zapytanie. To żądanie używa parametru as_q (as_q=red+sox
) zamiast parametru q. Używa też parametru as_eq, aby wykluczać z wyników wyszukiwania wszystkie dokumenty zawierające słowo „Yankees” (as_eq=yankees
).
http://www.google.com/search?
start=0
&num=10
&as_q=red+sox
&as_eq=Yankees
&client=google-csbe
&output=xml_no_dtd
&cx=00255077836266642015:u-scht7a-8i
Definicje parametrów zapytań WebSearch
c2coff | |||||||
---|---|---|---|---|---|---|---|
Opis | Opcjonalnie. Parametr c2coff włącza lub wyłącza funkcję wyszukiwania w języku chińskim tradycyjnym i uproszczonym. Domyślna wartość tego parametru to
|
||||||
Przykłady | q=google&c2coff=1 |
client | |
---|---|
Opis | Wymagany. Parametr |
Przykłady | q=google&client=google-csbe |
cr | |
---|---|
Opis | Opcjonalnie. Parametr Google WebSearch określa kraj dokumentu na podstawie analizy:
Listę prawidłowych wartości tego parametru znajdziesz w sekcji Wartości parametru kraju (cr). |
Przykłady | q=Frodo&cr=countryNZ |
cx | |
---|---|
Opis | Wymagany. Parametr |
Przykłady | q=Frodo&cx=00255077836266642015:u-scht7a-8i |
filter | |||||||
---|---|---|---|---|---|---|---|
Opis | Opcjonalnie. Parametr filtr aktywuje lub wyłącza automatyczne filtrowanie wyników wyszukiwania Google. Więcej informacji o filtrach wyników wyszukiwania Google znajdziesz w sekcji Automatyczne filtrowanie w tym dokumencie. Domyślna wartość parametru
Uwaga: domyślnie Google stosuje filtrowanie do wszystkich wyników wyszukiwania, aby poprawić ich jakość. |
||||||
Przykłady | q=google&filter=0 |
gl | |
---|---|
Opis | Opcjonalnie. Wartość parametru Określenie wartości parametru |
Przykłady | To żądanie zwiększa liczbę dokumentów napisanych w Wielkiej Brytanii w wynikach wyszukiwania WebSearch: |
hl | |
---|---|
Opis | Opcjonalnie. Parametr Więcej informacji znajdziesz w sekcji Języki interfejsu w artykule Internacjonalizacja zapytań i wyników, a lista obsługiwanych języków znajdziesz w sekcji Obsługiwane języki interfejsu. |
Przykłady | To żądanie jest kierowane na reklamy wina w języku francuskim. (Vin to francuska nazwa wina). q=vin&ip=10.10.10.10&ad=w5&hl=fr |
w wysokiej rozdzielczości | |
---|---|
Opis | Opcjonalnie. Parametr |
Przykłady | Wynikiem wyszukiwania jest „pizza” ORAZ „ser”. Wyrażenie jest takie samo jak
|
ie | |
---|---|
Opis | Opcjonalnie. Parametr W sekcji Kodowanie znaków znajdziesz informacje o tym, kiedy warto używać tego parametru. Listę możliwych wartości |
Przykłady | q=google&ie=utf8&oe=utf8 |
lr | |
---|---|
Opis | Opcjonalnie. Parametr Google WebSearch określa język dokumentu na podstawie analizy:
Listę prawidłowych wartości tego parametru znajdziesz w sekcji Wartości zbierania danych języka ( |
Przykłady | q=Frodo&lr=lang_en |
num | |
---|---|
Opis | Opcjonalnie. Parametr Domyślna wartość Uwaga: jeśli łączna liczba wyników wyszukiwania jest mniejsza od wymaganej, zwracane są wszystkie dostępne wyniki wyszukiwania. |
Przykłady | q=google&num=10 |
oe | |
---|---|
Opis | Opcjonalnie. Parametr W sekcji Kodowanie znaków znajdziesz informacje o tym, kiedy warto używać tego parametru. Listę możliwych wartości |
Przykłady | q=google&ie=utf8&oe=utf8 |
wynik | |||||||
---|---|---|---|---|---|---|---|
Opis | Wymagany. Parametr
|
||||||
Przykłady | output=xml_no_dtd |
q | |
---|---|
Opis | Opcjonalnie. Parametr Jest też wiele specjalnych zapytań, których możesz użyć jako części wartości parametru Panel sterowania wyszukiwarki Google zawiera raport o najczęstszych zapytaniach przesyłanych z wykorzystaniem parametru Uwaga: wartość parametru q musi zawierać zmianę znaczenia w adresie URL. |
Przykłady | q=vacation&as_oq=london+paris |
bezpieczeństwo | |||||||||
---|---|---|---|---|---|---|---|---|---|
Opis | Opcjonalnie. Parametr
Więcej informacji o tej funkcji znajdziesz w sekcji Filtrowanie treści dla dorosłych przy użyciu filtra SafeSearch. |
||||||||
Przykłady | q=adult&safe=high |
start | |
---|---|
Opis | Opcjonalnie. Parametr Parametr |
Przykłady | start=10 |
sortuj | |
---|---|
Opis | Opcjonalnie. Parametr |
Przykłady |
|
ud | |
---|---|
Opis | Opcjonalnie. Parametr http://www.花井鮨.com Prawidłowe wartości tego parametru to Jeśli parametr http://www.xn--elq438j.com. Uwaga: jest to funkcja w wersji beta. |
Przykłady | q=google&ud=1 |
Szukanie zaawansowane
Dodatkowe parametry zapytania wymienione pod obrazem mają zastosowanie do zapytań zaawansowanych. Gdy przesyłasz wyszukiwanie zaawansowane, w wyszukiwanych hasłach uwzględniane są wartości kilku parametrów (np. as_eq, as_epq, as_oq itp.). Obraz pokazujący stronę Szukanie zaawansowane Google Na obrazie nazwa każdego parametru szukania zaawansowanego jest zapisana red tekstem w polu na stronie, którego dotyczy dany parametr, lub obok niego.
![](https://services.google.com/images/as_examples/advanced_search.jpg?authuser=6&hl=pl)
Parametry zapytania wyszukiwania zaawansowanego
as_dt | |
---|---|
Opis | Opcjonalnie. Parametr |
Przykłady | as_dt=i,as_dt=e |
as_epq | |
---|---|
Opis | Opcjonalnie. Parametr |
Przykłady | as_epq=abraham+lincoln |
as_eq | |
---|---|
Opis | Opcjonalnie. Parametr |
Przykłady |
|
as_lq | |
---|---|
Opis | Opcjonalnie. Parametr |
Przykłady |
|
as_nlo | |
---|---|
Opis | Opcjonalnie. Parametr |
Przykłady | Ta opcja ustawia zakres wyszukiwania od 5 do 10 włącznie:
|
as_nhi | |
---|---|
Opis | Opcjonalnie. Parametr |
Przykłady | Ta opcja ustawia zakres wyszukiwania od 5 do 10 włącznie:
|
as_oq | |
---|---|
Opis | Opcjonalnie. Parametr |
Przykłady |
|
as_q | |
---|---|
Opis | Opcjonalnie. Parametr |
Przykłady |
|
as_qdr | |
---|---|
Opis | Opcjonalnie. Parametr
|
Przykłady |
W tym przykładzie prosimy o wyniki z ubiegłego roku:
W tym przykładzie prosimy o wyniki z ostatnich 10 dni:
|
as_sitesearch | |
---|---|
Opis | Opcjonalnie. Parametr |
Przykłady |
|
Specjalne wyszukiwane hasła
Google WebSearch umożliwia stosowanie kilku specjalnych haseł w zapytaniach, które zapewniają dostęp do dodatkowych możliwości wyszukiwarki Google. Te specjalne hasła zapytania powinny być uwzględnione w wartości parametru żądania q. Podobnie jak w przypadku innych haseł, specjalne hasła zapytania muszą zawierać kod zmiany znaczenia w adresie URL. Liczba specjalnych haseł w zapytaniu zawiera dwukropek (:). Ten znak musi też zawierać kod zmiany znaczenia adresu URL, a jego wartość to %3A
.
Linki wsteczne [link:] | |
---|---|
Opis | Wyszukiwane hasło Wersja elementu Możesz też użyć parametru żądania as_lq, by przesłać żądanie Uwaga: gdy używasz |
Przykłady |
|
Wartość logiczna LUB wyszukiwanie [LUB ] | |
---|---|
Opis | Wyszukiwane hasło Możesz też użyć parametru żądania as_oq, aby wyszukać dowolne hasło w zestawie. Uwaga: jeśli w żądaniu wyszukiwania pojawi się zapytanie „London+LUB+Paryż”, w wynikach wyszukiwania pojawią się dokumenty zawierające co najmniej 1 z tych słów. W niektórych przypadkach dokumenty w wynikach wyszukiwania mogą zawierać oba te słowa. |
Przykłady | Wyszukaj Londyn lub Paryż: Dane wejściowe użytkownika:
london OR
paris Hasło zapytania:q=london+OR+paris Wyszukaj wakacje i Londyn albo Paryż: Wyszukiwane hasło:
q=vacation+london+OR+paris Wyszukaj wakacje i jedno z Londynu, Paryża lub czekoladki: Wyszukiwane hasło:
q=vacation+london+OR+paris+OR+chocolates Wyszukaj hasła „wakacje” i czekoladki, a także hasła „Londyn” lub „Paryż”, przy czym najmniejsza waga jest przypisana do czekolady: Wyszukiwane hasło:
q=vacation+london+OR+paris+chocolates Wyszukaj wakacje, czekoladki i kwiaty w dokumentach, które zawierają też „Londyn” lub „Paryż”: Wyszukiwane hasło:
q=vacation+london+OR+paris+chocolates+flowers Wyszukaj wakacje, Londyn albo Paryż, a także czekoladki lub kwiaty: Wyszukiwane hasło: q=vacation+london+OR+paris+chocolates+OR+flowers |
Wyklucz hasło zapytania [-] | |
---|---|
Opis | Zapytanie wykluczające ( Wersja elementu Hasło wykluczające jest przydatne, gdy wyszukiwane hasło ma więcej niż 1 znaczenie. Na przykład słowo „bas” może zwrócić wyniki dotyczące ryb lub muzyki. Jeśli szukasz dokumentów o rybach, możesz wykluczyć je z wyników wyszukiwania, używając wyszukiwanego hasła. Możesz też użyć parametru żądania as_eq, aby wykluczyć z wyników wyszukiwania dokumenty pasujące do określonego słowa lub wyrażenia. |
Przykłady | Dane wejściowe użytkownika: bass -music Wyszukiwane hasło: q=bass+%2Dmusic |
Wykluczenie typu pliku [ -filetype: ] | |
---|---|
Opis | Zapytanie Wersja elementu Uwaga: możesz wykluczyć z wyników wyszukiwania wiele typów plików, dodając do zapytania więcej haseł ( Typy plików obsługiwane przez Google:
W przyszłości możemy dodać więcej typów plików. Aktualną listę funkcji możesz zawsze znaleźć w artykule Google dotyczącym najczęstszych pytań dotyczących typów plików. |
Przykłady | W tym przykładzie zwracamy dokumenty zawierające słowo „Google”, które nie są dokumentami PDF: W tym przykładzie zwracamy dokumenty zawierające słowo „Google”, ale z wykluczeniem dokumentów PDF i Word: |
Filtrowanie typu pliku [ filetype: ] | |
---|---|
Opis | Zapytanie Wersja elementu Możesz ograniczyć wyniki wyszukiwania do dokumentów pasujących do jednego z kilku rozszerzeń plików, dodając do zapytania więcej haseł Domyślnie wyniki wyszukiwania obejmują dokumenty z każdym rozszerzeniem. Typy plików obsługiwane przez Google:
W przyszłości możemy dodać więcej typów plików. Aktualną listę funkcji możesz zawsze znaleźć w artykule Google dotyczącym najczęstszych pytań dotyczących typów plików. |
Przykłady | Ten przykład zwraca dokumenty PDF zawierające słowo „Google”: W tym przykładzie zwracamy dokumenty PDF i Word, które zawierają słowo „Google”: |
Uwzględnij hasło zapytania [+] | |
---|---|
Opis | Operator zapytania „include” (+) określa, że dane słowo lub wyrażenie musi występować we wszystkich dokumentach uwzględnionych w wynikach wyszukiwania. Aby użyć takiego zapytania, przed słowem lub wyrażeniem, które musi występować we wszystkich wynikach wyszukiwania, dodaj znak „+” (znak plusa). Wersja Należy użyć znaku |
Przykłady | Dane wejściowe użytkownika: Star Wars Episode +I Wyszukiwane hasło: q=Star+Wars+Episode+%2BI |
Tylko linki Szukaj, wszystkie terminy [ allinlinks: ] | |
---|---|
Opis | Wyszukiwane hasło Jeśli zapytanie zawiera wyszukiwane hasło Wersja elementu |
Przykłady | Dane wejściowe użytkownika:allinlinks: Google search Wyszukiwane hasło: q=allinlinks%3A+Google+search |
Wyszukiwanie wyrażeń | |
---|---|
Opis | Wyszukiwane hasło (") umożliwia wyszukiwanie całych wyrażeń poprzez umieszczenie ich w cudzysłowie lub połączenie ich za pomocą łączników. Wersja Wyszukiwanie wyrażeń przydaje się zwłaszcza wtedy, gdy szukasz słynnych cytatów lub nazw własnych. Aby wyszukać wyrażenie, możesz też użyć parametru żądania as_epq. |
Przykłady | Dane wejściowe użytkownika:"Abraham Lincoln" Wyszukiwane hasło: q=%22Abraham+Lincoln%22 |
Wyszukiwanie tylko tekstowe, wszystkie hasła [allintext:] | |
---|---|
Opis | Wyszukiwane hasło Jeśli zapytanie zawiera wyszukiwane hasło Wersja elementu |
Przykłady | Ten przykład określa, że we wszystkich dokumentach w wynikach wyszukiwania muszą występować słowa „Google” i „wyszukiwarka”: Dane wejściowe użytkownika: allintext:Google search Wyszukiwane hasło: q=allintext%3AGoogle+search |
Wyszukiwanie tytułu, pojedyncze hasło [intitle:] | |
---|---|
Opis | Zapytanie Uwaga: możesz podać więcej niż 1 słowo, które musi zawierać się w tytule dokumentu, umieszczając przed każdym z nich zapytanie Wersja elementu |
Przykłady | W tym przykładzie w tytułach wszystkich dokumentów w wynikach wyszukiwania musi występować słowo „Google”, a słowo „wyszukiwanie” musi występować w dowolnym miejscu w tytułach, adresach URL, linkach lub w treści tych dokumentów: |
Wyszukiwanie tytułu, wszystkie hasła [allintitle:] | |
---|---|
Opis | Zapytanie Uwaga: umieszczenie Wersja elementu |
Przykłady | Ten przykład określa, że w tytułach wszystkich dokumentów w wynikach wyszukiwania muszą występować słowa „Google” i „wyszukiwarka”: |
Wyszukiwanie URL, pojedyncze hasło [inurl:] | |
---|---|
Opis | Zapytanie Zapytanie Wersja elementu |
Przykłady | W tym przykładzie w adresach URL wszystkich dokumentów w wynikach wyszukiwania musi występować słowo „Google”, a słowo „wyszukiwanie” musi występować w dowolnym miejscu w tytułach, adresach URL, linkach lub w treści tych dokumentów: |
Wyszukiwanie adresu URL, wszystkie hasła [allinurl:] | |
---|---|
Opis | Zapytanie Zapytanie Wersja elementu |
Przykłady | Ten przykład określa, że w adresach URL dokumentów w wynikach wyszukiwania muszą występować słowa „Google” i „wyszukiwarka”: |
Informacje o dokumencie internetowym [info:] | |
---|---|
Opis | Wyszukiwane hasło Wersja Uwaga: gdy używasz |
Przykłady | Dane wejściowe użytkownika: info:www.google.com Wyszukiwane hasło: q=info%3Awww.google.com |
Przykładowe zapytania graficzne
Poniższe przykłady pokazują kilka żądań HTTP dotyczących obrazów, aby pokazać, jak używane są różne parametry zapytania. Definicje różnych parametrów zapytania znajdziesz w tym dokumencie w sekcjach Definicje parametrów zapytań graficznych.
To żądanie prosi o 5 pierwszych wyników (start=0&num=5
) dla hasła „małpa” (q=monkey
), pliku typu .png. Na koniec zapytanie określa wartości parametrów client
, output
i cx
. Wszystkie 3 są wymagane.
http://www.google.com/cse? searchtype=image start=0 &num=5 &q=monkey &as_filetype=png &client=google-csbe &output=xml_no_dtd &cx=00255077836266642015:u-scht7a-8i
Parametry zapytania w wyszukiwarce grafiki
as_filetype | |
---|---|
Opis | Opcjonalnie. Zwraca obrazy określonego typu. Dozwolone wartości to |
Przykłady | q=google&as_filetype=png |
Obrazy | |
---|---|
Opis | Opcjonalnie. Zwraca obrazy o określonym rozmiarze, gdzie rozmiar może być jednym z tych elementów:
|
Przykłady | q=google&as_filetype=png&imgsz=icon |
typ obrazu | |
---|---|
Opis | Opcjonalnie. Zwraca obrazy określonego typu, który może być jednym z tych elementów:
|
Przykłady | q=google&as_filetype=png&imgtype=photo |
Obrazy | |
---|---|
Opis | Opcjonalnie. Zwraca obrazy czarno-białe, w skali szarości lub kolorowe:
|
Przykłady | q=google&as_filetype=png&imgc=gray |
kolor obrazu | |
---|---|
Opis | Opcjonalnie. Zwraca obrazy w określonym kolorze dominującym:
|
Przykłady | q=google&as_filetype=png&imgcolor=yellow |
as_rights | |
---|---|
Opis | Opcjonalnie. Filtry działające na podstawie licencjonowania. Obsługiwane wartości to między innymi:
|
Przykłady | q=cats&as_filetype=png&as_rights=cc_attribute |
Limity żądań
W tabeli poniżej znajdziesz informacje o ograniczeniach dotyczących żądań wyszukiwania wysyłanych do Google:
Komponent | Limit | Komentarz |
---|---|---|
Długość żądania wyszukiwania | 2048 bajtów | |
Liczba wyszukiwanych haseł | 10 | zawiera hasła w następujących parametrach: q, as_epq, as_eq, as_lq, as_oq, as_q. |
Liczba wyników | 20 | Jeśli ustawisz w parametrze num wartość większą niż 20, zwróconych zostanie tylko 20 wyników. Aby uzyskać więcej wyników, musisz wysłać wiele żądań i zwiększać wartość parametru start z każdym żądaniem. |
Prezentacja internacjonalizacji zapytań i wyników
Usługa Google WebSearch umożliwia wyszukiwanie dokumentów w wielu językach. Możesz określić kodowanie znaków, które powinno być używane do interpretowania żądania HTTP i do zakodowania odpowiedzi XML (za pomocą parametrów wyszukiwania ie i oe). Możesz też filtrować wyniki, aby uwzględnić tylko dokumenty napisane w określonych językach.
Te sekcje zawierają omówienie problemów związanych z wyszukiwaniem w wielu językach:
Kodowanie znaków
Serwery wysyłają dane, takie jak strony internetowe, do klientów użytkownika (takich jak przeglądarki) w postaci sekwencji zakodowanych bajtów. Następnie klient użytkownika dekoduje bajty do postaci sekwencji znaków. Wysyłając żądania do usługi WebSearch, możesz określić schematy kodowania zarówno dla zapytania wyszukiwania, jak i otrzymywanej odpowiedzi XML.
Możesz użyć parametru żądania ie, aby określić mechanizm kodowania znaków w żądaniu HTTP. Możesz też użyć parametru oe, aby określić schemat kodowania, którego Google ma użyć do kodowania odpowiedzi XML. Jeśli używasz schematu kodowania innego niż ISO-8859-1
(lub latin1
), podaj prawidłowe wartości parametrów ie i oe.
Uwaga: jeśli udostępniasz funkcję wyszukiwania w wielu językach, zalecamy użycie wartości kodowania utf8
(UTF-8) zarówno dla parametrów ie, jak i oe.
Pełną listę wartości, których możesz używać w parametrach ie i oe, znajdziesz w dodatku do schematów kodowania znaków.
Ogólne informacje o kodowaniu znaków znajdziesz na stronie http://www.w3.org/TR/REC-html40/charset.html.
Języki interfejsu
Możesz użyć parametru żądania hl, aby określić język interfejsu graficznego. Wartość parametru hl może mieć wpływ na wyniki wyszukiwania XML, zwłaszcza w przypadku zapytań międzynarodowych, gdy ograniczenie języka (za pomocą parametru lr) nie jest wyraźnie określone. W takich przypadkach parametr hl może promować wyniki wyszukiwania w tym samym języku co język wprowadzania użytkownika.
Zalecamy wyraźne ustawienie parametru hl w wynikach wyszukiwania, aby dla każdego zapytania Google wybierało wyniki wyszukiwania najwyższej jakości.
Pełną listę prawidłowych wartości parametru hl znajdziesz w sekcji Obsługiwane języki interfejsu.
Wyszukiwanie dokumentów zapisanych w określonych językach
Za pomocą parametru żądania lr możesz ograniczyć wyniki wyszukiwania do dokumentów napisanych w określonym języku lub w zbiorze języków.
Parametr lr obsługuje operatory logiczne, umożliwiając określenie wielu języków, które powinny być uwzględnione (lub wykluczone) z wyników wyszukiwania.
Poniższe przykłady pokazują, jak można używać operatorów logicznych do wysyłania żądań dokumentów w różnych językach.
W przypadku dokumentów napisanych w języku japońskim:
lr=lang_jp
W przypadku dokumentów napisanych w języku włoskim lub niemieckim:
lr=lang_it|lang_de
W przypadku dokumentów napisanych w języku innym niż węgierski lub czeski:
lr=(-lang_hu).(-lang_cs)
Pełną listę możliwych wartości parametru lr i Operatory logiczne znajdziesz w sekcji Language Collection Value (Wartości zbioru języków).
Wyszukiwanie w języku chińskim (uproszczonym i tradycyjnym)
Chiński uproszczony i chiński tradycyjny to 2 warianty pisma. Ta sama koncepcja może być inaczej pisana w każdym z wariantów. Po uwzględnieniu zapytania w jednym z wariantów usługa Google WebSearch może zwrócić wyniki zawierające strony w obu wariantach.
Aby skorzystać z tej funkcji:
- Ustaw parametr żądania c2coff na 0
i - Wykonaj jedną z tych czynności:
Poniższy przykład pokazuje parametry zapytania, które należy uwzględnić w żądaniu wyników w języku chińskim uproszczonym i tradycyjnym. (Pamiętaj, że ten przykład nie zawiera żadnych dodatkowych informacji, takich jak informacje o kliencie).
search?hl=zh-CN &lr=lang_zh-TW|lang_zh-CN &c2coff=0
Filtrowanie wyników
Google WebSearch udostępnia kilka sposobów filtrowania wyników wyszukiwania:
- Automatyczne filtrowanie wyników wyszukiwania
- Filtrowanie języka i kraju
- Filtrowanie treści dla dorosłych przy użyciu filtra SafeSearch
Automatyczne filtrowanie wyników wyszukiwania
Starając się wyświetlać jak najlepsze wyniki wyszukiwania, Google stosuje 2 metody, aby automatycznie odfiltrowywać wyniki wyszukiwania, które są na ogół niepożądane:
-
Powielone treści – jeśli wiele dokumentów zawiera te same informacje, w wynikach wyszukiwania znajdzie się tylko najtrafniejszy dokument z tego zestawu.
-
Nagromadzenie hostów – jeśli z tej samej witryny pochodzi wiele wyników wyszukiwania, Google może nie pokazać wszystkich wyników lub wyświetlać niższe
pozycje w rankingu niż byłoby to możliwe.
Zalecamy pozostawienie tych filtrów włączonych w przypadku typowych wyszukiwań, ponieważ znacznie podnoszą one jakość większości wyników wyszukiwania. Możesz jednak pominąć te filtry automatyczne, ustawiając w żądaniu wyszukiwania parametr zapytania filter na 0.
Filtrowanie języka i kraju
Usługa Google WebSearch zwraca wyniki z indeksu głównego wszystkich dokumentów internetowych. Indeks główny zawiera podzbiory dokumentów pogrupowane według określonych atrybutów, w tym języka i kraju pochodzenia.
Możesz użyć parametrów żądań lr i cr, aby ograniczyć wyniki wyszukiwania do podzbiorów dokumentów napisanych w określonych językach lub pochodzących z określonych krajów.
Google WebSearch określa język dokumentu na podstawie analizy:
- domeny najwyższego poziomu (TLD) adresu URL dokumentu,
- metatagów języka w dokumencie
- głównego języka użytego w tekście dokumentu.
Aby uzyskać więcej informacji o ograniczaniu wyników na podstawie języka, zapoznaj się z definicją parametru lr, sekcją Wyszukiwanie dokumentów spisanych w określonych językach oraz Wartościami zbioru języków, których można użyć jako wartości parametru lr.
Google WebSearch określa kraj dokumentu na podstawie analizy:
- domeny najwyższego poziomu (TLD) adresu URL dokumentu,
- położenie geograficzne adresu IP serwera WWW;
Aby dowiedzieć się więcej o ograniczaniu wyników według kraju pochodzenia, zapoznaj się z definicją parametru cr oraz wartościami zbierania danych dotyczących krajów, które mogą być używane jako wartości parametru cr.
Uwaga: aby dostosowywać wyniki wyszukiwania, możesz połączyć wartości językowe i krajowe. Możesz na przykład poprosić o dokumenty napisane w języku francuskim, pochodzące z Francji lub Kanady lub pochodzące z Holandii, które nie są napisane w języku angielskim. Parametry lr i cr obsługują operatory logiczne.
Filtrowanie treści dla dorosłych przy użyciu filtra SafeSearch
Wielu klientów Google nie chce wyświetlać wyników wyszukiwania witryn zawierających treści dla dorosłych. Filtr SafeSearch umożliwia odfiltrowanie wyników wyszukiwania zawierających treści dla dorosłych i ich usunięcie. Filtry Google sprawdzają słowa kluczowe, wyrażenia i adresy URL przy użyciu zastrzeżonej technologii. Choć żaden filtr nie jest skuteczny w 100%, SafeSearch usuwa z wyników wyszukiwania zdecydowaną większość treści dla dorosłych.
Staramy się, aby filtr SafeSearch był stale aktualny i kompleksowy, stale indeksując zawartość sieci i dostosowując aktualizacje na podstawie sugestii użytkowników.
Filtr SafeSearch jest dostępny w tych językach:
Niderlandzki angielski francuski niemiecki |
włoski portugalski (Brazylia) Hiszpański Chiński tradycyjny |
Za pomocą parametru safe możesz dostosować stopień, w jakim Google filtruje wyniki wyszukiwania pod kątem treści dla dorosłych. W tabeli poniżej znajdziesz informacje o ustawieniach filtra SafeSearch i jego wpływie na wyniki wyszukiwania:
Poziom filtra SafeSearch | Opis |
---|---|
wysoki | Umożliwia bardziej rygorystyczną wersję filtra SafeSearch. |
medium | Blokuje strony internetowe zawierające pornografię i inne treści o charakterze jednoznacznie seksualnym. |
wyłączono | Treści dla dorosłych nie są odfiltrowywane z wyników wyszukiwania. |
* Domyślnym ustawieniem filtra SafeSearch jest wyłączony.
Jeśli masz włączony filtr SafeSearch i znajdziesz witryny, które zawierają w wynikach obraźliwe treści, wyślij e-maila z adresem URL takiej witryny na adres safesearch@google.com, a my ją zbadamy.
Wyniki w formacie XML
- DTD Google z wynikami XML
- Informacje o odpowiedzi XML
- Wyniki XML dla zapytań regularnych i zaawansowanych
- Wyszukiwanie regularne/zaawansowane: przykładowe zapytanie i wynik XML
- Wyszukiwanie regularne/zaawansowane: tagi XML
DTD z wyników XML Google
Do opisania formatu XML wszystkich typów wyników wyszukiwania Google używa tego samego pliku DTD. Wiele tagów i atrybutów ma zastosowanie do wszystkich typów wyszukiwania. Niektóre tagi można jednak stosować tylko w przypadku określonych typów wyszukiwania. W związku z tym definicje zawarte w DTD mogą być mniej restrykcyjne niż definicje podane w tym dokumencie.
W tym dokumencie opisano te aspekty DTD, które mają zastosowanie w przypadku WebSearch. Jeśli pracujesz z WebSearch, podczas przeglądania pliku DTD możesz bezpiecznie zignorować tagi i atrybuty, które nie zostały tu opisane. Jeśli definicja w DTD i dokumentacji różni się od podanej w dokumentacji, zostanie to odnotowane w tym dokumencie.
Google może zwracać wyniki XML z odniesieniem do najnowszego DTD lub bez niego. DTD to przewodnik, który pomaga administratorom wyszukiwania i parserom XML zrozumieć wyniki wyszukiwania XML w Google. Gramatyka XML Google może się od czasu do czasu zmieniać, dlatego nie konfiguruj parsera do sprawdzania każdego wyniku XML za pomocą DTD.
Poza tym nie należy konfigurować parsera XML tak, aby pobierał DTD za każdym razem, gdy przesyłasz żądanie wyszukiwania. Google rzadko aktualizuje DTD, co wiąże się z niepotrzebnymi wymaganiami dotyczącymi opóźnień i przepustowości.
Do uzyskiwania wyników XML zalecamy używanie formatu wyjściowego xml_no_dtd. Jeśli w żądaniu wyszukiwania określisz format xml output, jedyną różnicą będzie uwzględnienie tego wiersza w wynikach XML:
<!DOCTYPE GSP SYSTEM "google.dtd">
Najnowszy plik DTD znajdziesz na http://www.google.com/google.dtd.
Pamiętaj, że nie wszystkie funkcje dostępne na DTD mogą być obecnie dostępne lub obsługiwane.
Informacje o odpowiedzi XML
- Wszystkie wartości elementów to prawidłowy kod HTML odpowiedni do wyświetlania, chyba że w definicjach tagów XML zaznaczono inaczej.
- Niektóre wartości elementów to adresy URL, które przed wyświetleniem muszą zostać zakodowane w języku HTML.
- Parser XML powinien ignorować nieudokumentowane atrybuty i tagi. Dzięki temu aplikacja może działać bez modyfikacji, jeśli Google doda więcej funkcji do danych wyjściowych XML.
- W przypadku niektórych znaków znajdujących się jako wartości w tagach XML należy zmienić znaczenie znaków. Twój procesor XML powinien przekonwertować te elementy z powrotem na odpowiednie znaki. Jeśli nie konwertujesz elementów prawidłowo, przeglądarka może np. wyświetlić znak & jako „&".
Standard XML dokumentuje te znaki. Są one odtwarzane w tabeli poniżej:
Znak Formularze ze zmianą znaczenia Element Kod znaku Znak & i & & Pojedynczy cudzysłów ' ' ' Podwójny cudzysłów ” " " Większe niż > > > Mniejsze niż < < <
Wyniki XML dla zapytań regularnych i zaawansowanych
Wyszukiwanie regularne/zaawansowane: przykładowe zapytanie i wynik XML
To przykładowe żądanie w WebSearch zawiera 10 wyników (num=10
) dotyczących wyszukiwanego hasła „socer” (q=socer
), które jest celowo błędnie napisanym słowem „piłka nożna”.
http://www.google.com/search?
q=socer
&hl=en
&start=10
&num=10
&output=xml
&client=google-csbe
&cx=00255077836266642015:u-scht7a-8i
To żądanie zwraca poniższy wynik XML. Pamiętaj, że w wyniku XML znajduje się kilka komentarzy, które wskazują, gdzie pojawią się niektóre tagi, których nie ma w wyniku.
<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?>
<GSP VER="3.2">
<TM>0.452923</TM>
<Q>socer</Q>
<PARAM name="cx" value="00255077836266642015:u-scht7a-8i" original_value="00255077836266642015%3Au-scht7a-8i"/>
<PARAM name="hl" value="en" original_value="en"/>
<PARAM name="q" value="socer" original_value="socer"/>
<PARAM name="output" value="xml" original_value="xml"/>
<PARAM name="client" value="google-csbe" original_value="google-csbe"/>
<PARAM name="num" value="10" original_value="10"/>
<Spelling>
<Suggestion q="soccer"><b><i>soccer</i></b></Suggestion>
</Spelling>
<Context>
<title>Sample Vacation CSE</title>
<Facet>
<FacetItem>
<label>restaurants</label>
<anchor_text>restaurants</anchor_text>
</FacetItem>
<FacetItem>
<label>wineries</label>
<anchor_text>wineries</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>golf_courses</label>
<anchor_text>golf courses</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>hotels</label>
<anchor_text>hotels</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>nightlife</label>
<anchor_text>nightlife</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>soccer_sites</label>
<anchor_text>soccer sites</anchor_text>
</FacetItem>
</Facet>
</Context>
<RES SN="1" EN="10">
<M>6080</M>
/*
* The FI tag after the comment indicates that the result
* set has been filtered. If the number of results were exact, the
* FI tag would be replaced by an XT tag in the same format.
*/
<FI />
<NB>
/*
* Since the request is for the first page of results, the PU tag,
* which contains a link to the previous page of search results,
* is not included in this XML result. If the sample result did include
* a previous page of results, it would be listed here, in the same format
* as the NU tag on the following line
*/
<NU>/search?q=socer&hl=en&lr=&ie=UTF-8&output=xml&client=test&start=10&sa=N</NU>
</NB>
<R N="1">
<U>http://www.soccerconnection.net/</U>
<UE>http://www.soccerconnection.net/</UE>
<T>SoccerConnection.net</T>
<CRAWLDATE>May 21, 2007</CRAWLDATE>
<S><b>soccer</b>; players; coaches; ball; world cup;<b>...</b></S>
<Label>transcodable_pages</Label>
<Label>accessible</Label>
<Label>soccer_sites</Label>
<LANG>en</LANG>
<HAS>
<DI>
<DT>SoccerConnection.net</DT>
<DS>Post your <b>soccer</b> resume directly on the Internet.</DS>
</DI>
<L/>
<C SZ="8k" CID="kWAPoYw1xIUJ"/>
<RT/>
</HAS>
</R>
/*
* The result includes nine more results, each enclosed by an R tag.
*/
</RES>
</GSP>
Wyszukiwanie standardowe/zaawansowane: tagi XML
Odpowiedzi XML na zwykłe i zaawansowane żądania wyszukiwania korzystają z tego samego zestawu tagów XML. Te tagi XML zostały przedstawione w powyższym przykładzie w formacie XML i zostały omówione w tabelach poniżej.
Tagi XML poniżej są uporządkowane alfabetycznie według nazwy tagu. Każda definicja tagu zawiera opis tagu, przykład pokazujący, jak tag będzie wyglądał w wynikach XML, oraz format jego treści. Jeśli tag jest tagiem podrzędnym innego tagu XML albo ma własne tagi podrzędne lub atrybuty, informacje o tym znajdziesz w tabeli definicji tagu.
W poniższych definicjach obok niektórych subtagów mogą być wyświetlane określone symbole. Znajdziesz je poniżej wraz z informacją o znaczeniu.
* = zero lub więcej wystąpień subtagu
+ = co najmniej 1 wystąpienie subtagu
P | B | C | D | P | P | P | S | P | P | N | P | P | R | Informacje o stanie kampanii | T | X |
anchor_text | |
---|---|
Definicja | Tag <anchor_text> określa tekst, który należy wyświetlać użytkownikom, aby zidentyfikować etykietę doprecyzowania powiązaną ze zbiorem wyników wyszukiwania. Etykiety zawężania wyszukiwania zastępują znaki niealfanumeryczne znakami podkreślenia, dlatego nie należy wyświetlać wartości tagu <label> w interfejsie użytkownika. Zamiast tego należy wyświetlać wartość tagu <anchor_text>. |
Przykład | <Anchor_text>pola golfowe</Anchor_text> |
Subtag | FacetItem |
Format treści | Tekst |
ZABLOKUJ | |
---|---|
Definicja | Ten tag zawiera treść bloku w wierszu treści wyniku promocji. Każdy blok ma tagi podrzędne T, U i L. Niepusty tag T wskazuje, że blok zawiera tekst. Niepuste tagi U i L wskazują, że blok zawiera link (adres URL podany w subtagu U i tekście kotwicy w podtagu L). |
Subtagi | T, U, L |
Subtag | BODY_LINE |
Format treści | Pusta |
BODY_LINE | |
---|---|
Definicja | Ten tag umieszcza treść wiersza w treści promowanego wyniku. Każdy wiersz treści składa się z kilku tagów ZABLOKUJ, które zawierają tekst lub link z adresem URL i tekstem kotwicy. |
Subtagi | ZABLOKUJ* |
Subtag | SL_MAIN |
Format treści | Pusta |
C | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definicja | Tag <C> wskazuje, że usługa WebSearch może pobrać wersję adresu URL tego wyniku wyszukiwania z pamięci podręcznej. Za pomocą interfejsu XML API nie możesz pobierać stron z pamięci podręcznej, ale możesz przekierowywać użytkowników na stronę www.google.com. |
|||||||||
Atrybuty |
|
|||||||||
Przykład | <C SZ="6k" CID="kvOXK_cYSSgJ" /> | |||||||||
Subtag | HAS | |||||||||
Format treści | Pusta |
Ścieżka konwersji | |
---|---|
Definicja | Tag <C2C> wskazuje, że wynik odnosi się do strony w języku chińskim tradycyjnym. Ten tag pojawia się tylko wtedy, gdy włączone jest wyszukiwanie w języku chińskim uproszczonym i tradycyjnym. Więcej informacji o włączaniu i wyłączaniu tej funkcji znajdziesz w definicji parametru zapytania c2coff. |
Format treści | Tekst |
Kontekst | |
---|---|
Definicja | Tag <Context> zawiera listę etykiet zawężających wyszukiwanie powiązanych ze zbiorem wyników wyszukiwania. |
Przykład | <Context> |
Subtagi | tytuł, aspekt+ |
Format treści | Kontener |
CRAWLDATE | |
---|---|
Definicja | Tag <CRAWLDATE> podaje datę ostatniego indeksowania strony. |
Przykład | <CRAWLDATE>21 maja 2005 r.</CRAWLDATE> |
Subtag | R |
Format treści | Tekst |
DI | |
---|---|
Definicja | Tag <DI> zawiera informacje o kategorii Open Directory Project (ODP) pojedynczego wyniku wyszukiwania. |
Przykład | <DI> |
Subtagi | DT?, DS? |
Subtag | HAS |
Format treści | Pusta |
DS | |
---|---|
Definicja | Tag <DS> zawiera podsumowanie dotyczące pojedynczej kategorii w katalogu ODP. |
Przykład | <DS>Opublikuj swoje CV bezpośrednio w internecie.</DS> |
Subtag | DI |
Format treści | Tekst (może zawierać kod HTML) |
DT | |
---|---|
Definicja | Tag <DT> zawiera tytuł pojedynczej kategorii wymienionej w katalogu ODP. |
Przykład | <DT>SoccerConnection.net</DT> |
Subtag | DI |
Format treści | Tekst (może zawierać kod HTML) |
Aspekt | |
---|---|
Definicja | Tag <Facet> zawiera logiczne grupowanie tagów <FacetItem>. Takie grupowania możesz utworzyć w formacie specyfikacji XML w wyszukiwarce niestandardowej. Jeśli nie utworzysz tych grupowania, tag results_xml_tag_Context><Context> będzie zawierał maksymalnie 4 tagi <Facet>. Elementy w każdym tagu <Facet> będą zgrupowane do celów związanych z wyświetlaniem, ale mogą nie być ze sobą logiczne. |
Przykład | <Facet> |
Subtagi | FacetItem+, title+ |
Subtag | Kontekst |
Format treści | Kontener |
FacetItem | |
---|---|
Definicja | Tag <FacetItem> zawiera informacje o etykiecie zawężenia wyszukiwania powiązanej z zestawem wyników wyszukiwania. |
Przykład | <FacetItem> |
Subtagi | label, anchor_text+ |
Subtag | Aspekt |
Format treści | FacetItem |
FI | |
---|---|
Definicja | Tag <FI> wskazuje, czy dla wyszukiwania przeprowadzono filtrowanie dokumentów. Więcej informacji o filtrach wyników wyszukiwania Google znajdziesz w sekcji Automatyczne filtrowanie w tym dokumencie. |
Przykład | <FI /> |
Subtag | Odp. |
Format treści | Pusta |
Oferty wyróżnione w Gmailu | |||||||
---|---|---|---|---|---|---|---|
Definicja | Tag <GSP> zawiera wszystkie dane zwrócone w wynikach wyszukiwania Google w formacie XML. „GSP” to skrót od „Google Search Protocol”. |
||||||
Atrybuty |
|
||||||
Przykład | <GSP VER="3.2"> | ||||||
Subtagi | PARAM+, Q, RES?, TM | ||||||
Format treści | Pusta |
HAS | |
---|---|
Definicja | Tag <HAS> zawiera informacje o wszelkich specjalnych parametrach żądania wyszukiwania obsługiwanych w przypadku określonego adresu URL.
Uwaga: definicja elementu <HAS> w WebSearch jest bardziej restrykcyjna niż w DTD. |
Subtagi | DI?, L?, C?, RT? |
Subtag | R |
ISURL | |
---|---|
Definicja | Google zwraca tag <ISURL>, jeśli powiązane zapytanie jest adresem URL. |
Subtag | oferta wyróżniona w Gmailu |
Format treści | Pusta |
L | |
---|---|
Definicja | Obecność tagu <L> wskazuje, że usługa WebSearch może znajdować inne witryny zawierające linki do tego adresu URL wyniku wyszukiwania. Aby znaleźć takie witryny, użyj specjalnego hasła w zapytaniu link:. |
Subtag | HAS |
Format treści | Pusta |
label | |
---|---|
Definicja | Tag <label> określa etykietę zawężenia wyszukiwania, której można używać do filtrowania otrzymywanych wyników wyszukiwania. Aby użyć etykiety zawężającej wyszukiwanie, dodaj ciąg more:[[wartość tagu etykiety]] do wartości parametru q w żądaniu HTTP wysyłanym do Google, jak pokazano w poniższym przykładzie. Zanim wyślesz zapytanie do Google, ta wartość musi zawierać zmianę znaczenia adresu URL. This example uses the refinement label golf_courses to Uwaga: tag <label> to nie to samo co tag <Label>, który wskazuje etykietę zawężania wyszukiwania powiązaną z konkretnym adresem URL w wynikach wyszukiwania. |
Przykład | <label>pole_golfowe</label> |
Subtag | FacetItem |
Format treści | Tekst |
Język | |
---|---|
Definicja | Tag <LANG> zawiera najbardziej prawdopodobny język wyników wyszukiwania Google. |
Przykład | <LANG>en</LANG> |
Subtag | R |
Format treści | Tekst |
P | |
---|---|
Definicja | Tag <M> określa szacowaną łączną liczbę wyników wyszukiwania. Uwaga: te dane mogą być niedokładne. |
Przykład | <M>16200000</M> |
Subtag | Odp. |
Format treści | Tekst |
NB | |
---|---|
Definicja | Tag <NB> zawiera informacje nawigacyjne zbioru wyników, czyli linki do następnej lub poprzedniej strony wyników wyszukiwania. Uwaga: ten tag występuje tylko wtedy, gdy dostępnych jest więcej wyników. |
Przykład | <NB> |
Subtagi | NU?, Jednostka przetwarzania? |
Subtag | Odp. |
Format treści | Pusta |
NU | |
---|---|
Definicja | Tag <NU> zawiera względny link do następnej strony wyników wyszukiwania. |
Przykład | <NU>/search?q=flowers&num=10&hl=pl&ie=UTF-8 &output=xml&client=test&start=10</NU> |
Subtag | NB |
Format treści | Tekst (względny URL) |
PARAMETR | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Definicja | Tag <PARAM> wskazuje parametr wejściowy przesłany w żądaniu HTTP powiązanym z wynikiem XML. Informacje o parametrze są zawarte w atrybutach tagów – name, value, original_value – a dla każdego parametru przesłanego w żądaniu HTTP pojawi się jeden tag PARAM. |
||||||||||||
Atrybuty |
|
||||||||||||
Przykład | <PARAM name="cr" value="countryNZ" original_value="countryNZ" /> | ||||||||||||
Subtag | oferta wyróżniona w Gmailu | ||||||||||||
Format treści | Złożony |
Jednostka przetwarzania | |
---|---|
Definicja | Tag <PU> zawiera względny link do poprzedniej strony wyników wyszukiwania. |
Przykład | <PU>/search?q=kwiaty&num=10&hl=pl&output=xml &client=test&start=10</PU> |
Subtag | NB |
Format treści | Tekst (względny URL) |
P | |
---|---|
Definicja | Tag <Q> określa zapytanie przesłane w żądaniu HTTP powiązanym z wynikiem XML. |
Przykład | <Q>pizza</Q> |
Subtag | oferta wyróżniona w Gmailu |
Format treści | Tekst |
R | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definicja | Tag <R> zawiera szczegóły poszczególnych wyników wyszukiwania. Uwaga: definicja tagu <R> w WebSearch jest bardziej restrykcyjna niż w DTD. |
|||||||||
Atrybuty |
|
|||||||||
Subtagi | U, UE, T?, CRAWLDATE, S?, LANGUAGE?, HAS | |||||||||
Subtag | Odp. |
RES | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definicja | Tag <RES> zawiera zbiór poszczególnych wyników wyszukiwania wraz ze szczegółami. |
|||||||||
Atrybuty |
|
|||||||||
Przykład | <RES SN="1" EN="10"> | |||||||||
Subtagi | M, FI?, XT?, NB?, R* | |||||||||
Subtag | oferta wyróżniona w Gmailu | |||||||||
Format treści | Pusta |
S | |
---|---|
Definicja | Tag <S> zawiera fragment wyniku wyszukiwania, w którym wyszukiwane hasła są wyróżnione pogrubieniem. Podziały wierszy są umieszczane w wyciągu, aby zapewnić prawidłowe zawijanie tekstu. |
Przykład | <S>Waszyngton (CNN) – stawka mająca na celu zakończenie wyborów w sprawie prezydenta w sprawie wyborów prezydenckich z udziałem prezydenta <b>Busha Busha. W wyniku wyborów 5 osób wybranych przez sąd umożliwiłoby głosowanie ostateczne, a jednocześnie zachowało się miejsce w wyborach... |
Subtag | R |
Format treści | Tekst (HTML) |
SL_MAIN | |
---|---|
Definicja | Ten tag zawiera treść wyniku promocji. Służy do analizowania promocji. Tekst kotwicy i adres URL linku z tytułem są zawarte odpowiednio w subtagach T i U. Wiersze tekstu głównego i linków są zawarte w podtagach BODY_LINE. |
Subtagi | BODY_LINE*, T, U |
Subtag | SL_RESULTS |
Format treści | Pusta |
SL_RESULTS | |
---|---|
Definicja | Tag kontenera na potrzeby promowanych wyników. Jeden z nich będzie wyświetlany zawsze, gdy pojawi się promocja w wynikach wyszukiwania. Subtag SL_MAIN zawiera główne dane dotyczące wyników. |
Subtagi | SL_MAIN* |
Subtag | R |
Format treści | Pusta |
Pisownia | |
---|---|
Definicja | Tag <Spelling> zawiera alternatywną sugestię pisowni dla przesłanego zapytania. Ten tag pojawia się tylko na pierwszej stronie wyników wyszukiwania. Sugestie pisowni są dostępne w języku angielskim, chińskim, japońskim i koreańskim. Uwaga: Google zwraca sugestie pisowni tylko w przypadku zapytań, w których wartość parametru gl jest zapisana małymi literami. |
Przykład | <Spelling> |
Subtagi | Sugestia |
Subtag | oferta wyróżniona w Gmailu |
Format treści | Pusta |
Sugestia | |||||||
---|---|---|---|---|---|---|---|
Definicja | Tag <Suggestion> zawiera propozycję innej pisowni dla przesłanego zapytania. Dzięki treści tagu możesz zasugerować użytkownikowi przeprowadzającym wyszukiwanie inną pisownię. Wartość atrybutu q to sugestia poprawy pisowni adresu URL, której można użyć jako hasła w zapytaniu. | ||||||
Atrybuty |
|
||||||
Przykład | <Suggestion q="soccer"><b><i>piłka</i></b></Suggestion> | ||||||
Subtag | Pisownia | ||||||
Format treści | Tekst (HTML) |
T | |
---|---|
Definicja | Tag <T> zawiera tytuł wyniku. |
Przykład | <T>Pizzeria na Wschodnim Wybrzeżu Amici</T> |
Subtag | R |
Format treści | Tekst (HTML) |
title | |
---|---|
Definicja | Tag <title>, który jest elementem podrzędnym elementu <Context>, zawiera nazwę Wyszukiwarki niestandardowej. Tag <title>, jako element potomny tagu <Facet>, dostarcza tytuł zestawu aspektów. |
Przykład | Jako element podrzędny tagu <Context>: <title>Moja wyszukiwarka</title> Jako element podrzędny elementu <Facet>: <title>facet title</title> |
Subtag | Kontekst, Aspekt |
Format treści | Tekst |
TM | |
---|---|
Definicja | Tag <TM> określa całkowity czas serwera potrzebny do zwrócenia wyników wyszukiwania (wyrażony w sekundach). |
Przykład | <TM>0,100445</TM> |
Subtag | oferta wyróżniona w Gmailu |
Format treści | Tekst (liczba zmiennoprzecinkowa) |
TT | |
---|---|
Definicja | Tag <TT> zawiera wskazówkę dotyczącą wyszukiwania. |
Przykład | <TT><i>Wskazówka: w większości przeglądarek naciśnięcie klawisza Return daje takie same wyniki jak kliknięcie przycisku wyszukiwania.</i></TT> |
Subtag | oferta wyróżniona w Gmailu |
U | |
---|---|
Definicja | Tag <U> zawiera adres URL wyniku wyszukiwania. |
Przykład | <U>http://www.dominos.com/</U> |
Subtag | R |
Format treści | Tekst (bezwzględny URL) |
Uniwersalna | |
---|---|
Definicja | Tag <UD> podaje adres URL wyniku wyszukiwania zakodowany w systemie IDN (międzynarodowa nazwa domeny). Ta wartość umożliwia wyświetlanie domen w językach lokalnych. Na przykład adres URL zakodowany w IDN http://www.%E8%8A%B1%E4%BA%95.com może zostać zdekodowany i wyświetlony jako http://www.花小鮨.com. Ten tag <UD> będzie uwzględniany w wynikach wyszukiwania tylko w przypadku żądań zawierających parametr ud. Uwaga: jest to funkcja w wersji beta. |
Przykład | <UD>http://www.%E8%8A%B1%E4%BA%95.com/</UD> |
Subtag | R |
Format treści | Tekst (adres URL zakodowany w formacie IDN) |
UE | |
---|---|
Definicja | Tag <UE> zawiera adres URL wyniku wyszukiwania. Wartość jest zakodowana ze zmianą znaczenia, dzięki czemu jest odpowiednia do przekazywania jako parametru zapytania w adresie URL. |
Przykład | <UE>http://www.dominos.com/</UE> |
Subtag | R |
Format treści | Tekst (adres URL ze zmianą znaczenia dla adresu URL) |
XT | |
---|---|
Definicja | Tag <XT> wskazuje, że szacowana łączna liczba wyników, określona za pomocą tagu M, faktycznie odzwierciedla dokładną łączną liczbę wyników. Więcej informacji znajdziesz w sekcji Automatyczne filtrowanie w tym dokumencie. |
Przykład | <XT /> |
Subtag | Odp. |
Format treści | Pusta |
Wyniki XML dla zapytań graficznych
To przykładowe żądanie grafiki zawiera 5 wyników (num=5) dotyczących wyszukiwanego hasła „małpa” (q=małpa).
http://www.google.com/cse? searchtype=image &num=2 &q=monkey &client=google-csbe &output=xml_no_dtd &cx=00255077836266642015:u-scht7a-8i
To żądanie zwraca poniższy wynik XML.
<GSP VER="3.2"> <TM>0.395037</TM> <Q>monkeys</Q> <PARAM name="cx" value="011737558837375720776:mbfrjmyam1g" original_value="011737558837375720776:mbfrjmyam1g" url_<escaped_value="011737558837375720776%3Ambfrjmyam1g" js_escaped_value="011737558837375720776:mbfrjmyam1g"/> <PARAM name="client" value="google-csbe" original_value="google-csbe" url_escaped_value="google-csbe" js_escaped_value="google-csbe"/> <PARAM name="q" value="monkeys" original_value="monkeys" url_escaped_value="monkeys" js_escaped_value="monkeys"/> <PARAM name="num" value="2" original_value="2" url_escaped_value="2" js_escaped_value="2"/> <PARAM name="output" value="xml_no_dtd" original_value="xml_no_dtd" url_escaped_value="xml_no_dtd" js_escaped_value="xml_no_dtd"/> <PARAM name="adkw" value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" original_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" url_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" js_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A"/> <PARAM name="hl" value="en" original_value="en" url_escaped_value="en" js_escaped_value="en"/> <PARAM name="oe" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/> <PARAM name="ie" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/> <PARAM name="boostcse" value="0" original_value="0" url_escaped_value="0" js_escaped_value="0"/> <Context> <title>domestigeek</title> </Context> <ARES/> <RES SN="1" EN="2"> <M>2500000</M> <NB> <NU>/images?q=monkeys&num=2&hl=en&client=google-csbe&cx=011737558837375720776:mbfrjmyam1g&boostcse=0&output=xml_no_dtd &ie=UTF-8&oe=UTF-8&tbm=isch&ei=786oTsLiJaaFiALKrPChBg&start=2&sa=N </NU> </NB> <RG START="1" SIZE="2"/> <R N="1" MIME="image/jpeg"> <RU>http://www.flickr.com/photos/fncll/135465558/</RU> <U> http://farm1.static.flickr.com/46/135465558_123402af8c.jpg </U> <UE> http://farm1.static.flickr.com/46/135465558_123402af8c.jpg </UE> <T>Computer <b>Monkeys</b> | Flickr - Photo Sharing!</T> <RK>0</RK> <BYLINEDATE>1146034800</BYLINEDATE> <S>Computer <b>Monkeys</b> | Flickr</S> <LANG>en</LANG> <IMG WH="500" HT="305" IID="ANd9GcQARKLwzi-t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"> <SZ>88386</SZ> <IN/> </IMG> <TBN TYPE="0" WH="130" HT="79" URL="http://t0.gstatic.com/images?q=tbn:ANd9GcQARKLwzi- t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"/> </R> <R N="2" MIME="image/jpeg"> <RU> http://www.flickr.com/photos/flickerbulb/187044366/ </RU> <U> http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg </U> <UE> http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg </UE> <T> one. ugly. <b>monkey</b>. | Flickr - Photo Sharing! </T> <RK>0</RK> <BYLINEDATE>1152514800</BYLINEDATE> <S>one. ugly. <b>monkey</b>.</S> <LANG>en</LANG> <IMG WH="400" HT="481" IID="ANd9GcQ3Qom0bYbee4fThCQVi96jMEwMU6IvVf2b8K5vERKVw- EF4tQQnDDKOq0"><SZ>58339</SZ> <IN/> </IMG> <TBN TYPE="0" WH="107" HT="129" URL="http://t1.gstatic.com/images?q=tbn:ANd9GcQ3Qom0bYbee4fThCQ Vi96jMEwMU6IvVf2b8K5vERKVw-EF4tQQnDDKOq0"/> </R> </RES> </GSP>
Wyszukiwarka grafiki: tagi XML
Tabela poniżej zawiera dodatkowe tagi XML używane w odpowiedziach XML na zapytania w wyszukiwarce grafiki.
W poniższych definicjach obok niektórych subtagów mogą być wyświetlane określone symbole. Znajdziesz je poniżej wraz z informacją o znaczeniu.
* = zero lub więcej wystąpień subtagu
+ = co najmniej 1 wystąpienie subtagu
RG | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definicja | Tag <RG> zawiera szczegóły poszczególnych wyników wyszukiwania grafiki. |
|||||||||
Atrybuty |
| |||||||||
Subtag | Odp. |
RU | |
---|---|
Definicja | Tag <RU tag> zawiera szczegółowe informacje o każdym wyniku wyszukiwania grafiki. |
Subtag | R |