XML API referans ekleri

Boole Operatörleri

Aşağıdaki parametrelerin değerlerinde Boole operatörlerini kullanabilirsiniz:

Boole Operatörü Tanımları

Not: Parametre değerlerine boşluk eklenemez.

Boole VE [.]
Açıklama

AND operatörü (.), koleksiyonların kesişimindeki sonuçları "." operatörünün her iki tarafına döndürür.

Örnekler

Bu örnek, Fransızca veya İtalyanca olan tüm sonuçları kaldırır:
lr=(-lang_fr).(-lang_it)


Boole DEĞİL [-]
Açıklama

NOT operatörü (.), eksi ("-") operatörünün hemen ardından koleksiyondaki tüm sonuçları kaldırır.

Örnekler

Bu örnek, Fransızca tüm sonuçları kaldırır:
lr=-lang_fr

Bu örnek, Fransızca veya İtalyanca olan tüm sonuçları kaldırır:
lr=(-lang_fr).(-lang_it)

Not: Yukarıdaki ikinci örneğin, sonuçların Fransızca veya İtalyanca yazılmaması gerektiğini belirtmek için Boole AND operatörünü kullandığını fark etmiş olabilirsiniz. Sorgunuzdaki parantez yerleşimine bağlı olarak, bu sorguyu ifade etmek için Boole AND operatörünü ya da Boole OR operatörünü kullanabilirsiniz. Çünkü bir belge Fransızca yazılmışsa İtalyancada yazılmaz. Bu nedenle, Boole ifadenizde, belgenin Fransızca olmadığı ve İtalyancada yazılmadığı ifade edilmelidir.


Boole VEYA [|]
Açıklama

OR operatörü (.), dik çizgi ("|") operatörünün solundaki koleksiyonda veya sağındaki koleksiyonda bulunan sonuçları döndürür.

Örnekler

Bu örnek, Basitleştirilmiş Çince veya Geleneksel Çincede yazılan tüm sonuçları döndürür:
lr=lang_zh-TW|lang_zh-CN

Bu örnekte, Fransızca veya İtalyanca yazılmamış tüm sonuçlar istenmektedir. Bu örnekte, parantez özelliğinin Boole AND operatörü için olan örnek sorgudan farklı bir konuma yerleştirildiğine dikkat edin:
lr=-(lang_fr|lang_it)


Boole Parantezleri [()]
Açıklama

Bu operatör, parantez dışındaki terimler değerlendirilmeden önce en içteki parantez grubunda yer alan tüm terimlerin değerlendirilmesini sağlar. Terimlerin değerlendirildiği sırayı ayarlamak için parantezleri kullanabilirsiniz.

Örnekler

NOT [-] operatörüyle ilgili örnekte Fransızca veya İtalyancada yazılmamış istek sonuçları için aşağıdaki yapı gösterilmektedir:
lr=(-lang_fr).(-lang_it)

OR (|) operatörü örneği, İtalyanca Fransızca yazılmamış sonuçlar için isteği de gösterir. İkinci örnekte AND operatörü yerine OR operatörü kullanıldığından, parantezlerin konumu da değiştirilmelidir:
lr=-(lang_fr|lang_it)


URL Çıkışı

HTTP arama isteğinde bulunmak için Google'ın HTTP isteğinizi doğru bir şekilde çevirebilmesi ve uygun bir yanıt oluşturabilmesi için belirli kurallara uymanız gerekir.

HTTP URL şeması, bir HTTP URL isteğinin yalnızca belirli karakterleri içerebileceğini belirtir:

  • Alfanümerik karakterler: (a-z, A-Z, 0-9)
  • Özel karakterler: $ - _ . | + ! * ' ( )
  • Ayrılmış karakterler: ; / ? : @ = &

Google, URL'lerin kodunu çözmek için ayrılmış karakterler, arama özellikleri isteğinde bulunmak için de bazı özel karakterler kullanır. Bu nedenle, arama parametresi değerlerinde görünen, alfa-sayısal olmayan tüm karakterlerde URL çıkışı yapmanız gerekir.

