Search

Özel bir arama isteğine verilen yanıt.

JSON gösterimi
{
  "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)
    }
  ]
}
Alanlar
kind

string

Mevcut nesnenin türü için benzersiz tanımlayıcı. Bu API için bu parametre customsearch#search şeklindedir.

url

object

Bu API'nin şablonunu tanımlayan OpenSearch URL öğesi.

url.type

string

Custom Search JSON API için OpenSearch URL şablonunun MIME türü.

url.template

string

Bu API'nin gerçek OpenSearch şablonu.

queries

object

Rol adına göre belirlenen bir veya daha fazla sorgu meta verisi grubu içerir. Olası rol adları arasında, OpenSearch sorgu rolleri tarafından tanımlanan request ve iki özel rol bulunur: nextPage ve previousPage.

queries.previousPage[]

object

Varsa önceki sonuç sayfasını temsil eden meta veriler.

queries.previousPage[].title

string

Sorgunun açıklaması.

queries.previousPage[].totalResults

string (int64 format)

Toplam arama sonuçlarının tahmini sayısı. Doğru olmayabilir.

queries.previousPage[].searchTerms

string

Kullanıcı tarafından girilen arama terimleri.

queries.previousPage[].count

integer

Bu kümede döndürülen arama sonuçlarının sayısı.

queries.previousPage[].startIndex

integer

Geçerli arama sonuçları kümesinin dizini, toplam sonuç kümesine eklenir. Burada, ilk sonucun dizini 1'dir.

queries.previousPage[].startPage

integer

Bu sonuç grubunun sayfa numarası. Burada sayfa uzunluğu count özelliği tarafından belirlenir.

queries.previousPage[].language

string

Arama sonuçlarının dili.

queries.previousPage[].inputEncoding

string

Arama istekleri için desteklenen karakter kodlaması.

queries.previousPage[].outputEncoding

string

Arama sonuçları için desteklenen karakter kodlaması.

queries.previousPage[].safe

string

Yetişkinlere uygun sonuçları filtrelemek için kullanılan Güvenli Arama düzeyini belirtir. Bu, OpenSearch spesifikasyonunda tanımlanmayan özel bir özelliktir. Geçerli parametre değerleri şunlardır:

  • "off": Güvenli Arama'yı devre dışı bırak

  • "active": Güvenli Arama'yı etkinleştir

queries.previousPage[].cx

string

Programlanabilir Arama Motoru Denetim Masası kullanılarak oluşturulan bir motorun tanımlayıcısı. Bu, OpenSearch spesifikasyonunda tanımlanmamış özel bir özelliktir. Bu parametre zorunludur.

queries.previousPage[].sort

string

Sonuçların belirtilen ifadeye göre sıralanması gerektiğini belirtir. Örneğin, tarihe göre sıralayın.

queries.previousPage[].filter

string

Google arama sonuçlarının otomatik olarak filtrelenmesini etkinleştirir veya devre dışı bırakır. Google'ın arama sonucu filtreleri hakkında daha fazla bilgi için Otomatik Filtreleme bölümüne bakın. Bu parametre için geçerli değerler şunlardır:

  • 0: Devre dışı

  • 1: Etkin (varsayılan)

Not: Google varsayılan olarak, kalitesini iyileştirmek için tüm arama sonuçlarına filtreleme uygular.

queries.previousPage[].gl

string

Menşe ülkesi parametre değeri ile eşleşen arama sonuçlarını geliştirir. Geçerli değerlerin listesi için Ülke Kodları bölümüne bakın.

WebSearch isteklerinde gl parametresi değeri belirtilmesi, sonuçların alaka düzeyini artırır. Bu durum özellikle uluslararası müşteriler, hatta ABD dışında İngilizce konuşulan ülkelerdeki müşteriler için geçerlidir.

queries.previousPage[].cr

string

Arama sonuçlarını, belirli bir ülkeden gelen dokümanlarla kısıtlar. cr parametresi değerinde Boole operatörleri kullanabilirsiniz.

