Method: cse.siterestrict.list

Zwraca metadane dotyczące przeprowadzonego wyszukiwania, metadane użyte do wyszukiwania oraz wyniki wyszukiwania. Używa małego zestawu wzorców adresów URL.

Żądanie HTTP

GET https://customsearch.googleapis.com/customsearch/v1/siterestrict

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
c2coff

string

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:

  • 1: wyłączono

  • 0: włączone (domyślnie)

cr

string

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:

  • domeny najwyższego poziomu (TLD) adresu URL dokumentu,

  • położenie geograficzne adresu IP serwera WWW;

Listę prawidłowych wartości tego parametru znajdziesz na stronie Wartości parametrów krajowych.

cx

string

Identyfikator Wyszukiwarki niestandardowej, która ma zostać użyta w tym żądaniu.

dateRestrict

string

Ogranicza wyniki do adresów URL na podstawie daty. Obsługiwane wartości to między innymi:

  • d[number]: żąda wyników z określonej liczby ostatnich dni.

  • w[number]: żąda wyników z określonej liczby ostatnich tygodni.

  • m[number]: prosi o wyniki z określonej liczby ostatnich miesięcy.

  • y[number]: żądania wyników z określonej liczby ubiegłych lat.

exactTerms

string

Określa wyrażenie, które muszą zawierać wszystkie dokumenty w wynikach wyszukiwania.

excludeTerms

string

Identyfikuje słowo lub wyrażenie, które nie powinno występować w żadnym dokumencie w wynikach wyszukiwania.

fileType

string

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

string

Służy do włączania i wyłączania filtra powielonych treści.

  • Więcej informacji o filtrach wyników wyszukiwania Google znajdziesz w sekcji Automatyczne filtrowanie. Pamiętaj, że filtrowanie według hostów dotyczy tylko wyszukiwania w wielu witrynach.

  • Domyślnie Google stosuje filtrowanie do wszystkich wyników wyszukiwania, aby poprawić ich jakość.

Dopuszczalne wartości:

  • 0: wyłącza filtr powielania treści.

  • 1: włącza filtr powielonych treści.

gl

string

Geolokalizacja użytkownika.

  • Wartość parametru gl to dwuliterowy kod kraju. Parametr gl zwiększa wyniki wyszukiwania, których kraj pochodzenia jest zgodny z wartością parametru. Lista prawidłowych wartości znajduje się na stronie Kody krajów.

  • Jeśli określisz wartość parametru gl, wyniki powinny być trafniejsze. Jest to szczególnie istotne w przypadku klientów międzynarodowych, a w szczególności klientów z krajów anglojęzycznych poza Stanami Zjednoczonymi.

googlehost

string

Wycofano. W celu uzyskania podobnego efektu użyj parametru gl.

Lokalna domena Google (na przykład google.com, google.de lub google.fr), która ma zostać użyta do wyszukiwania.

highRange

string

Określa wartość końcową dla zakresu wyszukiwania.

  • Użyj funkcji lowRange i highRange, aby dołączyć do zapytania zakres wyszukiwania obejmujący lowRange...highRange.
hl

string

Ustawia język interfejsu użytkownika.

hq

string

Dodaje określone hasła do zapytania w taki sposób, jakby zostały połączone za pomocą operatora logicznego AND.

imgColorType

enum (ImgColorType)

Wyświetla obrazy czarno-białe, w skali szarości, przezroczyste lub kolorowe. Dopuszczalne wartości:

  • "color"

  • "gray"

  • "mono": czarno-biały

  • "trans": przezroczyste tło

imgDominantColor

enum (ImgDominantColor)

Zwraca obrazy w określonym kolorze dominującym. Dopuszczalne wartości:

  • "black"

  • "blue"

  • "brown"

  • "gray"

  • "green"

  • "orange"

  • "pink"

  • "purple"

  • "red"

  • "teal"

  • "white"

  • "yellow"

