Method: cse.list

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Zwraca metadane dotyczące przeprowadzonego wyszukiwania, metadane o wyszukiwarce i wynikach wyszukiwania.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
c2coff

string

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:

  • 1: wyłączono

  • 0: włączono (ustawienie domyślne).

cr

string

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:

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

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

Lista prawidłowych wartości tego parametru znajdziesz na stronie Wartości parametrów kraju.

cx

string

Identyfikator wyszukiwarki niestandardowej do użycia w ramach tego żądania.

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]: prosi o wyniki z określonej liczby ostatnich tygodni.

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

  • y[number]: żąda wyników z określonej liczby minionych lat.

exactTerms

string

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

excludeTerms

string

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

fileType

string

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

string

Umożliwia włączanie i wyłączanie filtra powielonych treści.

  • Więcej informacji o filtrach wyników wyszukiwania Google znajdziesz w artykule Automatyczne filtrowanie. Pamiętaj, że filtrowanie według hostów jest stosowane tylko do wielu witryn.

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

Akceptowane wartości to:

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

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

gl

string

Geolokalizacja użytkownika.

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

  • Określenie wartości parametru gl powinno przynieść trafniejsze wyniki. Dotyczy to szczególnie klientów międzynarodowych, a w szczególności klientów z krajów anglojęzycznych innych niż Stany Zjednoczone.

googlehost

string

Wycofane. Aby zastosować podobny efekt, użyj parametru gl.

Lokalna domena Google (np. google.com, google.de lub google.fr) używana do wyszukiwania.

highRange

string

Określa wartość końcową 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.

hq

string

Dołącza do zapytania określone hasła, tak jakby były połączone operatorem logicznym ORAZ.

imgColorType

enum (ImgColorType)

Zwraca obrazy czarno-białe, w skali szarości, przezroczyste lub kolorowe. Akceptowane wartości to:

  • "color"

  • "gray"

  • "mono": czarno-biały

  • "trans": tło przezroczyste

imgDominantColor

enum (ImgDominantColor)

Zwraca obrazy o określonym kolorze dominującym. Akceptowane wartości to:

  • "black"

  • "blue"

  • "brown"

  • "gray"

  • "green"

  • "orange"

  • "pink"

  • "purple"

  • "red"

  • "teal"

  • "white"

  • "yellow"

imgSize

enum (ImgSize)

Zwraca obrazy o określonym rozmiarze. Akceptowane wartości to:

  • "huge"

  • "icon"

  • "large"

  • "medium"

  • "small"

  • "xlarge"

  • "xxlarge"

imgType

enum (ImgType)

Zwraca obrazy określonego typu. Akceptowane wartości to:

  • "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).

Akceptowane wartości to:

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

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

string

Zapytanie

relatedSite

string

Określa, że wszystkie wyniki wyszukiwania powinny być stronami powiązanymi z określonym adresem URL.

rights

string

Filtry na podstawie licencji. Obsługiwane wartości to cc_publicdomain, cc_attribute, cc_sharealike, cc_noncommercial, cc_nonderived i ich kombinacje. Zobacz typowe kombinacje.

safe

enum (Safe)

Poziom bezpieczeństwa wyszukiwania Akceptowane wartości to:

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

  • "off": wyłącza filtr SafeSearch. (domyślnie)

searchType

enum (SearchType)

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

Akceptowane wartości to:

  • "image": niestandardowe wyszukiwanie grafiki.
siteSearchFilter

enum (SiteSearchFilter)

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

Akceptowane wartości to:

  • "e": wyklucz

  • "i": uwzględnij

sort

string

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

integer (uint32 format)

Indeks pierwszego wyniku do zwrócenia. Domyślna liczba wyników na stronie wynosi 10, więc &start=11 będzie wyświetlać się na górze drugiej strony wyników. Uwaga: interfejs JSON API nigdy nie zwraca więcej niż 100 wyników, nawet jeśli więcej niż 100 dokumentów pasuje do zapytania, więc ustawienie sumy właściwości start + num na liczbę większą niż 100 spowoduje zwrócenie błędu. Pamiętaj, że maksymalna wartość w polu 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 omówieniu protokołu OAuth 2.0.