Google WebSearch, bir dokümanın ülkesini belirlemek için şu unsurları analiz eder:

  • Doküman URL'sinin üst düzey alanı (TLD).

  • Web sunucusunun IP adresinin coğrafi konumu.

Bu parametrenin geçerli değerlerinin listesi için Ülke (cr) Parametre Değerleri bölümüne bakın.

queries.previousPage[].googleHost

string

Aramanın sınırlandırılması gereken Google alanını (ör. google.com, google.de veya google.fr) belirtir.

queries.previousPage[].disableCnTwTranslation

string

Basitleştirilmiş ve Geleneksel Çince Arama özelliğini etkinleştirir veya devre dışı bırakır.

Desteklenen değerler:

  • 0: etkin (varsayılan)

  • 1: devre dışı

queries.previousPage[].hq

string

Belirtilen sorgu terimlerini, mantıksal bir AND operatörüyle birleştirilmişmiş gibi sorguya ekler.

queries.previousPage[].hl

string

Kullanıcı arayüzünüzün arayüz dilini (ana makine dilini) belirtir. Bu parametrenin açık bir şekilde ayarlanması, arama sonuçlarınızın performansını ve kalitesini iyileştirir.

Daha fazla bilgi için Sorguları ve Sonuçları Sunumu Uluslararasılaştırma'nın Arayüz Dilleri bölümüne, desteklenen dillerin listesi için ise Desteklenen Arayüz Dilleri bölümüne bakın.

queries.previousPage[].siteSearch

string

Sonuçları, belirli bir sitedeki URL'lerle kısıtlar.

queries.previousPage[].siteSearchFilter

string

sitesearch parametresinde adı verilen siteden sonuçların dahil edilip edilmeyeceğini belirtir. Desteklenen değerler:

  • i: Sitedeki içeriği dahil et

  • e: içeriği siteden hariç tutma

queries.previousPage[].exactTerms

string

Arama sonuçlarındaki tüm dokümanların içermesi gereken bir kelime öbeğini tanımlar.

queries.previousPage[].excludeTerms

string

Arama sonuçlarındaki hiçbir dokümanda görünmemesi gereken bir kelimeyi veya kelime öbeğini tanımlar.

queries.previousPage[].linkSite

string

Tüm sonuçların belirli bir URL'ye bağlantı içermesi gerektiğini belirtir.

queries.previousPage[].orTerms

string

Bir dokümanda kontrol edilecek ek arama terimleri sağlar. Burada, arama sonuçlarındaki her doküman ek arama terimlerinden en az birini içermelidir. Bu sorgu türü için Boole VEYA sorgu terimini de kullanabilirsiniz.

queries.previousPage[].relatedSite

string

Tüm arama sonuçlarının, belirtilen URL ile ilgili sayfalar olması gerektiğini belirtir. Parametre değeri bir URL olmalıdır.

queries.previousPage[].dateRestrict

string

Sonuçları tarihe dayalı URL'lerle kısıtlar. Desteklenen değerler şunlardır:

  • d[number]: Belirtilen sayıda geçmiş gün için sonuçları ister.

  • w[number]: Belirtilen sayıda geçmiş haftadan sonuçları ister.

  • m[number]: Belirtilen sayıda geçen ay için sonuçları ister.

  • y[number]: Belirtilen sayıda geçmiş yıla ait sonuçları ister.

queries.previousPage[].lowRange

string

Bir arama aralığının başlangıç değerini belirtir. Sorguya lowRange...highRange tutarında kapsayıcı arama aralığı eklemek için cse:lowRange ve cse:highrange değerlerini kullanın.

queries.previousPage[].highRange

string

Bir arama aralığının bitiş değerini belirtir. Sorguya lowRange...highRange tutarında kapsayıcı arama aralığı eklemek için cse:lowRange ve cse:highrange değerlerini kullanın.

queries.previousPage[].fileType

string

Sonuçları, belirli bir uzantıya ait dosyalarla kısıtlar. Google tarafından desteklenen dosya türleri şunlardır:

  • Adobe Taşınabilir Belge Biçimi (pdf)

  • Adobe PostScript (ps)

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

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Yazma (wri)

  • Zengin Metin Biçimi (rtf)

  • Şok Dalgası Flash (swf)

  • Metin (ans, txt).

