Search

Odpowiedź na niestandardowe żądanie wyszukiwania.

Zapis JSON
{
  "kind": string,
  "url": {
    "type": string,
    "template": string
  },
  "queries": {
    "previousPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "request": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "nextPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ]
  },
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "context": {
    object
  },
  "searchInformation": {
    "searchTime": number,
    "formattedSearchTime": string,
    "totalResults": string,
    "formattedTotalResults": string
  },
  "spelling": {
    "correctedQuery": string,
    "htmlCorrectedQuery": string
  },
  "items": [
    {
      object (Result)
    }
  ]
}
Pola
kind

string

Unikalny identyfikator typu bieżącego obiektu. W przypadku tego interfejsu API jest to customsearch#search.

url

object

Element adresu URL OpenSearch, który definiuje szablon dla tego interfejsu API.

url.type

string

Typ MIME szablonu adresu URL OpenSearch na potrzeby interfejsu Custom Search JSON API.

url.template

string

Rzeczywisty szablon OpenSearch dla tego interfejsu API.

queries

object

Zawiera co najmniej 1 zestaw metadanych zapytania posortowany według nazwy roli. Możliwe nazwy ról to request zdefiniowane przez role zapytania w OpenSearch oraz 2 role niestandardowe: nextPage i previousPage.

queries.previousPage[]

object

Metadane reprezentujące poprzednią stronę wyników (w stosownych przypadkach).

queries.previousPage[].title

string

Opis zapytania.

queries.previousPage[].totalResults

string (int64 format)

Szacunkowa liczba wszystkich wyników wyszukiwania. Może nie być dokładny.

queries.previousPage[].searchTerms

string

Wyszukiwane hasła wprowadzone przez użytkownika.

queries.previousPage[].count

integer

Liczba wyników wyszukiwania zwróconych w tym zestawie.

queries.previousPage[].startIndex

integer

Indeks bieżącego zestawu wyników wyszukiwania do łącznego zbioru wyników, przy czym indeks pierwszego wyniku wynosi 1.

queries.previousPage[].startPage

integer

Numer strony z tego zbioru wyników, gdzie długość strony jest ustawiana przez właściwość count.

queries.previousPage[].language

string

Język wyników wyszukiwania.

queries.previousPage[].inputEncoding

string

Kodowanie znaków obsługiwane w przypadku żądań wyszukiwania.

queries.previousPage[].outputEncoding

string

Kodowanie znaków obsługiwane w przypadku wyników wyszukiwania.

queries.previousPage[].safe

string

Określa poziom filtra SafeSearch używany do filtrowania wyników dla dorosłych. To jest właściwość niestandardowa niezdefiniowana w specyfikacji OpenSearch. Prawidłowe wartości parametrów to:

  • "off": wyłącz filtr SafeSearch

  • "active": włącz filtr SafeSearch

queries.previousPage[].cx

string

Identyfikator wyszukiwarki utworzony w Panelu sterowania Wyszukiwarki niestandardowej. To jest właściwość niestandardowa niezdefiniowana w specyfikacji OpenSearch. Ten parametr jest wymagany.

queries.previousPage[].sort

string

Określa, że wyniki mają być sortowane zgodnie z określonym wyrażeniem. na przykład według daty.

queries.previousPage[].filter

string

Aktywuje lub wyłącza automatyczne filtrowanie wyników wyszukiwania Google. Więcej informacji o filtrach wyników wyszukiwania Google znajdziesz w sekcji Automatyczne filtrowanie. Prawidłowe wartości tego parametru to:

  • 0: wyłączono

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

Uwaga: domyślnie Google stosuje filtrowanie do wszystkich wyników wyszukiwania, aby poprawić ich jakość.

queries.previousPage[].gl

string

Wzbogaca wyniki wyszukiwania, których kraj pochodzenia jest zgodny z wartością parametru. Listę prawidłowych wartości znajdziesz w sekcji Kody krajów.

Określenie wartości parametru gl w żądaniach WebSearch powinno zwiększyć trafność wyników. Dotyczy to zwłaszcza klientów międzynarodowych, a w szczególności klientów z krajów anglojęzycznych poza Stanami Zjednoczonymi.

queries.previousPage[].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.

Google WebSearch określa kraj dokumentu na podstawie analizy następujących danych:

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

  • Lokalizacja geograficzna adresu IP serwera WWW.

Listę prawidłowych wartości tego parametru znajdziesz w sekcji Wartości parametru kraju (cr).

queries.previousPage[].googleHost

string