imgSize

enum (ImgSize)

Zwraca obrazy o określonym rozmiarze. Dopuszczalne wartości:

  • "huge"

  • "icon"

  • "large"

  • "medium"

  • "small"

  • "xlarge"

  • "xxlarge"

imgType

enum (ImgType)

Zwraca obrazy określonego typu. Dopuszczalne wartości:

  • "clipart"

  • "face"

  • "lineart"

  • "stock"

  • "photo"

  • "animated"

lowRange

string

Określa wartość początkową zakresu wyszukiwania. Użyj funkcji lowRange i highRange, aby dołączyć do zapytania zakres wyszukiwania obejmujący lowRange...highRange.

lr

string

Ogranicza wyszukiwanie do dokumentów napisanych w określonym języku (np. lr=lang_ja).

Dopuszczalne wartości:

  • "lang_ar": arabski

  • "lang_bg": bułgarski

  • "lang_ca": kataloński

  • "lang_cs": czeski

  • "lang_da": duński

  • "lang_de": niemiecki

  • "lang_el": grecki

  • "lang_en": angielski

  • "lang_es": hiszpański

  • "lang_et": estoński

  • "lang_fi": fiński

  • "lang_fr": francuski

  • "lang_hr": chorwacki

  • "lang_hu": węgierski

  • "lang_id": indonezyjski

  • "lang_is": islandzki

  • "lang_it": włoski

  • "lang_iw": hebrajski

  • "lang_ja": japoński

  • "lang_ko": koreański

  • "lang_lt": litewski

  • "lang_lv": łotewski

  • "lang_nl": niderlandzki

  • "lang_no": norweski

  • "lang_pl": polski

  • "lang_pt": portugalski

  • "lang_ro": rumuński

  • "lang_ru": rosyjski

  • "lang_sk": słowacki

  • "lang_sl": słoweński

  • "lang_sr": serbski

  • "lang_sv": szwedzki

  • "lang_tr": turecki

  • "lang_zh-CN": chiński (uproszczony).

  • "lang_zh-TW": chiński (tradycyjny),

num

integer

Liczba wyników wyszukiwania do zwrócenia.

  • Prawidłowe wartości to liczby całkowite z zakresu od 1 do 10 włącznie.
orTerms

string

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

string

Zapytanie

relatedSite
(deprecated)

string

Rola wycofana.

rights

string

Filtry działające na podstawie licencjonowania. Obsługiwane wartości to: cc_publicdomain, cc_attribute, cc_sharealike, cc_noncommercial, cc_nonderived oraz te kombinacje. Zobacz typowe kombinacje.

safe

enum (Safe)

Poziom bezpieczeństwa wyszukiwania. Dopuszczalne wartości:

  • "active": włącza filtr SafeSearch.

  • "off": wyłącza filtrowanie SafeSearch. (domyślna)

searchType

enum (SearchType)

Określa typ wyszukiwania: image. Jeśli nie określono inaczej, wyniki będą ograniczone do stron internetowych.

Dopuszczalne wartości:

  • "image": wyszukiwanie niestandardowego obrazu.
siteSearchFilter

enum (SiteSearchFilter)

Określa, czy mają być uwzględniane czy wykluczane wyniki z witryny wymienionej w parametrze siteSearch.

Dopuszczalne wartości:

  • "e": wyklucz

  • "i": uwzględnij

sort

string

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

integer (uint32 format)

Indeks pierwszego wyniku do zwrócenia. Domyślna liczba wyników na stronę to 10, więc &start=11 wyświetla się na górze drugiej strony wyników. Uwaga: interfejs JSON API nigdy nie zwróci więcej niż 100 wyników, nawet jeśli do zapytania pasuje ponad 100 dokumentów, więc ustawienie sumy start + num na liczbę większą niż 100 spowoduje błąd. Pamiętaj też, że maksymalna wartość dla num wynosi 10.

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.