Gelecekte başka dosya türleri de eklenebilir. Güncel bir listeyi her zaman Google'ın dosya türüyle ilgili SSS sayfasında bulabilirsiniz.

queries.previousPage[].rights

string

Lisanslamaya dayalı filtreler. Desteklenen değerler şunlardır:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.previousPage[].searchType

string

web veya image değerlerine izin verilir. Belirtilmemişse sonuçlar web sayfalarıyla sınırlıdır.

queries.previousPage[].imgSize

string

Sonuçları, belirtilen boyuttaki görsellerle kısıtlar. Desteklenen değerler:

  • icon (küçük)

  • small | medium | large | xlarge (orta)

  • xxlarge (büyük)

  • huge (çok büyük)

queries.previousPage[].imgType

string

Sonuçları, belirli bir türdeki görsellerle kısıtlar. Desteklenen değerler:

  • clipart (Küçük resim)

  • face (Yüz)

  • lineart (Çizgi çizim)

  • photo (Fotoğraf)

  • animated (Animasyonlu)

  • stock (Stok)

queries.previousPage[].imgColorType

string

Sonuçları, belirtilen renk türündeki görsellerle kısıtlar. Desteklenen değerler şunlardır:

  • mono (siyah beyaz)

  • gray (gri tonlamalı)

  • color (renk)

queries.previousPage[].imgDominantColor

string

Sonuçları, belirli bir baskın renge sahip görsellerle kısıtlar. Desteklenen değerler:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.request[]

object

Mevcut isteği temsil eden meta veriler.

queries.request[].title

string

Sorgunun açıklaması.

queries.request[].totalResults

string (int64 format)

Toplam arama sonuçlarının tahmini sayısı. Doğru olmayabilir.

queries.request[].searchTerms

string

Kullanıcı tarafından girilen arama terimleri.

queries.request[].count

integer

Bu kümede döndürülen arama sonuçlarının sayısı.

queries.request[].startIndex

integer

Geçerli arama sonuçları kümesinin dizini, toplam sonuç kümesine eklenir. Burada, ilk sonucun dizini 1'dir.

queries.request[].startPage

integer

Bu sonuç grubunun sayfa numarası. Burada sayfa uzunluğu count özelliği tarafından belirlenir.

queries.request[].language

string

Arama sonuçlarının dili.

queries.request[].inputEncoding

string

Arama istekleri için desteklenen karakter kodlaması.

queries.request[].outputEncoding

string

Arama sonuçları için desteklenen karakter kodlaması.

queries.request[].safe

string

Yetişkinlere uygun sonuçları filtrelemek için kullanılan Güvenli Arama düzeyini belirtir. Bu, OpenSearch spesifikasyonunda tanımlanmayan özel bir özelliktir. Geçerli parametre değerleri şunlardır:

  • "off": Güvenli Arama'yı devre dışı bırak

  • "active": Güvenli Arama'yı etkinleştir

queries.request[].cx

string

Programlanabilir Arama Motoru Denetim Masası kullanılarak oluşturulan bir motorun tanımlayıcısı. Bu, OpenSearch spesifikasyonunda tanımlanmamış özel bir özelliktir. Bu parametre zorunludur.

queries.request[].sort

string

Sonuçların belirtilen ifadeye göre sıralanması gerektiğini belirtir. Örneğin, tarihe göre sıralayın.

queries.request[].filter

string

Google arama sonuçlarının otomatik olarak filtrelenmesini etkinleştirir veya devre dışı bırakır. Google'ın arama sonucu filtreleri hakkında daha fazla bilgi için Otomatik Filtreleme bölümüne bakın. Bu parametre için geçerli değerler şunlardır:

  • 0: Devre dışı

  • 1: Etkin (varsayılan)

Not: Google varsayılan olarak, kalitesini iyileştirmek için tüm arama sonuçlarına filtreleme uygular.