Określa domenę Google (na przykład google.com, google.de lub google.fr), do której ma zostać ograniczone wyszukiwanie.

queries.previousPage[].disableCnTwTranslation

string

Włącza lub wyłącza funkcję wyszukiwania w języku chińskim tradycyjnym i uproszczonym.

Obsługiwane wartości to:

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

  • 1: wyłączono

queries.previousPage[].hq

string

Dodaje określone hasła do zapytania, jak gdyby zostały połączone z operatorem logicznym AND.

queries.previousPage[].hl

string

Określa język interfejsu (język hosta). Wyraźne ustawienie tego parametru poprawia skuteczność i jakość wyników wyszukiwania.

Więcej informacji znajdziesz w sekcji Języki interfejsu w artykule Internacjonalizacja zapytań i wyników. Natomiast w artykule o obsługiwanych językach interfejsu znajdziesz listę obsługiwanych języków.

queries.previousPage[].siteSearch

string

Ogranicza wyniki do adresów URL z określonej witryny.

queries.previousPage[].siteSearchFilter

string

Określa, czy mają być uwzględnione, czy wykluczone wyniki z witryny wymienionej w parametrze sitesearch. Obsługiwane wartości to:

  • i: uwzględnij treści z witryny

  • e: wyklucz treści z witryny

queries.previousPage[].exactTerms

string

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

queries.previousPage[].excludeTerms

string

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

queries.previousPage[].linkSite

string

Określa, że wszystkie wyniki powinny zawierać link do określonego adresu URL.

queries.previousPage[].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ł. Do tego typu zapytania możesz też użyć hasła logicznego LUB.

queries.previousPage[].relatedSite

string

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

queries.previousPage[].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.

queries.previousPage[].lowRange

string

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

queries.previousPage[].highRange

string

Określa wartość końcową dla zakresu wyszukiwania. Użyj funkcji cse:lowRange i cse:highrange, aby dołączyć do zapytania zakres wyszukiwania obejmujący lowRange...highRange.

queries.previousPage[].fileType

string

Ogranicza wyniki do plików z określonym rozszerzeniem. Typy plików obsługiwane przez Google:

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

  • Lotos 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Lotos WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Plik programu Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft zapisu (wri)

  • Tekst sformatowany (rtf)

  • Ekspresowa fala uderzeniowa (swf)

  • Tekst (ans, txt).

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.

queries.previousPage[].rights

string

Filtry działające na podstawie licencjonowania. Obsługiwane wartości to między innymi:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.previousPage[].searchType

string

Dozwolone wartości to web lub image. Jeśli nie określono inaczej, wyniki będą ograniczone do stron internetowych.

queries.previousPage[].imgSize

string

Ogranicza wyniki do obrazów o określonym rozmiarze. Obsługiwane wartości to:

  • icon (mały)

  • small | medium | large | xlarge (średnia)

  • xxlarge (duży)

  • huge (bardzo duży)

queries.previousPage[].imgType

string

Ogranicza wyniki do obrazów określonego typu. Obsługiwane wartości to:

  • clipart (obiekt clip art)

  • face (twarz)

  • lineart (rysunek liniowy)

  • photo (zdjęcie)

  • animated (animowany)

  • stock (magazyn)

queries.previousPage[].imgColorType

string

Ogranicza wyniki do obrazów o określonym typie koloru. Obsługiwane wartości to:

  • mono (czarno-białe)

  • gray (skala szarości)

  • color (kolor)

queries.previousPage[].imgDominantColor

string

Ogranicza wyniki do obrazów z określonym dominującym kolorem. Obsługiwane wartości to:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.request[]

object

Metadane przedstawiające bieżące żądanie.

queries.request[].title

string

Opis zapytania.

queries.request[].totalResults

string (int64 format)

Szacunkowa liczba wszystkich wyników wyszukiwania. Może nie być dokładny.

queries.request[].searchTerms

string

Wyszukiwane hasła wprowadzone przez użytkownika.

queries.request[].count

integer

Liczba wyników wyszukiwania zwróconych w tym zestawie.

queries.request[].startIndex

integer

Indeks bieżącego zestawu wyników wyszukiwania do łącznego zbioru wyników, przy czym indeks pierwszego wyniku wynosi 1.

queries.request[].startPage

integer

Numer strony z tego zbioru wyników, gdzie długość strony jest ustawiana przez właściwość count.

queries.request[].language

string

Język wyników wyszukiwania.

queries.request[].inputEncoding

string