URL'nin bir dizeden çıkışını yapmak için her boşluk karakteri dizisini tek bir "+" (artı işaretine) dönüştürün ve alfasayısal olmayan diğer karakterleri ilgili karakterin değerini temsil eden onaltılık kodlamayla değiştirin. Yukarıda listelenen özel ve ayrılmış karakterlerin on altılı kodlamaları aşağıdaki tabloda gösterilmektedir. Bu karakterlerin her biri, istek parametresi değerlerinde URL çıkışlı olmalıdır.

Karakter Onaltılı
Kodlama
$ %24
- %2G
_ %5F
. %2D
+ %2 Mr
! %21
* %2A
" %22
' %27
( %28
) %29
; %3 Mr
/ %2F
? %3F
: %3A
@ %40
= %3G
- %26
| %7C

Örnekler

Orijinal Dize URL Çıkışı Dizesi
yumruk yumruk
O'Reilly K%27Reilly

URL çıkışıyla ilgili ek bilgileri W3C ve IETF web sitelerinde bulabilirsiniz.

Sonuçlar Sıkıştırılıyor

Google, HTTP gzip sıkıştırması kullanarak arama sonuçlarını sıkıştırabilir. gzip algoritmasını kullanarak sıkıştırılmış içeriğin sıkıştırmasını açabilirseniz %50 ila %70 bant genişliği tasarrufu sağlayarak yanıt sürelerinizi iyileştirebilirsiniz.

Google'ın sonuçları sıkıştırılmış biçimde döndürmesini istemek için HTTP Accept-Encoding üst bilgisini HTTP arama isteğinize aşağıdaki gibi ekleyin:

Kabul-Kodlama: gzip

Google, gzip sıkıştırmasını kullanarak arama sonuçları döndürürse döndürülen HTTP üstbilgilerine aşağıdaki satırı ekleriz:

İçerik Kodlaması: gzip

Not: Yukarıda gösterildiği gibi yanıtta Content-Encoding HTTP üst bilgisi yoksa Google sonuçları sıkıştırmamıştır.

Bu davranış HTTP standard içinde belirtilmiştir. HTTP gzip sıkıştırmasının kullanımıyla ilgili ek bilgi için lütfen bu dokümana bakın.

Uluslararası Değerler

Karakter Kodlama Şemaları

Aşağıdaki tabloda, Google'ın desteklediği karakter kodlama şemaları listelenmektedir. ie ve oe parametrelerine bu tablonun ilk iki sütunundan herhangi birinde değer atayabilirsiniz. İlk sütundaki değerler kodlama şemalarının takma adlarıdır; ikinci sütundaki değerler ise kodlama şemalarının standart adlarıdır. Google, standart adları XML sonuçlarında döndürür ve standart adlar, dokümanınızın HTTP Content-type başlıklarında kullanılmaya uygundur.

Google adı Kodlama Desteklenen İlişkili Diller
latin1 ISO-8859-1 Batı Avrupa (Katalanca, Danca, Felemenkçe, İngilizce, Fince, Fransızca, Almanca, Endonezce, İtalyanca, Norveççe, Portekizce, İspanyolca, İsveççe)
latin2 ISO-8859-2 Doğu Avrupa (Hırvatça, Çekçe, Macarca, Lehçe, Romence, Sırpça, Slovakça, Slovence)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Baltık (Estonca, Letonca, Litvanca)
kiril ISO-8859-5 Bulgarca, Rusça
arabic ISO-8859-6  
yunan ISO-8859-7 Yunanca
hebrew ISO-8859-8 İbranice
latin5 ISO-8859-9  
latin6 ISO-8859-10 İzlanda dili
euc-jp EUC-JP Japonca
Euc-kr EUC-KR Korece
sjis Shift_JIS Japonca
big5 Big5 Geleneksel Çince
gb GB2312 Basitleştirilmiş Çince
utf8 UTF-8 Tümü

Desteklenen Arayüz Dilleri

Google 74 dili desteklemektedir. Varsayılan arayüz dili İngilizce'dir. Aşağıdaki listede Google'ın desteklediği tüm arayüz dilleri tanımlanmaktadır.