queries.request[].gl

string

Menşe ülkesi parametre değeri ile eşleşen arama sonuçlarını geliştirir. Geçerli değerlerin listesi için Ülke Kodları bölümüne bakın.

WebSearch isteklerinde gl parametresi değeri belirtilmesi, sonuçların alaka düzeyini artırır. Bu durum özellikle uluslararası müşteriler, hatta ABD dışında İngilizce konuşulan ülkelerdeki müşteriler için geçerlidir.

queries.request[].cr

string

Arama sonuçlarını, belirli bir ülkeden gelen dokümanlarla kısıtlar. cr parametresi değerinde Boole operatörleri kullanabilirsiniz.

Google WebSearch, bir dokümanın ülkesini belirlemek için şu unsurları analiz eder:

  • Doküman URL'sinin üst düzey alanı (TLD).

  • Web sunucusunun IP adresinin coğrafi konumu.

Bu parametrenin geçerli değerlerinin listesi için Ülke (cr) Parametre Değerleri bölümüne bakın.

queries.request[].googleHost

string

Aramanın sınırlandırılması gereken Google alanını (ör. google.com, google.de veya google.fr) belirtir.

queries.request[].disableCnTwTranslation

string

Basitleştirilmiş ve Geleneksel Çince Arama özelliğini etkinleştirir veya devre dışı bırakır.

Desteklenen değerler:

  • 0: etkin (varsayılan)

  • 1: devre dışı

queries.request[].hq

string

Belirtilen sorgu terimlerini, mantıksal bir AND operatörüyle birleştirilmişmiş gibi sorguya ekler.

queries.request[].hl

string

Kullanıcı arayüzünüzün arayüz dilini (ana makine dilini) belirtir. Bu parametrenin açık bir şekilde ayarlanması, arama sonuçlarınızın performansını ve kalitesini iyileştirir.

Daha fazla bilgi için Sorguları ve Sonuçları Sunumu Uluslararasılaştırma'nın Arayüz Dilleri bölümüne, desteklenen dillerin listesi için ise Desteklenen Arayüz Dilleri bölümüne bakın.

queries.request[].siteSearch

string

Sonuçları, belirli bir sitedeki URL'lerle kısıtlar.

queries.request[].siteSearchFilter

string

sitesearch parametresinde adı verilen siteden sonuçların dahil edilip edilmeyeceğini belirtir. Desteklenen değerler:

  • i: Sitedeki içeriği dahil et

  • e: içeriği siteden hariç tutma

queries.request[].exactTerms

string

Arama sonuçlarındaki tüm dokümanların içermesi gereken bir kelime öbeğini tanımlar.

queries.request[].excludeTerms

string

Arama sonuçlarındaki hiçbir dokümanda görünmemesi gereken bir kelimeyi veya kelime öbeğini tanımlar.

queries.request[].linkSite

string

Tüm sonuçların belirli bir URL'ye bağlantı içermesi gerektiğini belirtir.

queries.request[].orTerms

string

Bir dokümanda kontrol edilecek ek arama terimleri sağlar. Burada, arama sonuçlarındaki her doküman ek arama terimlerinden en az birini içermelidir. Bu sorgu türü için Boole VEYA sorgu terimini de kullanabilirsiniz.

queries.request[].relatedSite

string

Tüm arama sonuçlarının, belirtilen URL ile ilgili sayfalar olması gerektiğini belirtir. Parametre değeri bir URL olmalıdır.

queries.request[].dateRestrict

string

Sonuçları tarihe dayalı URL'lerle kısıtlar. Desteklenen değerler şunlardır:

  • d[number]: Belirtilen sayıda geçmiş gün için sonuçları ister.

  • w[number]: Belirtilen sayıda geçmiş haftadan sonuçları ister.

  • m[number]: Belirtilen sayıda geçen ay için sonuçları ister.

  • y[number]: Belirtilen sayıda geçmiş yıla ait sonuçları ister.

queries.request[].lowRange

string