Kodowanie znaków obsługiwane w przypadku żądań wyszukiwania.

queries.request[].outputEncoding

string

Kodowanie znaków obsługiwane w przypadku wyników wyszukiwania.

queries.request[].safe

string

Określa poziom filtra SafeSearch używany do filtrowania wyników dla dorosłych. To jest właściwość niestandardowa niezdefiniowana w specyfikacji OpenSearch. Prawidłowe wartości parametrów to:

  • "off": wyłącz filtr SafeSearch

  • "active": włącz filtr SafeSearch

queries.request[].cx

string

Identyfikator wyszukiwarki utworzony w Panelu sterowania Wyszukiwarki niestandardowej. To jest właściwość niestandardowa niezdefiniowana w specyfikacji OpenSearch. Ten parametr jest wymagany.

queries.request[].sort

string

Określa, że wyniki mają być sortowane zgodnie z określonym wyrażeniem. na przykład według daty.

queries.request[].filter

string

Aktywuje lub wyłącza automatyczne filtrowanie wyników wyszukiwania Google. Więcej informacji o filtrach wyników wyszukiwania Google znajdziesz w sekcji Automatyczne filtrowanie. Prawidłowe wartości tego parametru to:

  • 0: wyłączono

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

Uwaga: domyślnie Google stosuje filtrowanie do wszystkich wyników wyszukiwania, aby poprawić ich jakość.

queries.request[].gl

string

Wzbogaca wyniki wyszukiwania, których kraj pochodzenia jest zgodny z wartością parametru. Listę prawidłowych wartości znajdziesz w sekcji Kody krajów.

Określenie wartości parametru gl w żądaniach WebSearch powinno zwiększyć trafność wyników. Dotyczy to zwłaszcza klientów międzynarodowych, a w szczególności klientów z krajów anglojęzycznych poza Stanami Zjednoczonymi.

queries.request[].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.

Google WebSearch określa kraj dokumentu na podstawie analizy następujących danych:

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

  • Lokalizacja geograficzna adresu IP serwera WWW.

Listę prawidłowych wartości tego parametru znajdziesz w sekcji Wartości parametru kraju (cr).

queries.request[].googleHost

string

Określa domenę Google (na przykład google.com, google.de lub google.fr), do której ma zostać ograniczone wyszukiwanie.

queries.request[].disableCnTwTranslation

string

Włącza lub wyłącza funkcję wyszukiwania w języku chińskim tradycyjnym i uproszczonym.

Obsługiwane wartości to:

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

  • 1: wyłączono

queries.request[].hq

string

Dodaje określone hasła do zapytania, jak gdyby zostały połączone z operatorem logicznym AND.

queries.request[].hl

string

Określa język interfejsu (język hosta). Wyraźne ustawienie tego parametru poprawia skuteczność i jakość wyników wyszukiwania.

Więcej informacji znajdziesz w sekcji Języki interfejsu w artykule Internacjonalizacja zapytań i wyników. Natomiast w artykule o obsługiwanych językach interfejsu znajdziesz listę obsługiwanych języków.

queries.request[].siteSearch

string

Ogranicza wyniki do adresów URL z określonej witryny.

queries.request[].siteSearchFilter

string

Określa, czy mają być uwzględnione, czy wykluczone wyniki z witryny wymienionej w parametrze sitesearch. Obsługiwane wartości to:

  • i: uwzględnij treści z witryny

  • e: wyklucz treści z witryny

queries.request[].exactTerms

string

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

queries.request[].excludeTerms

string

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

queries.request[].linkSite

string

Określa, że wszystkie wyniki powinny zawierać link do określonego adresu URL.

queries.request[].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ł. Do tego typu zapytania możesz też użyć hasła logicznego LUB.

queries.request[].relatedSite

string

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

queries.request[].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.

queries.request[].lowRange

string

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

queries.request[].highRange

string

Określa wartość końcową dla zakresu wyszukiwania. Użyj funkcji cse:lowRange i cse:highrange, aby dołączyć do zapytania zakres wyszukiwania obejmujący lowRange...highRange.

queries.request[].fileType

string

Ogranicza wyniki do plików z określonym rozszerzeniem. Typy plików obsługiwane przez Google:

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

  • Lotos 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Lotos WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Plik programu Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft zapisu (wri)

  • Tekst sformatowany (rtf)

  • Ekspresowa fala uderzeniowa (swf)

  • Tekst (ans, txt).

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.

queries.request[].rights

string

Filtry działające na podstawie licencjonowania. Obsługiwane wartości to między innymi:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.request[].searchType

