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 dla interfejsu Custom Search JSON API.

url.template

string

Rzeczywisty szablon OpenSearch dla tego interfejsu API.

queries

object

Zawiera co najmniej 1 zbiór metadanych zapytania z kluczem według nazwy roli. Możliwe nazwy ról to request zdefiniowane przez role OpenSearch i 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ładna.

queries.previousPage[].searchTerms

string

Wyszukiwane słowa wpisane 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 całkowitego zestawu wyników, gdzie indeks pierwszego wyniku wynosi 1.

queries.previousPage[].startPage

integer

Numer strony w tym zestawie 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 wynikach wyszukiwania.

queries.previousPage[].safe

string

Określa poziom filtra SafeSearch używany do filtrowania wyników dla dorosłych. Jest to właściwość niestandardowa, która nie została zdefiniowana 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 utworzonej za pomocą panelu sterowania Wyszukiwarki niestandardowej. Jest to właściwość niestandardowa, która nie została zdefiniowana 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 posortuj je według daty.

queries.previousPage[].filter

string

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

  • 0: wyłączono

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

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

queries.previousPage[].gl

string

Wzmacnia wyniki wyszukiwania, których kraj pochodzenia pasuje do 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 w szczególności klientów międzynarodowych, a zwłaszcza klientów z krajów anglojęzycznych poza Stanami Zjednoczonymi.

queries.previousPage[].cr

string

Ogranicza wyniki wyszukiwania do dokumentów pochodzących z konkretnego kraju. W wartości parametru cr możesz używać operatorów logicznych.

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

  • 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 być 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 zapytania do zapytania w taki sposób, jakby były one połączone z operatorem logicznym AND.

queries.previousPage[].hl

string

Określa język interfejsu (język hosta) Twojego interfejsu użytkownika. Ustawienie tego parametru poprawia skuteczność i jakość wyników wyszukiwania.

Więcej informacji znajdziesz w sekcji Języki interfejsu w artykule Internacjonalizowanie zapytań i prezentacji wyników, a w sekcji Obsługiwane języki 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 wyniki z witryny wymienionej w parametrze sitesearch mają być uwzględniane czy wykluczane. Obsługiwane wartości to:

  • i: uwzględnij treści z witryny

  • e: wykluczanie treści z witryny

queries.previousPage[].exactTerms

string

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

queries.previousPage[].excludeTerms

string

Wskazuje słowo lub wyrażenie, które nie powinny pojawić się 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

Umożliwia wyszukiwanie dodatkowych haseł do sprawdzenia w dokumencie. Każdy dokument w wynikach wyszukiwania musi zawierać co najmniej jedno z tych haseł. W przypadku tego typu zapytania możesz też użyć hasła Wartość logiczna LUB.

queries.previousPage[].relatedSite

string

Określa, że wszystkie wyniki wyszukiwania powinny być stronami powiązanymi z podanym 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:

  • d[number]: prosi o wyniki z określonej liczby ostatnich dni.

  • w[number]: prosi o wyniki z określonej liczby ubiegłych tygodni.

  • m[number]: żądania wyników z określonej liczby ubiegłych 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 uwzględniający zakres wyszukiwania lowRange...highRange.

queries.previousPage[].highRange

string

Określa wartość końcową zakresu wyszukiwania. Użyj funkcji cse:lowRange i cse:highrange, aby dołączyć do zapytania uwzględniający zakres wyszukiwania 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)

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

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Plik programu Microsoft Excel (xls)

  • Plik programu Microsoft PowerPoint (ppt)

  • Plik programu Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Format tekstu sformatowanego (rtf)

  • Lampa błyskowa fala (swf)

  • Tekst (ans, txt).

W przyszłości możemy dodać więcej typów plików. Aktualną listę znajdziesz w odpowiedziach na najczęstsze pytania dotyczące typów plików w Google.

queries.previousPage[].rights

string

Filtry na podstawie licencji. Obsługiwane wartości:

  • 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 (średni)

  • 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 (animacja)

  • stock (bankowa)

queries.previousPage[].imgColorType

string

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

  • mono (czarno-biały)

  • gray (w skali szarości)

  • color (kolor)

queries.previousPage[].imgDominantColor

string

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

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.request[]

object

Metadane reprezentują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ładna.

queries.request[].searchTerms

string

Wyszukiwane słowa wpisane 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 całkowitego zestawu wyników, gdzie indeks pierwszego wyniku wynosi 1.

queries.request[].startPage

integer

Numer strony w tym zestawie 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 wynikach wyszukiwania.

queries.request[].safe

string

Określa poziom filtra SafeSearch używany do filtrowania wyników dla dorosłych. Jest to właściwość niestandardowa, która nie została zdefiniowana 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 utworzonej za pomocą panelu sterowania Wyszukiwarki niestandardowej. Jest to właściwość niestandardowa, która nie została zdefiniowana 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 posortuj je według daty.