Bir arama aralığının başlangıç değerini belirtir. Sorguya lowRange...highRange tutarında kapsayıcı arama aralığı eklemek için cse:lowRange ve cse:highrange değerlerini kullanın.

queries.request[].highRange

string

Bir arama aralığının bitiş değerini belirtir. Sorguya lowRange...highRange tutarında kapsayıcı arama aralığı eklemek için cse:lowRange ve cse:highrange değerlerini kullanın.

queries.request[].fileType

string

Sonuçları, belirli bir uzantıya ait dosyalarla kısıtlar. Google tarafından desteklenen dosya türleri şunlardır:

  • Adobe Taşınabilir Belge Biçimi (pdf)

  • Adobe PostScript (ps)

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

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Yazma (wri)

  • Zengin Metin Biçimi (rtf)

  • Şok Dalgası Flash (swf)

  • Metin (ans, txt).

Gelecekte başka dosya türleri de eklenebilir. Güncel bir listeyi her zaman Google'ın dosya türüyle ilgili SSS sayfasında bulabilirsiniz.

queries.request[].rights

string

Lisanslamaya dayalı filtreler. Desteklenen değerler şunlardır:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.request[].searchType

string

web veya image değerlerine izin verilir. Belirtilmemişse sonuçlar web sayfalarıyla sınırlıdır.

queries.request[].imgSize

string

Sonuçları, belirtilen boyuttaki görsellerle kısıtlar. Desteklenen değerler:

  • icon (küçük)

  • small | medium | large | xlarge (orta)

  • xxlarge (büyük)

  • huge (çok büyük)

queries.request[].imgType

string

Sonuçları, belirli bir türdeki görsellerle kısıtlar. Desteklenen değerler:

  • clipart (Küçük resim)

  • face (Yüz)

  • lineart (Çizgi çizim)

  • photo (Fotoğraf)

  • animated (Animasyonlu)

  • stock (Stok)

queries.request[].imgColorType

string

Sonuçları, belirtilen renk türündeki görsellerle kısıtlar. Desteklenen değerler şunlardır:

  • mono (siyah beyaz)

  • gray (gri tonlamalı)

  • color (renk)

queries.request[].imgDominantColor

string

Sonuçları, belirli bir baskın renge sahip görsellerle kısıtlar. Desteklenen değerler:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.nextPage[]

object

Varsa sonraki sonuç sayfasını temsil eden meta veriler.

queries.nextPage[].title

string

Sorgunun açıklaması.

queries.nextPage[].totalResults

string (int64 format)

Toplam arama sonuçlarının tahmini sayısı. Doğru olmayabilir.

queries.nextPage[].searchTerms

string

Kullanıcı tarafından girilen arama terimleri.

queries.nextPage[].count

integer

Bu kümede döndürülen arama sonuçlarının sayısı.

queries.nextPage[].startIndex

integer

Geçerli arama sonuçları kümesinin dizini, toplam sonuç kümesine eklenir. Burada, ilk sonucun dizini 1'dir.

queries.nextPage[].startPage

integer

Bu sonuç grubunun sayfa numarası. Burada sayfa uzunluğu count özelliği tarafından belirlenir.

queries.nextPage[].language

string

Arama sonuçlarının dili.

queries.nextPage[].inputEncoding

string

Arama istekleri için desteklenen karakter kodlaması.

queries.nextPage[].outputEncoding

string

Arama sonuçları için desteklenen karakter kodlaması.

queries.nextPage[].safe

string

Yetişkinlere uygun sonuçları filtrelemek için kullanılan Güvenli Arama düzeyini belirtir. Bu, OpenSearch spesifikasyonunda tanımlanmayan özel bir özelliktir. Geçerli parametre değerleri şunlardır:

  • "off": Güvenli Arama'yı devre dışı bırak

  • "active": Güvenli Arama'yı etkinleştir

queries.nextPage[].cx

string

Programlanabilir Arama Motoru Denetim Masası kullanılarak oluşturulan bir motorun tanımlayıcısı. Bu, OpenSearch spesifikasyonunda tanımlanmamış özel bir özelliktir. Bu parametre zorunludur.

