Search

Özel 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 customsearch#search kullanılır.

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 için gerçek OpenSearch şablonu.

queries

object

Rol adıyla anahtarlanan bir veya daha fazla sorgu meta verisi grubu içerir. Olası rol adları, OpenSearch sorgu rolleri tarafından tanımlanan request ve iki özel rol içerir: 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ının girdiği 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 sonucu kümesinin dizini, toplam sonuç kümesine dahil edilir (burada ilk sonucun dizini 1'dir).

queries.previousPage[].startPage

integer

Sayfa uzunluğu count özelliği tarafından ayarlanan bu sonuç grubunun sayfa numarası.

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ımlanmamış özel bir özelliktir. Geçerli parametre değerleri şunlardır:

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

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

queries.previousPage[].cx

string

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

queries.previousPage[].sort

string

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

queries.previousPage[].filter

string

Google arama sonuçlarının otomatik olarak filtrelenmesini etkinleştirir veya devre dışı bırakır. Google'ın arama sonuçları filtreleri hakkında daha fazla bilgi edinmek için Otomatik Filtreleme başlıklı makaleyi inceleyin. Bu parametre için geçerli değerler şunlardır:

  • 0: Devre dışı

  • 1: Etkin (varsayılan)

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

queries.previousPage[].gl

string

Menşe ülkesi, parametre değeriyle eşleşen arama sonuçlarını artırır. Geçerli değerlerin bir listesi için Ülke Kodları'na bakın.

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

queries.previousPage[].cr

string

Arama sonuçlarını, kaynağı belirli bir ülke olan dokümanlarla kısıtlar. cr parametresinin değerinde Boole operatörleri kullanabilirsiniz.

Google WebSearch, bir dokümanın bulunduğu ülkeyi belirlemek için aşağıdakileri 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) Parametresi Değerleri bölümüne bakın.

queries.previousPage[].googleHost

string

Aramanın sınırlandırılması gereken Google alan adını (örneğin, 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ş gibi sorguya ekler.

queries.previousPage[].hl

string

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

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

queries.previousPage[].siteSearch

string

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

queries.previousPage[].siteSearchFilter

string

sitesearch parametresinde adı geçen 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ç tut

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'nin bağlantısını içermesi gerektiğini belirtir.

queries.previousPage[].orTerms

string

Dokümanda kontrol edilecek ek arama terimleri sağlar. Bu terimlerde arama sonuçlarındaki her dokümanın ek arama terimlerinden en az birini içermesi gerekir. 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ı olarak URL'lerle kısıtlar. Desteklenen değerler şunlardır:

  • d[number]: Belirtilen sayıda son güne ait sonuçları ister.

  • w[number]: Belirtilen sayıda geçmiş haftadan sonuç isteğinde bulunur.

  • m[number]: Belirtilen sayıda son ay için sonuç isteğinde bulunur.

  • y[number]: Belirtilen sayıda geçmiş yıl için sonuç isteğinde bulunur.

queries.previousPage[].lowRange

string

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

queries.previousPage[].highRange

string

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

queries.previousPage[].fileType

string

Sonuçları, belirtilen 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)

  • Mac'te (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Zengin Metin Biçimi (rtf)

  • Shockwave Flaş (swf)

  • Metin (ans, txt).

Gelecekte başka dosya türleri eklenebilir. Güncel listeyi Google'ın dosya türüyle ilgili SSS bölümünde istediğiniz zaman 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. Belirtilmemesi durumunda 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ı, belirtilen 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:

  • mono (siyah beyaz)

  • gray (gri tonlama)

  • 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

