Zwraca metadane dotyczące przeprowadzonego wyszukiwania, metadane o wyszukiwarce i wynikach wyszukiwania. Wykorzystuje niewielki zestaw 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 |
Włącza lub wyłącza chińskie i tradycyjne wyszukiwanie. 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 konkretnego kraju. W wartości parametru cr możesz zastosować operatory logiczne. Wyszukiwarka Google określa kraj dokumentu na podstawie analizy:
Lista prawidłowych wartości tego parametru znajdziesz na stronie Wartości parametrów kraju. |
cx |
Identyfikator wyszukiwarki niestandardowej do użycia w ramach tego żądania. |
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 musi zawierać wszystkie dokumenty w wynikach wyszukiwania. |
excludeTerms |
Identyfikuje słowo lub wyrażenie, które nie powinno być obecne w żadnym dokumencie w wynikach wyszukiwania. |
fileType |
Ogranicza wyniki do plików o określonym rozszerzeniu. Listę typów plików, które Google może indeksować, znajdziesz w Centrum pomocy Search Console. |
filter |
Umożliwia włączanie i wyłączanie filtra powielonych treści.
Akceptowane wartości to:
|
gl |
Geolokalizacja użytkownika.
|
googlehost |
Wycofane. Aby zastosować podobny efekt, użyj parametru Lokalna domena Google (np. google.com, google.de lub google.fr) używana do wyszukiwania. |
highRange |
Określa wartość końcową zakresu wyszukiwania.
|
hl |
Ustawia język interfejsu.
|
hq |
Dołącza do zapytania określone hasła, tak jakby były połączone operatorem logicznym ORAZ. |
imgColorType |
Zwraca obrazy czarno-białe, w skali szarości, przezroczyste lub kolorowe. Akceptowane wartości to:
|
imgDominantColor |
Zwraca obrazy o określonym kolorze dominującym. Akceptowane wartości to:
|
imgSize |
Zwraca obrazy o określonym rozmiarze. Akceptowane wartości to:
|
imgType |
Zwraca obrazy określonego typu. Akceptowane wartości to:
|
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. Akceptowane wartości to:
|
num |
Liczba wyników wyszukiwania do zwrócenia.
|
orTerms |
Udostępnia dodatkowe wyszukiwane hasła do sprawdzenia w dokumencie, gdzie każdy dokument w wynikach wyszukiwania musi zawierać co najmniej jedno z tych haseł. |
q |
Zapytanie |
relatedSite |
Określa, że wszystkie wyniki wyszukiwania powinny być stronami powiązanymi z określonym adresem URL. |
rights |
Filtry na podstawie licencji. Obsługiwane wartości to |
safe |
Poziom bezpieczeństwa wyszukiwania Akceptowane wartości to:
|
searchType |
Określa typ wyszukiwania: Akceptowane wartości to:
|
siteSearch |
Określa witrynę, która powinna zawsze być uwzględniana w wynikach lub z niej wykluczana (patrz parametr |
siteSearchFilter |
Określa, czy wyniki z witryny o parametrze Akceptowane wartości to:
|
sort |
Wyrażenie sortowania, które chcesz zastosować do wyników. Parametr sortowania określa, że wyniki są sortowane według określonego wyrażenia, tj. sortowania według daty. Przykład: sort=date. |
start |
Indeks pierwszego wyniku do zwrócenia. Domyślna liczba wyników na stronie wynosi 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 omówieniu protokołu OAuth 2.0.