queries.nextPage[].sort

string

Sonuçların belirtilen ifadeye göre sıralanması gerektiğini belirtir. Örneğin, tarihe göre sıralayın.

queries.nextPage[].filter

string

Google arama sonuçlarının otomatik olarak filtrelenmesini etkinleştirir veya devre dışı bırakır. Google'ın arama sonucu filtreleri hakkında daha fazla bilgi için Otomatik Filtreleme bölümüne bakın. Bu parametre için geçerli değerler şunlardır:

  • 0: Devre dışı

  • 1: Etkin (varsayılan)

Not: Google varsayılan olarak, kalitesini iyileştirmek için tüm arama sonuçlarına filtreleme uygular.

queries.nextPage[].gl

string

Menşe ülkesi parametre değeri ile eşleşen arama sonuçlarını geliştirir. Geçerli değerlerin listesi için Ülke Kodları bölümüne bakın.

WebSearch isteklerinde gl parametresi değeri belirtilmesi, sonuçların alaka düzeyini artırır. Bu durum özellikle uluslararası müşteriler, hatta ABD dışında İngilizce konuşulan ülkelerdeki müşteriler için geçerlidir.

queries.nextPage[].cr

string

Arama sonuçlarını, belirli bir ülkeden gelen dokümanlarla kısıtlar. cr parametresi değerinde Boole operatörleri kullanabilirsiniz.

Google WebSearch, bir dokümanın ülkesini belirlemek için şu unsurları analiz eder:

  • Doküman URL'sinin üst düzey alanı (TLD).

  • Web sunucusunun IP adresinin coğrafi konumu.

Bu parametrenin geçerli değerlerinin listesi için Ülke (cr) Parametre Değerleri bölümüne bakın.

queries.nextPage[].googleHost

string

Aramanın sınırlandırılması gereken Google alanını (ör. google.com, google.de veya google.fr) belirtir.

queries.nextPage[].disableCnTwTranslation

string

Basitleştirilmiş ve Geleneksel Çince Arama özelliğini etkinleştirir veya devre dışı bırakır.

Desteklenen değerler:

  • 0: etkin (varsayılan)

  • 1: devre dışı

queries.nextPage[].hq

string

Belirtilen sorgu terimlerini, mantıksal bir AND operatörüyle birleştirilmişmiş gibi sorguya ekler.

queries.nextPage[].hl

string

Kullanıcı arayüzünüzün arayüz dilini (ana makine dilini) belirtir. Bu parametrenin açık bir şekilde ayarlanması, arama sonuçlarınızın performansını ve kalitesini iyileştirir.

Daha fazla bilgi için Sorguları ve Sonuçları Sunumu Uluslararasılaştırma'nın Arayüz Dilleri bölümüne, desteklenen dillerin listesi için ise Desteklenen Arayüz Dilleri bölümüne bakın.

queries.nextPage[].siteSearch

string

Sonuçları, belirli bir sitedeki URL'lerle kısıtlar.

queries.nextPage[].siteSearchFilter

string

sitesearch parametresinde adı verilen siteden sonuçların dahil edilip edilmeyeceğini belirtir. Desteklenen değerler:

  • i: Sitedeki içeriği dahil et

  • e: içeriği siteden hariç tutma

queries.nextPage[].exactTerms

string

Arama sonuçlarındaki tüm dokümanların içermesi gereken bir kelime öbeğini tanımlar.

queries.nextPage[].excludeTerms

string

Arama sonuçlarındaki hiçbir dokümanda görünmemesi gereken bir kelimeyi veya kelime öbeğini tanımlar.

queries.nextPage[].linkSite

string

Tüm sonuçların belirli bir URL'ye bağlantı içermesi gerektiğini belirtir.

queries.nextPage[].orTerms

string

Bir dokümanda kontrol edilecek ek arama terimleri sağlar. Burada, arama sonuçlarındaki her doküman ek arama terimlerinden en az birini içermelidir. Bu sorgu türü için Boole VEYA sorgu terimini de kullanabilirsiniz.