string

Dozwolone wartości to web lub image. Jeśli nie określono inaczej, wyniki będą ograniczone do stron internetowych.

queries.request[].imgSize

string

Ogranicza wyniki do obrazów o określonym rozmiarze. Obsługiwane wartości to:

  • icon (mały)

  • small | medium | large | xlarge (średnia)

  • xxlarge (duży)

  • huge (bardzo duży)

queries.request[].imgType

string

Ogranicza wyniki do obrazów określonego typu. Obsługiwane wartości to:

  • clipart (obiekt clip art)

  • face (twarz)

  • lineart (rysunek liniowy)

  • photo (zdjęcie)

  • animated (animowany)

  • stock (magazyn)

queries.request[].imgColorType

string

Ogranicza wyniki do obrazów o określonym typie koloru. Obsługiwane wartości to:

  • mono (czarno-białe)

  • gray (skala szarości)

  • color (kolor)

queries.request[].imgDominantColor

string

Ogranicza wyniki do obrazów z określonym dominującym kolorem. Obsługiwane wartości to:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.nextPage[]

object

Metadane przedstawiające następną stronę wyników (w stosownych przypadkach).

queries.nextPage[].title

string

Opis zapytania.

queries.nextPage[].totalResults

string (int64 format)

Szacunkowa liczba wszystkich wyników wyszukiwania. Może nie być dokładny.

queries.nextPage[].searchTerms

string

Wyszukiwane hasła wprowadzone przez użytkownika.

queries.nextPage[].count

integer

Liczba wyników wyszukiwania zwróconych w tym zestawie.

queries.nextPage[].startIndex

integer

Indeks bieżącego zestawu wyników wyszukiwania do łącznego zbioru wyników, przy czym indeks pierwszego wyniku wynosi 1.

queries.nextPage[].startPage

integer

Numer strony z tego zbioru wyników, gdzie długość strony jest ustawiana przez właściwość count.

queries.nextPage[].language

string

Język wyników wyszukiwania.

queries.nextPage[].inputEncoding

string

Kodowanie znaków obsługiwane w przypadku żądań wyszukiwania.

queries.nextPage[].outputEncoding

string

Kodowanie znaków obsługiwane w przypadku wyników wyszukiwania.

queries.nextPage[].safe

string

Określa poziom filtra SafeSearch używany do filtrowania wyników dla dorosłych. To jest właściwość niestandardowa niezdefiniowana w specyfikacji OpenSearch. Prawidłowe wartości parametrów to:

  • "off": wyłącz filtr SafeSearch

  • "active": włącz filtr SafeSearch

queries.nextPage[].cx

string

Identyfikator wyszukiwarki utworzony w Panelu sterowania Wyszukiwarki niestandardowej. To jest właściwość niestandardowa niezdefiniowana w specyfikacji OpenSearch. Ten parametr jest wymagany.

queries.nextPage[].sort

string

Określa, że wyniki mają być sortowane zgodnie z określonym wyrażeniem. na przykład według daty.

queries.nextPage[].filter

string

Aktywuje lub wyłącza automatyczne filtrowanie wyników wyszukiwania Google. Więcej informacji o filtrach wyników wyszukiwania Google znajdziesz w sekcji Automatyczne filtrowanie. Prawidłowe wartości tego parametru to:

  • 0: wyłączono

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

Uwaga: domyślnie Google stosuje filtrowanie do wszystkich wyników wyszukiwania, aby poprawić ich jakość.

queries.nextPage[].gl

string

Wzbogaca wyniki wyszukiwania, których kraj pochodzenia jest zgodny z wartością parametru. Listę prawidłowych wartości znajdziesz w sekcji Kody krajów.

Określenie wartości parametru gl w żądaniach WebSearch powinno zwiększyć trafność wyników. Dotyczy to zwłaszcza klientów międzynarodowych, a w szczególności klientów z krajów anglojęzycznych poza Stanami Zjednoczonymi.

queries.nextPage[].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.

Google WebSearch określa kraj dokumentu na podstawie analizy następujących danych:

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

  • Lokalizacja geograficzna adresu IP serwera WWW.

Listę prawidłowych wartości tego parametru znajdziesz w sekcji Wartości parametru kraju (cr).

queries.nextPage[].googleHost

string

Określa domenę Google (na przykład google.com, google.de lub google.fr), do której ma zostać ograniczone wyszukiwanie.

queries.nextPage[].disableCnTwTranslation

string