Görüntü Dili hl Parametre Değeri
Afrikaanca af
Arnavutça sq
Amharca öö
Arapça ar
Ermenice hy
Azerbaycan dili az
Bengalce bn
Bulgarca bg
Burmaca my
Katalanca ca
Çince (Basitleştirilmiş) zh-CN
Çince (Geleneksel) zh-TW
Hırvatça s
Çekçe cs
Danca da
Felemenkçe nl
İngilizce (İngiltere) en-GB
İngilizce en
Estonca et
Filipince fil
Fince fi
Fransızca (Kanada) fr-CA
Fransızca fr
Gürcüce ka
Almanca de
Yunanca el
Gucerat dili gu
İbranice iw
Hintçe hi
Macarca hu
İzlanda dili :
Endonezce id
İtalyanca it
Japonca ja
Kannada dili kn
Kazakça kk
Kmerce km
Korece ko
Kırgızca ky
Laoca lo
Letonca lv
Litvanca lt
Makedonca mk
Malay dili ms
Malayam ml
Marathi mr
Moğolca mn
Nepalce ne
Norveççe (Bokmal) no
Farsça fa
Lehçe pl
Portekizce (Brezilya) pt-BR
Portekizce (Portekiz) pt-PT
Pencap Dili pa
Rumence ro
Rusça ru
Sırpça (Latin) sr-Latn
Sırpça sr
Singalaca si
Slovakça sk
Slovence sl
İspanyolca (Latin Amerika) es-419
İspanyolca es
Swahili sw
İsveççe sv
Tamil dili ta
Telugu dili te
Tayca th
Türkçe tr
Ukraynaca uk
Urduca ur
Özbekçe uz
Vietnamca vi
Galce cy

Dil Koleksiyonu Değerleri

lr sorgu parametresini kullanarak bir dil filtresi belirtmek için aşağıdaki değerleri kullanabilirsiniz:

Dil lr Parametre Değeri
Arapça lang_ar
Bulgarca lang_bg
Katalanca lang_ca
Çince (Basitleştirilmiş) lang_zh-CN
Çince (Geleneksel) lang_zh-TW
Hırvatça lang_hr
Çekçe lang_cs
Danca lang_da
Felemenkçe lang_nl
İngilizce lang_en
Estonca lang_et
Fince lang_fi
Fransızca lang_fr
Almanca lang_de
Yunanca lang_el
İbranice lang_iw
Macarca lang_hu
İzlanda dili lang_is
Endonezce lang_id
İtalyanca lang_it
Japonca lang_ja
Korece lang_ko
Letonca lang_lv
Litvanca lang_lt
Norveççe lang_no
Lehçe lang_pl
Portekizce lang_pt
Rumence lang_ro
Rusça lang_ru
Sırpça lang_sr
Slovakça lang_sk
Slovence lang_sl
İspanyolca lang_es
İsveççe lang_sv
Türkçe lang_tr

Ülke Koleksiyon Değerleri

cr sorgu parametresini kullanarak bir ülke filtresi belirtmek için aşağıdaki değerleri kullanabilirsiniz:

