Zwraca metadane dotyczące przeprowadzonego wyszukiwania, metadane użyte do wyszukiwania oraz wyniki wyszukiwania.
Żądanie HTTP
GET https://customsearch.googleapis.com/customsearch/v1
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
Parametry | |
---|---|
c2coff |
Włącza lub wyłącza wyszukiwanie w języku chińskim tradycyjnym i uproszczonym. Domyślna wartość tego parametru to 0 (zero), co oznacza, że funkcja jest włączona. Obsługiwane wartości to:
|
cr |
Ogranicza wyniki wyszukiwania do dokumentów pochodzących z określonego kraju. W wartości parametru cr możesz użyć operatorów logicznych. Wyszukiwarka Google określa kraj dokumentu na podstawie analizy:
Listę prawidłowych wartości tego parametru znajdziesz na stronie Wartości parametrów krajowych. |
cx |
Identyfikator Wyszukiwarki niestandardowej, która ma zostać użyta w tym żądaniu. |
dateRestrict |
Ogranicza wyniki do adresów URL na podstawie daty. Obsługiwane wartości to między innymi:
|
exactTerms |
Określa wyrażenie, które muszą zawierać wszystkie dokumenty w wynikach wyszukiwania. |
excludeTerms |
Identyfikuje słowo lub wyrażenie, które nie powinno występować w żadnym dokumencie w wynikach wyszukiwania. |
fileType |
Ogranicza wyniki do plików z określonym rozszerzeniem. Listę typów plików możliwych do zindeksowania przez Google znajdziesz w Centrum pomocy Search Console. |
filter |
Służy do włączania i wyłączania filtra powielonych treści.
Dopuszczalne wartości:
|
gl |
Geolokalizacja użytkownika.
|
googlehost |
Wycofano. W celu uzyskania podobnego efektu użyj parametru Lokalna domena Google (na przykład google.com, google.de lub google.fr), która ma zostać użyta do wyszukiwania. |
highRange |
Określa wartość końcową dla zakresu wyszukiwania.
|
hl |
Ustawia język interfejsu użytkownika.
|
hq |
Dodaje określone hasła do zapytania w taki sposób, jakby zostały połączone za pomocą operatora logicznego AND. |
imgColorType |
Wyświetla obrazy czarno-białe, w skali szarości, przezroczyste lub kolorowe. Dopuszczalne wartości:
|
imgDominantColor |
Zwraca obrazy w określonym kolorze dominującym. Dopuszczalne wartości:
|
imgSize |
Zwraca obrazy o określonym rozmiarze. Dopuszczalne wartości:
|
imgType |
Zwraca obrazy określonego typu. Dopuszczalne wartości:
|
linkSite |
Określa, że wszystkie wyniki wyszukiwania powinny zawierać link do określonego adresu URL. |
lowRange |
Określa wartość początkową zakresu wyszukiwania. Użyj funkcji |
lr |
Ogranicza wyszukiwanie do dokumentów napisanych w określonym języku (np. Dopuszczalne wartości:
|
num |
Liczba wyników wyszukiwania do zwrócenia.
|
orTerms |
Zawiera dodatkowe wyszukiwane hasła do sprawdzenia w dokumencie. Każdy dokument w wynikach wyszukiwania musi zawierać co najmniej jedno z dodatkowych wyszukiwanych haseł. |
q |
Zapytanie |
relatedSite |
Rola wycofana. |
rights |
Filtry działające na podstawie licencjonowania. Obsługiwane wartości to: |
safe |
Poziom bezpieczeństwa wyszukiwania. Dopuszczalne wartości:
|
searchType |
Określa typ wyszukiwania: Dopuszczalne wartości:
|
siteSearch |
Wskazuje daną witrynę, która zawsze powinna być uwzględniana w wynikach lub z niego wykluczana (patrz parametr |
siteSearchFilter |
Określa, czy mają być uwzględniane czy wykluczane wyniki z witryny wymienionej w parametrze Dopuszczalne wartości:
|
sort |
Wyrażenie sortowania, które ma zostać zastosowane do wyników. Parametr sortowania określa, że wyniki mają być sortowane według określonego wyrażenia, tj. według daty. Przykład: sort=date. |
start |
Indeks pierwszego wyniku do zwrócenia. Domyślna liczba wyników na stronę to 10, więc |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Search
.
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/cse
Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.