queries.request[].filter

string

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

  • 0: wyłączono

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

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

queries.request[].gl

string

Wzmacnia wyniki wyszukiwania, których kraj pochodzenia pasuje do 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 w szczególności klientów międzynarodowych, a zwłaszcza klientów z krajów anglojęzycznych poza Stanami Zjednoczonymi.

queries.request[].cr

string

Ogranicza wyniki wyszukiwania do dokumentów pochodzących z konkretnego kraju. W wartości parametru cr możesz używać operatorów logicznych.

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

  • 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 być 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 zapytania do zapytania w taki sposób, jakby były one połączone z operatorem logicznym AND.

queries.request[].hl

string

Określa język interfejsu (język hosta) Twojego interfejsu użytkownika. Ustawienie tego parametru poprawia skuteczność i jakość wyników wyszukiwania.

Więcej informacji znajdziesz w sekcji Języki interfejsu w artykule Internacjonalizowanie zapytań i prezentacji wyników, a w sekcji Obsługiwane języki 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 wyniki z witryny wymienionej w parametrze sitesearch mają być uwzględniane czy wykluczane. Obsługiwane wartości to:

  • i: uwzględnij treści z witryny

  • e: wykluczanie treści z witryny

queries.request[].exactTerms

string

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

queries.request[].excludeTerms

string

Wskazuje słowo lub wyrażenie, które nie powinny pojawić się 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

Umożliwia wyszukiwanie dodatkowych haseł do sprawdzenia w dokumencie. Każdy dokument w wynikach wyszukiwania musi zawierać co najmniej jedno z tych haseł. W przypadku tego typu zapytania możesz też użyć hasła Wartość logiczna LUB.

queries.request[].relatedSite

string

Określa, że wszystkie wyniki wyszukiwania powinny być stronami powiązanymi z podanym 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:

  • d[number]: prosi o wyniki z określonej liczby ostatnich dni.

  • w[number]: prosi o wyniki z określonej liczby ubiegłych tygodni.

  • m[number]: żądania wyników z określonej liczby ubiegłych 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 uwzględniający zakres wyszukiwania lowRange...highRange.

queries.request[].highRange

string

Określa wartość końcową zakresu wyszukiwania. Użyj funkcji cse:lowRange i cse:highrange, aby dołączyć do zapytania uwzględniający zakres wyszukiwania 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)

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

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Plik programu Microsoft Excel (xls)

  • Plik programu Microsoft PowerPoint (ppt)

  • Plik programu Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Format tekstu sformatowanego (rtf)

  • Lampa błyskowa fala (swf)

  • Tekst (ans, txt).

W przyszłości możemy dodać więcej typów plików. Aktualną listę znajdziesz w odpowiedziach na najczęstsze pytania dotyczące typów plików w Google.

queries.request[].rights

string

Filtry na podstawie licencji. Obsługiwane wartości:

  • 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 (średni)

  • 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 (animacja)

  • stock (bankowa)

queries.request[].imgColorType

string

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

  • mono (czarno-biały)

  • gray (w skali szarości)

  • color (kolor)

queries.request[].imgDominantColor

string

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

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.nextPage[]

object

Metadane określające następną stronę wyników (w odpowiednich przypadkach).

queries.nextPage[].title

string

Opis zapytania.

queries.nextPage[].totalResults

string (int64 format)

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

queries.nextPage[].searchTerms

string

Wyszukiwane słowa wpisane 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 całkowitego zestawu wyników, gdzie indeks pierwszego wyniku wynosi 1.

queries.nextPage[].startPage

integer

Numer strony w tym zestawie 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 wynikach wyszukiwania.

queries.nextPage[].safe

string

Określa poziom filtra SafeSearch używany do filtrowania wyników dla dorosłych. Jest to właściwość niestandardowa, która nie została zdefiniowana 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 utworzonej za pomocą panelu sterowania Wyszukiwarki niestandardowej. Jest to właściwość niestandardowa, która nie została zdefiniowana 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 posortuj je według daty.

queries.nextPage[].filter

string

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

  • 0: wyłączono

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

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

queries.nextPage[].gl

string

Wzmacnia wyniki wyszukiwania, których kraj pochodzenia pasuje do 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 w szczególności klientów międzynarodowych, a zwłaszcza klientów z krajów anglojęzycznych poza Stanami Zjednoczonymi.

queries.nextPage[].cr

string

Ogranicza wyniki wyszukiwania do dokumentów pochodzących z konkretnego kraju. W wartości parametru cr możesz używać operatorów logicznych.

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

  • 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 być 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 zapytania do zapytania w taki sposób, jakby były one połączone z operatorem logicznym AND.