Geçerli 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ının girdiği 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 sonucu kümesinin dizini, toplam sonuç kümesine dahil edilir (burada ilk sonucun dizini 1'dir).

queries.request[].startPage

integer

Sayfa uzunluğu count özelliği tarafından ayarlanan bu sonuç grubunun sayfa numarası.

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ımlanmamış özel bir özelliktir. Geçerli parametre değerleri şunlardır:

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

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

queries.request[].cx

string

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

queries.request[].sort

string

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

queries.request[].filter

string

Google arama sonuçlarının otomatik olarak filtrelenmesini etkinleştirir veya devre dışı bırakır. Google'ın arama sonuçları filtreleri hakkında daha fazla bilgi edinmek için Otomatik Filtreleme başlıklı makaleyi inceleyin. Bu parametre için geçerli değerler şunlardır:

  • 0: Devre dışı

  • 1: Etkin (varsayılan)

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

queries.request[].gl

string

Menşe ülkesi, parametre değeriyle eşleşen arama sonuçlarını artırır. Geçerli değerlerin bir listesi için Ülke Kodları'na bakın.

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

queries.request[].cr

string

Arama sonuçlarını, kaynağı belirli bir ülke olan dokümanlarla kısıtlar. cr parametresinin değerinde Boole operatörleri kullanabilirsiniz.

Google WebSearch, bir dokümanın bulunduğu ülkeyi belirlemek için aşağıdakileri 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) Parametresi Değerleri bölümüne bakın.

queries.request[].googleHost

string

Aramanın sınırlandırılması gereken Google alan adını (örneğin, 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ş gibi sorguya ekler.

queries.request[].hl

string

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

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

queries.request[].siteSearch

string

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

queries.request[].siteSearchFilter

string

sitesearch parametresinde adı geçen 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ç tut

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'nin bağlantısını içermesi gerektiğini belirtir.

queries.request[].orTerms

string

Dokümanda kontrol edilecek ek arama terimleri sağlar. Bu terimlerde arama sonuçlarındaki her dokümanın ek arama terimlerinden en az birini içermesi gerekir. 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ı olarak URL'lerle kısıtlar. Desteklenen değerler şunlardır:

  • d[number]: Belirtilen sayıda son güne ait sonuçları ister.

  • w[number]: Belirtilen sayıda geçmiş haftadan sonuç isteğinde bulunur.

  • m[number]: Belirtilen sayıda son ay için sonuç isteğinde bulunur.

  • y[number]: Belirtilen sayıda geçmiş yıl için sonuç isteğinde bulunur.

queries.request[].lowRange

string

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

queries.request[].highRange

string

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

queries.request[].fileType

string

Sonuçları, belirtilen 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)

  • Mac'te (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Zengin Metin Biçimi (rtf)

  • Shockwave Flaş (swf)

  • Metin (ans, txt).

Gelecekte başka dosya türleri eklenebilir. Güncel listeyi Google'ın dosya türüyle ilgili SSS bölümünde istediğiniz zaman 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. Belirtilmemesi durumunda 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ı, belirtilen 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:

  • mono (siyah beyaz)

  • gray (gri tonlama)

  • 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 sonuçların sonraki 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ının girdiği 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 sonucu kümesinin dizini, toplam sonuç kümesine dahil edilir (burada ilk sonucun dizini 1'dir).

queries.nextPage[].startPage

integer

Sayfa uzunluğu count özelliği tarafından ayarlanan bu sonuç grubunun sayfa numarası.

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ımlanmamış özel bir özelliktir. Geçerli parametre değerleri şunlardır:

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

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

queries.nextPage[].cx

string

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

queries.nextPage[].sort

string

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

queries.nextPage[].filter

string

Google arama sonuçlarının otomatik olarak filtrelenmesini etkinleştirir veya devre dışı bırakır. Google'ın arama sonuçları filtreleri hakkında daha fazla bilgi edinmek için Otomatik Filtreleme başlıklı makaleyi inceleyin. Bu parametre için geçerli değerler şunlardır:

  • 0: Devre dışı

  • 1: Etkin (varsayılan)

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

queries.nextPage[].gl

string

Menşe ülkesi, parametre değeriyle eşleşen arama sonuçlarını artırır. Geçerli değerlerin bir listesi için Ülke Kodları'na bakın.

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

queries.nextPage[].cr

string

Arama sonuçlarını, kaynağı belirli bir ülke olan dokümanlarla kısıtlar. cr parametresinin değerinde Boole operatörleri kullanabilirsiniz.

Google WebSearch, bir dokümanın bulunduğu ülkeyi belirlemek için aşağıdakileri 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) Parametresi Değerleri bölümüne bakın.