queries.nextPage[].relatedSite

string

Tüm arama sonuçlarının, belirtilen URL ile ilgili sayfalar olması gerektiğini belirtir. Parametre değeri bir URL olmalıdır.

queries.nextPage[].dateRestrict

string

Sonuçları tarihe dayalı URL'lerle kısıtlar. Desteklenen değerler şunlardır:

  • d[number]: Belirtilen sayıda geçmiş gün için sonuçları ister.

  • w[number]: Belirtilen sayıda geçmiş haftadan sonuçları ister.

  • m[number]: Belirtilen sayıda geçen ay için sonuçları ister.

  • y[number]: Belirtilen sayıda geçmiş yıla ait sonuçları ister.

queries.nextPage[].lowRange

string

Bir arama aralığının başlangıç değerini belirtir. Sorguya lowRange...highRange tutarında kapsayıcı arama aralığı eklemek için cse:lowRange ve cse:highrange değerlerini kullanın.

queries.nextPage[].highRange

string

Bir arama aralığının bitiş değerini belirtir. Sorguya lowRange...highRange tutarında kapsayıcı arama aralığı eklemek için cse:lowRange ve cse:highrange değerlerini kullanın.

queries.nextPage[].fileType

string

Sonuçları, belirli bir uzantıya ait dosyalarla kısıtlar. Google tarafından desteklenen dosya türleri şunlardır:

  • Adobe Taşınabilir Belge Biçimi (pdf)

  • Adobe PostScript (ps)

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

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Yazma (wri)

  • Zengin Metin Biçimi (rtf)

  • Şok Dalgası Flash (swf)

  • Metin (ans, txt).

Gelecekte başka dosya türleri de eklenebilir. Güncel bir listeyi her zaman Google'ın dosya türüyle ilgili SSS sayfasında bulabilirsiniz.

queries.nextPage[].rights

string

Lisanslamaya dayalı filtreler. Desteklenen değerler şunlardır:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.nextPage[].searchType

string

web veya image değerlerine izin verilir. Belirtilmemişse sonuçlar web sayfalarıyla sınırlıdır.

queries.nextPage[].imgSize

string

Sonuçları, belirtilen boyuttaki görsellerle kısıtlar. Desteklenen değerler:

  • icon (küçük)

  • small | medium | large | xlarge (orta)

  • xxlarge (büyük)

  • huge (çok büyük)

queries.nextPage[].imgType

string

Sonuçları, belirli bir türdeki görsellerle kısıtlar. Desteklenen değerler:

  • clipart (Küçük resim)

  • face (Yüz)

  • lineart (Çizgi çizim)

  • photo (Fotoğraf)

  • animated (Animasyonlu)

  • stock (Stok)

queries.nextPage[].imgColorType

string

Sonuçları, belirtilen renk türündeki görsellerle kısıtlar. Desteklenen değerler şunlardır:

  • mono (siyah beyaz)

  • gray (gri tonlamalı)

  • color (renk)

queries.nextPage[].imgDominantColor

string

Sonuçları, belirli bir baskın renge sahip görsellerle kısıtlar. Desteklenen değerler:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

promotions[]

object (Promotion)

Promosyon grubu. Yalnızca, özel arama motorunun yapılandırma dosyaları belirtilen sorgu için herhangi bir sıra yükseltmeyi tanımlarsa sunulur.

context

object (Struct format)

Belirli bir arama motoruyla ilişkili meta veriler ve ayrıntılandırmalar:

  • Sorgu için kullanılan arama motorunun adı.

  • Bir aramayı hassaslaştırmak için kullanabileceğiniz bir özellik nesnesi (hassaslaştırma) kümesi.

searchInformation

object

Arama süresi ve toplam sonuçlar da dahil bu aramayla ilgili meta veriler.

searchInformation.searchTime

number

Sunucunun arama sonuçlarını döndürmesi için geçen süre.

searchInformation.formattedSearchTime

string

Sunucunun, yerel ayar stiline göre biçimlendirilmiş arama sonuçlarını döndürmesi için geçen süre.