queries.nextPage[].hl

string

Określa język interfejsu (język hosta) Twojego interfejsu użytkownika. Ustawienie tego parametru poprawia skuteczność i jakość wyników wyszukiwania.

Więcej informacji znajdziesz w sekcji Języki interfejsu w artykule Internacjonalizowanie zapytań i prezentacji wyników, a w sekcji Obsługiwane języki 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 wyniki z witryny wymienionej w parametrze sitesearch mają być uwzględniane czy wykluczane. Obsługiwane wartości to:

  • i: uwzględnij treści z witryny

  • e: wykluczanie treści z witryny

queries.nextPage[].exactTerms

string

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

queries.nextPage[].excludeTerms

string

Wskazuje słowo lub wyrażenie, które nie powinny pojawić się 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

Umożliwia wyszukiwanie dodatkowych haseł do sprawdzenia w dokumencie. Każdy dokument w wynikach wyszukiwania musi zawierać co najmniej jedno z tych haseł. W przypadku tego typu zapytania możesz też użyć hasła Wartość logiczna LUB.

queries.nextPage[].relatedSite

string

Określa, że wszystkie wyniki wyszukiwania powinny być stronami powiązanymi z podanym 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:

  • d[number]: prosi o wyniki z określonej liczby ostatnich dni.

  • w[number]: prosi o wyniki z określonej liczby ubiegłych tygodni.

  • m[number]: żądania wyników z określonej liczby ubiegłych 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 uwzględniający zakres wyszukiwania lowRange...highRange.

queries.nextPage[].highRange

string

Określa wartość końcową zakresu wyszukiwania. Użyj funkcji cse:lowRange i cse:highrange, aby dołączyć do zapytania uwzględniający zakres wyszukiwania 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)

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

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Plik programu Microsoft Excel (xls)

  • Plik programu Microsoft PowerPoint (ppt)

  • Plik programu Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Format tekstu sformatowanego (rtf)

  • Lampa błyskowa fala (swf)

  • Tekst (ans, txt).

W przyszłości możemy dodać więcej typów plików. Aktualną listę znajdziesz w odpowiedziach na najczęstsze pytania dotyczące typów plików w Google.

queries.nextPage[].rights

string

Filtry na podstawie licencji. Obsługiwane wartości:

  • 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 (średni)

  • 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 (animacja)

  • stock (bankowa)

queries.nextPage[].imgColorType

string

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

  • mono (czarno-biały)

  • gray (w skali szarości)

  • color (kolor)

queries.nextPage[].imgDominantColor

string

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

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

promotions[]

object (Promotion)

Zestaw promocji. Widoczna tylko wtedy, gdy pliki konfiguracji Twojej wyszukiwarki definiują jakiekolwiek promocje dla danego zapytania.

context

object (Struct format)

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

  • Nazwa wyszukiwarki użytej w zapytaniu.

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

searchInformation

object

Metadane dotyczące tego wyszukiwania, w tym czas wyszukiwania i całkowita 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 lokalnym.

searchInformation.totalResults

string

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

searchInformation.formattedTotalResults

string

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

spelling

object

Obejmuje 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

Tytuł promocji.

htmlTitle

string

Tytuł promocji w formacie HTML.

bodyLines[]

object

Tablica obiektów blokowych dla tej promocji.

bodyLines[].title

string

Tekst obiektu bloku (jeśli zawiera tekst).

bodyLines[].htmlTitle

string

W kodzie HTML znajduje się tekst obiektu bloku, jeśli zawiera on tekst.

bodyLines[].url

string

Adres URL linku do obiektu blokującego, jeśli taki 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 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 zapisany zwykłym tekstem.

htmlTitle

string

Tytuł wyniku wyszukiwania w formacie HTML.

snippet

string

Fragment wyniku wyszukiwania zapisany zwykłym tekstem.

htmlSnippet

string

Fragment wyniku wyszukiwania w formacie HTML.

cacheId

string

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

formattedUrl

string

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

htmlFormattedUrl

string

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

pagemap

object (Struct format)

Zawiera informacje PageMap dla 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 strony internetowej, 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ść miniatury obrazu w pikselach.

image.thumbnailWidth

integer

Szerokość miniatury obrazu w pikselach.

labels[]

object

Obejmuje wszystkie informacje o etykietach zawężania wyszukiwania.

labels[].name

string

Nazwa etykiety zawężającej kryteria wyszukiwania, która służy do zawężania wyników. nie wyświetlaj jej w interfejsie. użyj wartości displayName.

labels[].displayName

string

Wyświetlana nazwa etykiety zawężenia wyszukiwania. Ta nazwa powinna być widoczna w interfejsie użytkownika.

labels[].label_with_op

string

Etykieta zawężenia i powiązana z nią operacja zawężania.