Włącza lub wyłącza funkcję wyszukiwania w języku chińskim tradycyjnym i uproszczonym.

Obsługiwane wartości to:

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

  • 1: wyłączono

queries.nextPage[].hq

string

Dodaje określone hasła do zapytania, jak gdyby zostały połączone z operatorem logicznym AND.

queries.nextPage[].hl

string

Określa język interfejsu (język hosta). Wyraźne ustawienie tego parametru poprawia skuteczność i jakość wyników wyszukiwania.

Więcej informacji znajdziesz w sekcji Języki interfejsu w artykule Internacjonalizacja zapytań i wyników. Natomiast w artykule o obsługiwanych językach interfejsu znajdziesz listę obsługiwanych języków.

queries.nextPage[].siteSearch

string

Ogranicza wyniki do adresów URL z określonej witryny.

queries.nextPage[].siteSearchFilter

string

Określa, czy mają być uwzględnione, czy wykluczone wyniki z witryny wymienionej w parametrze sitesearch. Obsługiwane wartości to:

  • i: uwzględnij treści z witryny

  • e: wyklucz treści z witryny

queries.nextPage[].exactTerms

string

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

queries.nextPage[].excludeTerms

string

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

queries.nextPage[].linkSite

string

Określa, że wszystkie wyniki powinny zawierać link do określonego adresu URL.

queries.nextPage[].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ł. Do tego typu zapytania możesz też użyć hasła logicznego LUB.

queries.nextPage[].relatedSite

string

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

queries.nextPage[].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.

queries.nextPage[].lowRange

string

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

queries.nextPage[].highRange

string

Określa wartość końcową dla zakresu wyszukiwania. Użyj funkcji cse:lowRange i cse:highrange, aby dołączyć do zapytania zakres wyszukiwania obejmujący lowRange...highRange.

queries.nextPage[].fileType

string

Ogranicza wyniki do plików z określonym rozszerzeniem. Typy plików obsługiwane przez Google:

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

  • Lotos 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Lotos WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Plik programu Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft zapisu (wri)

  • Tekst sformatowany (rtf)

  • Ekspresowa fala uderzeniowa (swf)

  • Tekst (ans, txt).

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.

queries.nextPage[].rights

string

Filtry działające na podstawie licencjonowania. Obsługiwane wartości to między innymi:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.nextPage[].searchType

string

Dozwolone wartości to web lub image. Jeśli nie określono inaczej, wyniki będą ograniczone do stron internetowych.

queries.nextPage[].imgSize

string

Ogranicza wyniki do obrazów o określonym rozmiarze. Obsługiwane wartości to:

  • icon (mały)

  • small | medium | large | xlarge (średnia)

  • xxlarge (duży)

  • huge (bardzo duży)

queries.nextPage[].imgType

string

Ogranicza wyniki do obrazów określonego typu. Obsługiwane wartości to:

  • clipart (obiekt clip art)

  • face (twarz)

  • lineart (rysunek liniowy)

  • photo (zdjęcie)

  • animated (animowany)

  • stock (magazyn)

queries.nextPage[].imgColorType

string

Ogranicza wyniki do obrazów o określonym typie koloru. Obsługiwane wartości to:

  • mono (czarno-białe)

  • gray (skala szarości)

  • color (kolor)

queries.nextPage[].imgDominantColor

string

Ogranicza wyniki do obrazów z określonym dominującym kolorem. Obsługiwane wartości to:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

promotions[]

object (Promotion)

Zestaw promocji. Występuje tylko wtedy, gdy pliki konfiguracji wyszukiwarki niestandardowej definiują jakiekolwiek promocje dla danego zapytania.

context

object (Struct format)

Metadane i zawężenia powiązane z daną wyszukiwarką, w tym:

  • Nazwa wyszukiwarki użytej do wyszukania zapytania.

  • Zestaw obiektów aspektów (doprecyzowań), których można użyć do zawężenia wyszukiwania.

searchInformation

object

Metadane o tym wyszukiwaniu, w tym czas wyszukiwania i łączna liczba wyników.

searchInformation.searchTime

number

Czas potrzebny na zwrócenie wyników wyszukiwania przez serwer.

searchInformation.formattedSearchTime

string

Czas potrzebny na zwrócenie wyników wyszukiwania przez serwer, sformatowany zgodnie ze stylem języka.

searchInformation.totalResults

string

Łączna liczba wyników wyszukiwania zwróconych przez zapytanie.

searchInformation.formattedTotalResults

string

Łączna liczba wyników wyszukiwania sformatowana zgodnie ze stylem języka.