Ülke Ülke Koleksiyon Adı
Afganistan countryAF
Arnavutluk countryAL
Cezayir countryDZ
Amerikan Samoası countryAS
Andora countryAD
Angola countryAO
Anguilla countryAI
Antarktika countryAQ
Antigua ve Barbuda countryAG
Arjantin countryAR
Ermenistan countryAM
Aruba countryAW
Avustralya countryAU
Avusturya countryAT
Azerbaycan countryAZ
Bahamalar countryBS
Bahreyn countryBH
Bangladeş countryBD
Barbados countryBB
Belarus countryBY
Belçika countryBE
Beliz countryBZ
Benin countryBJ
Bermuda countryBM
Butan countryBT
Bolivya countryBO
Bosna Hersek countryBA
Botsvana countryBW
Bouvet Adası countryBV
Brezilya countryBR
Britanya Hint Okyanusu Toprakları countryIO
Brunei Darussalam countryBN
Bulgaristan countryBG
Burkina Faso countryBF
Burundi countryBI
Kamboçya countryKH
Kamerun countryCM
Kanada countryCA
Cabo Verde countryCV
Cayman Adaları countryKY
Orta Afrika Cumhuriyeti countryCF
Çad countryTD
Şili countryCL
Çin countryCN
Christmas Adası countryCX
Cocos (Keeling) Adaları countryCC
Kolombiya countryCO
Komorlar countryKM
Kongo countryCG
Kongo Demokratik Cumhuriyeti countryCD
Cook Adaları countryCK
Kosta Rika countryCR
Fildişi Sahili countryCI
Hırvatistan (Hrvatska) countryHR
Küba countryCU
Güney Kıbrıs Rum Yönetimi countryCY
Çek Cumhuriyeti countryCZ
Danimarka countryDK
Cibuti countryDJ
Dominik countryDM
Dominik Cumhuriyeti countryDO
Doğu Timor countryTP
Ekvador countryEC
Mısır countryEG
El Salvador countrySV
Ekvator Ginesi countryGQ
Eritre countryER
Estonya countryEE
Etiyopya countryET
Avrupa Birliği countryEU
Falkland Adaları (Malvinas) countryFK
Faroe Adaları countryFO
Fiji countryFJ
Finlandiya countryFI
Fransa countryFR
Metropolitan Fransa countryFX
Fransız Guyanası countryGF
Fransız Polinezyası countryPF
Fransız Güney Toprakları countryTF
Gabon countryGA
Gambiya countryGM
Gürcistan countryGE
Almanya countryDE
Gana countryGH
Cebelitarık countryGI
Yunanistan countryGR
Grönland countryGL
Grenada countryGD
Guadalupe countryGP
Guam countryGU
Guatemala countryGT
Gine countryGN
Gine-Bissau countryGW
Guyana countryGY
Haiti countryHT
Heard Adası ve McDonald Adaları countryHM
Vatikan Şehir Devleti countryVA
Honduras countryHN
Hong Kong countryHK
Macaristan countryHU
İzlanda countryIS
Hindistan countryIN
Endonezya countryID
İran İslam Cumhuriyeti countryIR
Irak countryIQ
İrlanda countryIE
İsrail countryIL
İtalya countryIT
Jamaika countryJM
Japonya countryJP
Ürdün countryJO
Kazakistan countryKZ
Kenya countryKE
Kiribati countryKI
Kore Demokratik Halk Cumhuriyeti countryKP
Kore Cumhuriyeti countryKR
Kuveyt countryKW
Kırgızistan countryKG
Lao Demokratik Halk Cumhuriyeti countryLA
Letonya countryLV
Lübnan countryLB
Lesoto countryLS
Liberya countryLR
Libya Arap Cemahiriyesi countryLY
Lihtenştayn countryLI
Litvanya countryLT
Lüksemburg countryLU
Makao countryMO
Makedonya, Eski Yugosalv Cumhuriyeti countryMK
Madagaskar countryMG
Malawi countryMW
Malezya countryMY
Maldivler countryMV
Mali countryML
Malta countryMT
Marshall Adaları countryMH
Martinik countryMQ
Moritanya countryMR
Mauritius Adası countryMU
Mayotte countryYT
Meksika countryMX
Mikronezya Federe Devletleri countryFM
Moldova Cumhuriyeti countryMD
Monako countryMC
Moğolistan countryMN
Montserrat countryMS
Fas countryMA
Mozambik countryMZ
Burma countryMM
Namibya countryNA
Nauru countryNR
Nepal countryNP
Hollanda countryNL
Hollanda Antilleri countryAN
Yeni Kaledonya countryNC
Yeni Zelanda countryNZ
Nikaragua countryNI
Nijer countryNE
Nijerya countryNG
Niue countryNU
Norfolk Adası countryNF
Kuzey Mariana Adaları countryMP
Norveç countryNO
Umman countryOM
Pakistan countryPK
Palau countryPW
Filistin Bölgesi countryPS
Panama countryPA
Papua Yeni Gine countryPG
Paraguay countryPY
Peru countryPE
Filipinler countryPH
Pitcairn countryPN
Polonya countryPL
Portekiz countryPT
Porto Riko countryPR
Katar countryQA
Reunion countryRE
Romanya countryRO
Rusya Federasyonu countryRU
Ruanda countryRW
Saint Helena countrySH
Saint Kitts ve Nevis countryKN
Saint Lucia countryLC
Saint Pierre ve Miquelon countryPM
Saint Vincent ve Grenadines countryVC
Samoa countryWS
San Marino countrySM
Sao Tome ve Principe countryST
Suudi Arabistan countrySA
Senegal countrySN
Sırbistan ve Karadağ countryCS
Seyşeller countrySC
Sierra Leone countrySL
Singapur countrySG
Slovakya countrySK
Slovenya countrySI
Solomon Adaları countrySB
Somali countrySO
Güney Afrika countryZA
Güney Georgia ve Güney Sandwich Adaları countryGS
İspanya countryES
Sri Lanka countryLK
Sudan countrySD
Surinam countrySR
Svalbard ve Jan Mayen countrySJ
Svaziland countrySZ
İsveç countrySE
İsviçre countryCH
Suriye Arap Cumhuriyeti countrySY
Tayvan, Çin'in Eyaleti countryTW
Tacikistan countryTJ
Tanzanya Birleşik Cumhuriyeti countryTZ
Tayland countryTH
Togo countryTG
Tokelau countryTK
Tonga countryTO
Trinidad ve Tobago countryTT
Tunus countryTN
Türkiye countryTR
Türkmenistan countryTM
Turks ve Caicos Adaları countryTC
Tuvalu countryTV
Uganda countryUG
Ukrayna countryUA
Birleşik Arap Emirlikleri countryAE
Birleşik Krallık countryUK
Amerika Birleşik Devletleri countryUS
Amerika Birleşik Devletleri'nin Küçük Dış Adaları countryUM
Uruguay countryUY
Özbekistan countryUZ
Vanuatu countryVU
Venezuela countryVE
Vietnam countryVN
Virgin Adaları, İngiliz countryVG
Virgin Adaları, ABD countryVI
Wallis ve Futuna countryWF
Batı Sahra countryEH
Yemen countryYE
Yugoslavya countryYU
Zambiya countryZM
Zimbabve countryZW