searchInformation.totalResults

string

Sorgu tarafından döndürülen arama sonuçlarının toplam sayısı.

searchInformation.formattedTotalResults

string

Yerel ayar stiline göre biçimlendirilmiş toplam arama sonucu sayısı.

spelling

object

Düzeltilmiş bir sorguyu içerir.

spelling.correctedQuery

string

Düzeltilen sorgu.

spelling.htmlCorrectedQuery

string

HTML olarak biçimlendirilmiş, düzeltilmiş sorgu.

items[]

object (Result)

Geçerli özel arama sonuçları grubu.

Tanıtım

Promosyon sonucu.

JSON gösterimi
{
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "bodyLines": [
    {
      "title": string,
      "htmlTitle": string,
      "url": string,
      "link": string
    }
  ],
  "image": {
    "source": string,
    "width": integer,
    "height": integer
  }
}
Alanlar
title

string

Promosyonun başlığı.

htmlTitle

string

Promosyonun HTML'deki başlığı.

bodyLines[]

object

Bu promosyon için bir dizi blok nesne.

bodyLines[].title

string

Metin varsa blok nesnenin metni.

bodyLines[].htmlTitle

string

Metin varsa blok nesnenin HTML'deki metni.

bodyLines[].url

string

Varsa, engelleme nesnesine ait bağlantının URL'si.

bodyLines[].link

string

Bağlantı varsa, blok nesnesinin bağlantısının bağlantı metni.

image

object

Promosyonla ilişkilendirilmiş resim (varsa).

image.source

string

Bu promosyon bağlantısı resminin URL'si.

image.width

integer

Piksel cinsinden resim genişliği.

image.height

integer

Piksel cinsinden resim yüksekliği.

Sonuç

Özel arama sonucu.

JSON gösterimi
{
  "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
    }
  ]
}
Alanlar
kind

string

Mevcut nesnenin türü için benzersiz bir tanımlayıcı. Bu API için bu değer customsearch#result.

title

string

Arama sonucunun düz metin halinde başlığı.

htmlTitle

string

Arama sonucunun HTML'deki başlığı.

snippet

string

Arama sonucunun düz metin biçiminde snippet'i.

htmlSnippet

string

Arama sonucunun HTML'deki snippet'i.

cacheId

string

Arama sonucunun Google tarafından önbelleğe alınan sürümünün kimliğini belirtir.

formattedUrl

string

Her arama sonucu için snippet'ten sonra görüntülenen URL.

htmlFormattedUrl

string

Her arama sonucu için snippet'ten sonra görüntülenen HTML biçimli URL.

pagemap

object (Struct format)

Bu arama sonucuyla ilgili PageMap bilgilerini içerir.

mime

string

Arama sonucunun MIME türü.

fileFormat

string

Arama sonucunun dosya biçimi.

image

object

Arama sonuçlarında döndürülen bir görselle ilgili tüm bilgileri içerir.

image.contextLink

string

Görseli barındıran web sayfasını işaret eden bir URL.

image.height

integer

Resmin piksel cinsinden yüksekliği.

image.width

integer

Resmin piksel cinsinden genişliği.

image.byteSize

integer

Resmin bayt cinsinden boyutu.

image.thumbnailLink

string

Küçük resmin URL'si.

image.thumbnailHeight

integer

Küçük resmin piksel cinsinden yüksekliği.

image.thumbnailWidth

integer

Küçük resmin piksel cinsinden genişliği.

labels[]

object

Ayrıntılandırma etiketleriyle ilgili tüm bilgileri içerir.

labels[].name

string

Aramaları hassaslaştırmak için kullanabileceğiniz ayrıntılandırma etiketinin adı. Bunu kullanıcı arayüzünüzde göstermeyin; bunun yerine displayName kullanın.

labels[].displayName

string

Ayrıntılandırma etiketinin görünen adı. Bu, kullanıcı arayüzünüzde görüntülemeniz gereken addır.

labels[].label_with_op

string

Ayrıntılandırma etiketi ve ilişkili ayrıntılandırma işlemi.