spelling

object

Zawiera poprawione zapytanie.

spelling.correctedQuery

string

Poprawione zapytanie.

spelling.htmlCorrectedQuery

string

Poprawione zapytanie w formacie HTML.

items[]

object (Result)

Bieżący zestaw niestandardowych wyników wyszukiwania.

Promocja

Wynik promocji.

Zapis JSON
{
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "bodyLines": [
    {
      "title": string,
      "htmlTitle": string,
      "url": string,
      "link": string
    }
  ],
  "image": {
    "source": string,
    "width": integer,
    "height": integer
  }
}
Pola
title

string

Nazwa promocji.

htmlTitle

string

Tytuł promocji w kodzie HTML.

bodyLines[]

object

Tablica obiektów blokowych w tej promocji.

bodyLines[].title

string

Tekst obiektu bloku, jeśli zawiera tekst.

bodyLines[].htmlTitle

string

Tekst obiektu bloku w kodzie HTML, jeśli zawiera tekst.

bodyLines[].url

string

Adres URL linku obiektu bloku (jeśli istnieje).

bodyLines[].link

string

Tekst kotwicy linku obiektu bloku, jeśli zawiera link.

image

object

Obraz powiązany z tą promocją, jeśli istnieje.

image.source

string

Adres URL obrazu tego linku promocyjnego.

image.width

integer

Szerokość obrazu w pikselach.

image.height

integer

Wysokość obrazu w pikselach.

Wynik

Niestandardowy wynik wyszukiwania.

Zapis JSON
{
  "kind": string,
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "snippet": string,
  "htmlSnippet": string,
  "cacheId": string,
  "formattedUrl": string,
  "htmlFormattedUrl": string,
  "pagemap": {
    object
  },
  "mime": string,
  "fileFormat": string,
  "image": {
    "contextLink": string,
    "height": integer,
    "width": integer,
    "byteSize": integer,
    "thumbnailLink": string,
    "thumbnailHeight": integer,
    "thumbnailWidth": integer
  },
  "labels": [
    {
      "name": string,
      "displayName": string,
      "label_with_op": string
    }
  ]
}
Pola
kind

string

Unikalny identyfikator typu bieżącego obiektu. W przypadku tego interfejsu API jest to customsearch#result.

title

string

Tytuł wyniku wyszukiwania w postaci zwykłego tekstu.

htmlTitle

string

Tytuł wyniku wyszukiwania w kodzie HTML.

snippet

string

Fragment wyniku wyszukiwania w postaci zwykłego tekstu.

htmlSnippet

string

Fragment wyniku wyszukiwania w kodzie HTML.

cacheId

string

Wskazuje identyfikator wyniku wyszukiwania z pamięci podręcznej Google.

formattedUrl

string

Adres URL wyświetlany po krótkim opisie w przypadku każdego wyniku wyszukiwania.

htmlFormattedUrl

string

Adres URL w formacie HTML wyświetlany po fragmencie kodu w przypadku każdego wyniku wyszukiwania.

pagemap

object (Struct format)

Zawiera informacje PageMap dotyczące tego wyniku wyszukiwania.

mime

string

Typ MIME wyniku wyszukiwania.

fileFormat

string

Format pliku wyniku wyszukiwania.

image

object

Obejmuje wszystkie informacje o obrazie zwróconym w wynikach wyszukiwania.

image.contextLink

string

Adres URL wskazujący stronę internetową, na której znajduje się obraz.

image.height

integer

Wysokość obrazu w pikselach.

image.width

integer

Szerokość obrazu w pikselach.

image.byteSize

integer

Rozmiar obrazu w bajtach.

image.thumbnailLink

string

Adres URL obrazu miniatury.

image.thumbnailHeight

integer

Wysokość obrazu miniatury w pikselach.

image.thumbnailWidth

integer

Szerokość obrazu miniatury w pikselach.

labels[]

object

Obejmuje wszystkie informacje o etykietach zawężania wyszukiwania.

labels[].name

string

Nazwa etykiety zawężenia wyszukiwania, której można używać do zawężania wyszukiwań. Nie wyświetlaj jej w interfejsie. Zamiast tego użyj parametru displayName.

labels[].displayName

string

Wyświetlana nazwa etykiety zawężenia wyszukiwania. Ta nazwa powinna się wyświetlać w interfejsie użytkownika.

labels[].label_with_op

string

Etykieta zawężenia wyszukiwania i powiązana operacja zawężenia wyszukiwania.