queries.nextPage[].googleHost

string

Aramanın sınırlandırılması gereken Google alan adını (örneğin, 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ş gibi sorguya ekler.

queries.nextPage[].hl

string

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

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

queries.nextPage[].siteSearch

string

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

queries.nextPage[].siteSearchFilter

string

sitesearch parametresinde adı geçen 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ç tut

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'nin bağlantısını içermesi gerektiğini belirtir.

queries.nextPage[].orTerms

string

Dokümanda kontrol edilecek ek arama terimleri sağlar. Bu terimlerde arama sonuçlarındaki her dokümanın ek arama terimlerinden en az birini içermesi gerekir. 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ı olarak URL'lerle kısıtlar. Desteklenen değerler şunlardır:

  • d[number]: Belirtilen sayıda son güne ait sonuçları ister.

  • w[number]: Belirtilen sayıda geçmiş haftadan sonuç isteğinde bulunur.

  • m[number]: Belirtilen sayıda son ay için sonuç isteğinde bulunur.

  • y[number]: Belirtilen sayıda geçmiş yıl için sonuç isteğinde bulunur.

queries.nextPage[].lowRange

string

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

queries.nextPage[].highRange

string

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

queries.nextPage[].fileType

string

Sonuçları, belirtilen 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)

  • Mac'te (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Zengin Metin Biçimi (rtf)

  • Shockwave Flaş (swf)

  • Metin (ans, txt).

Gelecekte başka dosya türleri eklenebilir. Güncel listeyi Google'ın dosya türüyle ilgili SSS bölümünde istediğiniz zaman 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. Belirtilmemesi durumunda 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ı, belirtilen 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:

  • mono (siyah beyaz)

  • gray (gri tonlama)

  • 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ı verilen sorgu için herhangi bir sıra yükseltme tanımlarsa gösterilir.

context

object (Struct format)

Belirli bir arama motoruyla ilişkili meta veriler ve ayrıntılandırmalar. Örneğin:

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

  • Aramayı hassaslaştırmak için kullanabileceğiniz bir façeta nesneleri (hassaslaştırmalar) grubu.

searchInformation

object

Arama süresi ve toplam sonuçlar da dahil olmak üzere 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 nesnesi.

bodyLines[].title

string

Metin varsa blok nesnesinin metni.

bodyLines[].htmlTitle

string

Blok nesnesinin metin içeriyorsa HTML'deki metni.

bodyLines[].url

string

Varsa blok nesnenin bağlantısının URL'si.

bodyLines[].link

string

Bir bağlantıya sahipse blok nesne bağlantısının bağlantı metni.

image

object

Varsa bu promosyonla ilişkili resim.

image.source

string

Bu promosyon bağlantısına ait resmin 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

Geçerli nesnenin türüne ilişkin benzersiz bir tanımlayıcı. Bu API için değer: customsearch#result.

title

string

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

htmlTitle

string

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

snippet

string

Arama sonucunun düz metin halinde snippet'i.

htmlSnippet

string

Arama sonucunun HTML biçimindeki snippet'i.

cacheId

string

Arama sonucunun Google tarafından önbelleğe alınmış 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

Resmi 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ı daraltmak için kullanabileceğiniz bir ayrıntılandırma etiketinin adı. Bunu kullanıcı arayüzünde göstermeyin; bunun yerine displayName kullanın.

labels[].displayName

string

Ayrıntılandırma etiketinin görünen adı. Bu, kullanıcı arayüzünde 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.