Ülke Kodları

Aşağıdaki tabloda, gl parametresinin değeri olarak kullanılabilecek iki harfli ülke kodları listelenmektedir:

Ülke Ülke Kodu
Afganistan af
Arnavutluk al
Cezayir dz
Amerikan Samoası CANNOT TRANSLATE
Andora reklam
Angola ao
Anguilla ai
Antarktika ak
Antigua ve Barbuda ag
Arjantin ar
Ermenistan öö
Aruba aw
Avustralya au
Avusturya at
Azerbaycan az
Bahamalar bs
Bahreyn bh
Bangladeş bd
Barbados bb
Belarus kaydeden:
Belçika be
Beliz Bz
Benin bj
Bermuda sd
Butan bt
Bolivya bo
Bosna Hersek ba
Botsvana bw
Bouvet Adası kv
Brezilya br
Britanya Hint Okyanusu Toprakları io
Brunei Darussalam bn
Bulgaristan bg
Burkina Faso bf
Burundi Bi
Kamboçya kh
Kamerun cm
Kanada ca
Cabo Verde cv
Cayman Adaları ky
Orta Afrika Cumhuriyeti cf
Çad td
Şili cl
Çin cn
Christmas Adası cx
Cocos (Keeling) Adaları Bilgi
Kolombiya co
Komorlar km
Kongo tk
Kongo Demokratik Cumhuriyeti cd
Cook Adaları ck
Kosta Rika cr
Fildişi Sahili ci
Hırvatistan s
Küba cu
Güney Kıbrıs Rum Yönetimi cy
Çek Cumhuriyeti cz
Danimarka dk
Cibuti dj
Dominik tdk
Dominik Cumhuriyeti do
Ekvador ec
Mısır Örnek:
El Salvador sv
Ekvator Ginesi Gk
Eritre er
Estonya ee
Etiyopya et
Falkland Adaları (Malvinas) fk
Faroe Adaları CANNOT TRANSLATE
Fiji fj
Finlandiya fi
Fransa fr
Fransız Guyanası kız arkadaş
Fransız Polinezyası pf
Fransız Güney Toprakları tf
Gabon ga
Gambiya gm
Gürcistan ge
Almanya de
Gana gh
Cebelitarık Gi
Yunanistan gr
Grönland gl
Grenada gd
Guadalupe gp
Guam gu
Guatemala gt
Gine gn
Gine-Bissau gw
Guyana gy
Haiti ht
Heard Adası ve McDonald Adaları hm
Vatikan Şehir Devleti va
Honduras hn
Hong Kong hk
Macaristan hu
İzlanda :
Hindistan şurada bulunur
Endonezya id
İran İslam Cumhuriyeti ir
Irak iq
İrlanda ie
İsrail il
İtalya it
Jamaika mm
Japonya jp
Ürdün jo
Kazakistan kz
Kenya ke
Kiribati ki
Kore Demokratik Halk Cumhuriyeti kp
Kore Cumhuriyeti kr
Kuveyt kw
Kırgızistan kg
Lao Demokratik Halk Cumhuriyeti La
Letonya lv
Lübnan lb
Lesoto ls
Liberya lr
Libya Arap Cemahiriyesi ly
Lihtenştayn li
Litvanya lt
Lüksemburg lu
Makao ay
Makedonya, Eski Yugosalv Cumhuriyeti mk
Madagaskar mg
Malawi mw
Malezya my
Maldivler mv
Mali ml
Malta mt
Marshall Adaları mh
Martinik mq
Moritanya mr
Mauritius Adası mu
Mayotte yt
Meksika mx
Mikronezya Federe Devletleri fm
Moldova Cumhuriyeti md
Monako Mc
Moğolistan mn
Montserrat ms
Fas ma
Mozambik mz
Burma mm
Namibya na
Nauru nr
Nepal np
Hollanda nl
Hollanda Antilleri CANNOT TRANSLATE
Yeni Kaledonya nc
Yeni Zelanda nz
Nikaragua ni
Nijer ne
Nijerya ng
Niue nu
Norfolk Adası afet
Kuzey Mariana Adaları mp
Norveç no
Umman om
Pakistan pk
Palau pw
İşgal Altındaki Filistin Toprakları ps
Panama pa
Papua Yeni Gine pg
Paraguay py
Peru pe
Filipinler ph
Pitcairn CANNOT TRANSLATE
Polonya pl
Portekiz pt
Porto Riko pr
Katar qa
Reunion YANIT
Romanya ro
Rusya Federasyonu ru
Ruanda rw
Saint Helena sh
Saint Kitts ve Nevis kn
Saint Lucia lc
Saint Pierre ve Miquelon ös
Saint Vincent ve Grenadines vc
Samoa ws
San Marino sm
Sao Tome ve Principe st
Suudi Arabistan sa
Senegal sn
Sırbistan ve Karadağ cs
Seyşeller sc
Sierra Leone sl
Singapur sg
Slovakya sk
Slovenya si
Solomon Adaları sb
Somali so
Güney Afrika za
Güney Georgia ve Güney Sandwich Adaları gs
İspanya es
Sri Lanka lk
Sudan sd
Surinam sr
Svalbard ve Jan Mayen sg
Svaziland sz
İsveç se
İsviçre ch
Suriye Arap Cumhuriyeti sn
Tayvan, Çin'in Eyaleti tw
Tacikistan tj
Tanzanya Birleşik Cumhuriyeti tz
Tayland th
Doğu Timor tl
Togo tg
Tokelau tk
Tonga -
Trinidad ve Tobago tt
Tunus tn
Türkiye tr
Türkmenistan tm
Turks ve Caicos Adaları tc
Tuvalu TV
Uganda ug
Ukrayna ua
Birleşik Arap Emirlikleri ae
Birleşik Krallık uk
Amerika Birleşik Devletleri us
Amerika Birleşik Devletleri'nin Küçük Dış Adaları ee
Uruguay uy
Özbekistan uz
Vanuatu vu
Venezuela ve
Vietnam vn
Virgin Adaları, İngiliz vg
Virgin Adaları, ABD vi
Wallis ve Futuna wf
Batı Sahra yani
Yemen pek tabi ki
Zambiya zm
Zimbabve Zw