Lampiran referensi API XML

Operator Boolean

Anda dapat menggunakan operator Boolean dalam nilai untuk parameter berikut:

Definisi Operator Boolean

Catatan: Anda tidak dapat menyertakan spasi dalam nilai parameter.

Boolean DAN [.]
Deskripsi

Operator AND (.) menampilkan hasil yang berada di perpotongan koleksi ke kedua sisi operator ".".
Contoh

Contoh ini menghapus semua hasil dalam bahasa Prancis atau Italia:
lr=(-lang_fr).(-lang_it)

Boolean BUKAN [-]
Deskripsi

Operator NOT (.) menghapus semua hasil dalam koleksi tepat setelah operator minus ("-").
Contoh

Contoh ini menghapus semua hasil yang menggunakan bahasa Prancis:
lr=-lang_fr

Contoh ini menghapus semua hasil dalam bahasa Prancis atau Italia:
lr=(-lang_fr).(-lang_it)

Catatan: Anda mungkin telah memperhatikan bahwa contoh kedua di atas menggunakan operator Boolean AND untuk menentukan bahwa hasil tidak boleh ditulis dalam bahasa Prancis atau Italia. Bergantung pada penempatan tanda kurung dalam kueri, Anda dapat menggunakan operator Boolean AND atau operator Boolean OR untuk mengekspresikan kueri ini. Hal ini karena jika dokumen ditulis dalam bahasa Prancis, maka dokumen tersebut tidak ditulis dalam bahasa Italia. Dengan demikian, pernyataan Boolean Anda harus menyatakan bahwa dokumen tidak ditulis dalam bahasa Prancis dan dokumen tidak ditulis dalam bahasa Italia.

Boolean ATAU [|]
Deskripsi

Operator OR (.) menampilkan hasil yang berada dalam koleksi di sebelah kiri atau koleksi di sebelah kanan operator ("|").
Contoh

Contoh ini menampilkan semua hasil yang ditulis dalam bahasa China Aksara Sederhana atau China Aksara Tradisional:
lr=lang_zh-TW|lang_zh-CN

Contoh ini meminta semua hasil yang tidak ditulis dalam bahasa Prancis atau Italia; perhatikan bahwa hasil tersebut menempatkan tanda kurung di lokasi yang berbeda dengan contoh kueri untuk operator Boolean AND:
lr=-(lang_fr|lang_it)


Tanda Kurung Boolean [()]
Deskripsi

Operator ini memungkinkan Anda memastikan bahwa semua istilah dalam kumpulan tanda kurung terdalam dievaluasi sebelum istilah di luar tanda kurung dievaluasi. Anda dapat menggunakan tanda kurung untuk menyesuaikan urutan penghapusan istilah.
Contoh

Contoh untuk operator NOT [-] menunjukkan konstruksi berikut untuk hasil permintaan yang tidak ditulis dalam bahasa Prancis atau Italia:
lr=(-lang_fr).(-lang_it)

Contoh untuk operator OR (|) juga menunjukkan permintaan untuk hasil yang tidak ditulis dalam bahasa Prancis Italia. Karena contoh terakhir menggunakan operator OR, bukan operator AND, lokasi tanda kurung juga harus diubah:
lr=-(lang_fr|lang_it)

Konversi URL

Untuk membuat permintaan penelusuran HTTP, Anda harus mengikuti konvensi tertentu agar Google dapat menerjemahkan permintaan HTTP Anda dengan benar dan menghasilkan respons yang sesuai.

Skema URL HTTP menentukan bahwa permintaan URL HTTP hanya boleh berisi karakter tertentu:

  • Karakter alfanumerik: (a-z, A-Z, 0-9)
  • Karakter khusus: $ - _ . | + ! * ' ( )
  • Karakter yang dicadangkan: ; / ? : @ = &

Google menggunakan karakter yang dicadangkan untuk mendekode URL dan menggunakan beberapa karakter khusus untuk meminta fitur penelusuran. Oleh karena itu, Anda harus meng-escape semua karakter nonalfanumerik yang terjadi dalam nilai parameter penelusuran.

Untuk meng-escape string, konversi setiap urutan karakter spasi kosong menjadi satu "+" (tanda plus) dan ganti karakter nonalfanumerik lainnya dengan encoding heksadesimal yang mewakili nilai karakter tersebut. Encoding heksadesimal untuk karakter khusus dan khusus yang tercantum di atas ditunjukkan dalam tabel berikut. Setiap karakter ini harus berupa URL yang di-escape dalam parameter value permintaan.

Karakter Encoding
Heksadesimal
$ %24
- %2 h
_ %5F
. %2E
+ %2 M
! %21
* %2A
" %22
' %27
( %28
) %29
; %3 M
/ %2F
? %3F
: %3A
@ %40
= %3D
& %26
| %7C

Contoh

String Asli String URL yang Di-escape
punch&judy punch%26judy
O'Reilly O%27Reilly

Anda dapat menemukan informasi tambahan tentang pengalihan URL di situs W3C dan IETF.

Mengompresi Hasil

Google dapat mengompresi hasil penelusuran menggunakan kompresi gzip HTTP. Jika Anda dapat mendekompresi konten yang telah dikompresi menggunakan algoritma gzip, Anda dapat memperoleh penghematan bandwidth sebesar 50 persen hingga 70 persen, yang dapat mempercepat waktu respons.

Untuk meminta Google menampilkan hasil dalam format terkompresi, tambahkan header Accept-Encoding HTTP ke permintaan penelusuran HTTP Anda:

Menerima Encoding: gzip

Jika Google menampilkan hasil penelusuran menggunakan kompresi gzip, kami akan menyertakan baris berikut dalam header HTTP yang ditampilkan:

Encoding Konten: gzip

Catatan: Jika header HTTP Content-Encoding tidak ada dalam respons seperti yang ditunjukkan di atas, berarti Google tidak mengompresi hasilnya.

Perilaku ini ditentukan dalam standar HTTP. Lihat dokumen tersebut untuk informasi tambahan tentang penggunaan kompresi gzip HTTP.

Nilai-Nilai Internasional

Skema Encoding Karakter

Tabel berikut mencantumkan skema encoding karakter yang didukung Google. Anda dapat menetapkan nilai pada parameter ie dan oe di salah satu dari dua kolom pertama tabel ini. Nilai di kolom pertama adalah nama panggilan untuk skema encoding; nilai di kolom kedua adalah nama standar untuk skema encoding. Google menampilkan nama standar dalam hasil XML, dan nama standar tersebut cocok untuk digunakan dalam header Content-type HTTP dokumen Anda.

Nama Google Encoding Bahasa Terkait yang Didukung
latin1 ISO-8859-1 Eropa Barat (Katala, Denmark, Belanda, Inggris, Finlandia, Prancis, Jerman, Indonesia, Italia, Norwegia, Portugis, Spanyol, Swedia)
latin2 ISO-8859-2 Eropa Timur (Kroasia, Ceko, Hungaria, Polandia, Rumania, Serbia, Slovakia, Slovenia)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Baltik (Estonia, Latvia, Lituania)
sirilik ISO-8859-5 Bulgaria, Rusia
arab ISO-8859-6  
Yunani ISO-8859-7 Yunani
ibrani ISO-8859-8 Ibrani
latin5 ISO-8859-9  
latin6 ISO-8859-10 Islan
euc-jp EUC-JP Jepang
euc-kr EUC-KR Korea
sjis Shift_JIS Jepang
big5 Big5 China Aks. Tradisional
gb GB2312 China Aksara Sederhana
utf8 UTF-8 Semua

Bahasa Antarmuka yang Didukung

Google mendukung 74 bahasa. Bahasa antarmuka default adalah bahasa Inggris. Daftar berikut mengidentifikasi semua bahasa antarmuka yang didukung Google.

Bahasa Tampilan Nilai Parameter hl
Afrika af
Albania sq
Amhar am
Arab ar
Armenia hy
Azerbaijan az
Bengali bn
Bulgaria bg
Burma my
Katala ca
China (Aksara Sederhana) zh-CN
China (Tradisional) zh-TW
Kroat jam
Ceko cs
Dansk da
Belanda nl
Inggris (Britania) en-GB
Inggris id
Estonia et
Filipino fil
Finlandia fi
Prancis (Kanada) fr-CA
Prancis fr
Georgia ka
Jerman de
Yunani el
Gujarati gu
Ibrani iw
Hindi hi
Hungaria hu
Islan -
Indonesia id
Italia it
Jepang ja
Kannada kn
Kazakh kk
Khmer km
Korea ko
Kirgiz ky
Lao lo
Latvia lv
Lituania lt
Makedonia mk
Malaysia ms
Malayam ml
Marathi mr
Mongolia mn
Nepal ne
Norwegia (Bokmal) no
Persia fa
Polandia pl
Portugis (Brasil) pt-BR
Portugis (Portugal) pt-PT
Punjabi pa
Rumania ro
Rusia ru
Serbia (Latin) sr-Latn
Serbia sr
Sinhala si
Slovakia sk
Slovenia sl
Spanyol (Amerika Latin) es-419
Spanyol es
Swahili sw
Swedia sv
Tamil ta
Telugu te
Thai th
Turki tr
Ukraina uk
Urdu ur
Uzbek uz
Vietnam vi
Wales cy

Nilai Koleksi Bahasa

Anda dapat menggunakan nilai berikut untuk menentukan filter bahasa menggunakan parameter kueri lr:

Language Nilai Parameter lr
Arab lang_ar
Bulgaria lang_bg
Katala lang_ca
China (Aksara Sederhana) lang_zh-CN
China (Tradisional) lang_zh-TW
Kroasia lang_hr
Ceko lang_cs
Denmark lang_da
Belanda lang_nl
Inggris lang_en
Estonia lang_et
Finlandia lang_fi
Prancis lang_fr
Jerman lang_de
Yunani lang_el
Ibrani lang_iw
Hungaria lang_hu
Islan lang_is
Indonesia lang_id
Italia lang_it
Jepang lang_ja
Korea lang_ko
Latvia lang_lv
Lituania lang_lt
Norwegia lang_no
Polandia lang_pl
Portugis lang_pt
Rumania lang_ro
Rusia lang_ru
Serbia lang_sr
Slovakia lang_sk
Slovenia lang_sl
Spanyol lang_es
Swedia lang_sv
Turkiye lang_tr

Nilai Koleksi Negara

Anda dapat menggunakan nilai berikut untuk menentukan filter negara menggunakan parameter kueri cr:

Negara Nama Koleksi Negara
Afganistan countryAF
Albania countryAL
Aljazair countryDZ
Samoa Amerika countryAS
Andorra countryAD
Angola countryAO
Anguila countryAI
Antarktika countryAQ
Antigua dan Barbuda countryAG
Argentina countryAR
Armenia countryAM
Aruba countryAW
Australia countryAU
Austria countryAT
Azerbaijan countryAZ
Bahama countryBS
Bahrain countryBH
Bangladesh countryBD
Barbados countryBB
Belarus countryBY
Belgia countryBE
Belize countryBZ
Benin countryBJ
Bermuda countryBM
Bhutan countryBT
Bolivia countryBO
Bosnia dan Herzegovina countryBA
Botswana countryBW
Pulau Bouvet countryBV
Brasil countryBR
Wilayah Inggris di Samudra Hindia countryIO
Brunei Darussalam countryBN
Bulgaria countryBG
Burkina Faso countryBF
Burundi countryBI
Kamboja countryKH
Kamerun countryCM
Kanada countryCA
Tanjung Verde countryCV
Kepulauan Cayman countryKY
Republik Afrika Tengah countryCF
Chad countryTD
Cile countryCL
Cina countryCN
Pulau Natal countryCX
Kepulauan Cocos (Keeling) countryCC
Kolombia countryCO
Komoro countryKM
Kongo countryCG
Republik Demokratik Kongo countryCD
Kepulauan Cook countryCK
Kosta Rika countryCR
Cote D'ivoire countryCI
Kroasia (Hrvatska) countryHR
Kuba countryCU
Siprus countryCY
Republik Ceko countryCZ
Denmark countryDK
Djibouti countryDJ
Dominika countryDM
Republik Dominika countryDO
Timor Leste countryTP
Ekuador countryEC
Mesir countryEG
El Salvador countrySV
Guinea Ekuatorial countryGQ
Eritrea countryER
Estonia countryEE
Etiopia countryET
Uni Eropa countryEU
Kepulauan Falkland (Malvinas) countryFK
Kepulauan Faroe countryFO
Fiji countryFJ
Finlandia countryFI
Prancis countryFR
Prancis, Metropolitan countryFX
Guyana Prancis countryGF
Polinesia Prancis countryPF
Teritori Selatan Prancis countryTF
Gabon countryGA
Gambia countryGM
Georgia countryGE
Jerman countryDE
Ghana countryGH
Gibraltar countryGI
Yunani countryGR
Greenland countryGL
Grenada countryGD
Guadeloupe countryGP
Guam countryGU
Guatemala countryGT
Guinea countryGN
Guinea-Bissau countryGW
Guyana countryGY
Haiti countryHT
Pulau Heard dan Kepulauan McDonald countryHM
Takhta Suci (Negara Kota Vatikan) countryVA
Honduras countryHN
Hong Kong countryHK
Hungaria countryHU
Islandia countryIS
India countryIN
Indonesia countryID
Republik Islam Iran countryIR
Irak countryIQ
Irlandia countryIE
Israel countryIL
Italia countryIT
Jamaika countryJM
Jepang countryJP
Yordania countryJO
Kazakhstan countryKZ
Kenya countryKE
Kiribati countryKI
Republik Rakyat Demokratik Korea countryKP
Republik Korea countryKR
Kuwait countryKW
Kirgizstan countryKG
Republik Demokratik Rakyat Laos countryLA
Latvia countryLV
Lebanon countryLB
Lesotho countryLS
Liberia countryLR
Jamahiryah Arab Libya countryLY
Liechtenstein countryLI
Lituania countryLT
Luksemburg countryLU
Makau countryMO
Makedonia, Bekas Republik Yugosalv countryMK
Madagaskar countryMG
Malawi countryMW
Malaysia countryMY
Maladewa countryMV
Mali countryML
Malta countryMT
Kepulauan Marshall countryMH
Martinik countryMQ
Mauritania countryMR
Mauritius countryMU
Mayotte countryYT
Meksiko countryMX
Negara Federasi Mikronesia countryFM
Republik Moldova countryMD
Monako countryMC
Mongolia countryMN
Montserrat countryMS
Maroko countryMA
Mozambik countryMZ
Myanmar countryMM
Namibia countryNA
Nauru countryNR
Nepal countryNP
Belanda countryNL
Antillen Belanda countryAN
Kaledonia Baru countryNC
Selandia Baru countryNZ
Nikaragua countryNI
Niger countryNE
Nigeria countryNG
Niue countryNU
Pulau Norfolk countryNF
Kepulauan Mariana Utara countryMP
Norwegia countryNO
Oman countryOM
Pakistan countryPK
Palau countryPW
Palestina countryPS
Panama countryPA
Papua Nugini countryPG
Paraguay countryPY
Peru countryPE
Filipina countryPH
Pitcairn countryPN
Polandia countryPL
Portugal countryPT
Puerto Riko countryPR
Qatar countryQA
Reunion countryRE
Rumania countryRO
Federasi Rusia countryRU
Rwanda countryRW
Saint Helena countrySH
Saint Kitts dan Nevis countryKN
Saint Lucia countryLC
Saint Pierre dan Miquelon countryPM
Saint Vincent dan Grenadines countryVC
Samoa countryWS
San Marino countrySM
Sao Tome dan Príncipe countryST
Arab Saudi countrySA
Senegal countrySN
Serbia dan Montenegro countryCS
Seychelles countrySC
Sierra Leone countrySL
Singapura countrySG
Slovakia countrySK
Slovenia countrySI
Kepulauan Solomon countrySB
Somalia countrySO
Afrika Selatan countryZA
Georgia Selatan dan Kepulauan Sandwich Selatan countryGS
Spanyol countryES
Sri Lanka countryLK
Sudan countrySD
Suriname countrySR
Svalbard dan Jan Mayen countrySJ
eSwatini countrySZ
Swedia countrySE
Swiss countryCH
Republik Arab Suriah countrySY
Taiwan, Provinsi China countryTW
Tajikistan countryTJ
Republik Bersatu Tanzania countryTZ
Thailand countryTH
Togo countryTG
Tokelau countryTK
Tonga countryTO
Trinidad dan Tobago countryTT
Tunisia countryTN
Turkiye countryTR
Turkmenistan countryTM
Kepulauan Turks dan Caicos countryTC
Tuvalu countryTV
Uganda countryUG
Ukraina countryUA
Uni Emirat Arab countryAE
Inggris Raya countryUK
Amerika Serikat countryUS
Kepulauan Terluar Kecil Amerika Serikat countryUM
Uruguay countryUY
Uzbekistan countryUZ
Vanuatu countryVU
Venezuela countryVE
Vietnam countryVN
Kepulauan Virgin, Britania Raya countryVG
Kepulauan Virgin, AS countryVI
Wallis dan Futuna countryWF
Sahara Barat countryEH
Yaman countryYE
Yugoslavia countryYU
Zambia countryZM
Zimbabwe countryZW

Kode Negara

Tabel berikut mencantumkan kode negara dua huruf yang dapat digunakan sebagai nilai parameter gl:

Negara Kode Negara
Afganistan af
Albania al
Aljazair dz
Samoa Amerika sebagai
Andorra iklan
Angola ao
Anguila ai
Antarktika aq
Antigua dan Barbuda ag
Argentina ar
Armenia am
Aruba aw
Australia au
Austria at
Azerbaijan az
Bahama bs
Bahrain bh
Bangladesh bd
Barbados bb
Belarus oleh
Belgia be
Belize bz
Benin bj
Bermuda bm
Bhutan bt
Bolivia bo
Bosnia dan Herzegovina ba
Botswana bw
Pulau Bouvet bv
Brasil br
Wilayah Inggris di Samudra Hindia io
Brunei Darussalam bn
Bulgaria bg
Burkina Faso bf
Burundi bi
Kamboja kh
Kamerun cm
Kanada ca
Tanjung Verde cv
Kepulauan Cayman ky
Republik Afrika Tengah cf
Chad td
Cile cl
Cina cn
Pulau Natal cx
Kepulauan Cocos (Keeling) cc
Kolombia co
Komoro km
Kongo cg
Republik Demokratik Kongo cd
Kepulauan Cook ck
Kosta Rika cr
Cote D'ivoire ci
Kroasia jam
Kuba cu
Siprus cy
Republik Ceko cz
Denmark dk
Djibouti DJ
Dominika dm
Republik Dominika do
Ekuador ec
Mesir eg
El Salvador sv
Guinea Ekuatorial gq
Eritrea er
Estonia ee
Etiopia et
Kepulauan Falkland (Malvinas) bercinta
Kepulauan Faroe fo
Fiji fj
Finlandia fi
Prancis fr
Guyana Prancis gf
Polinesia Prancis pf
Teritori Selatan Prancis tf
Gabon ga
Gambia gm
Georgia ge
Jerman de
Ghana gh
Gibraltar gi
Yunani gr
Greenland gl
Grenada gd
Guadeloupe gp
Guam gu
Guatemala gt
Guinea gn
Guinea-Bissau gw
Guyana gy
Haiti HT
Pulau Heard dan Kepulauan McDonald hm
Takhta Suci (Negara Kota Vatikan) va
Honduras hn
Hong Kong hk
Hungaria hu
Islandia -
India di
Indonesia id
Republik Islam Iran ir
Irak IQ
Irlandia ie
Israel il
Italia it
Jamaika jm
Jepang jp
Yordania jo
Kazakhstan kz
Kenya ke
Kiribati ki
Republik Rakyat Demokratik Korea kp
Republik Korea kr
Kuwait kw
Kirgizstan kg
Republik Demokratik Rakyat Laos La
Latvia lv
Lebanon lb
Lesotho ls
Liberia lr
Jamahiryah Arab Libya ly
Liechtenstein li
Lituania lt
Luksemburg lu
Makau bln
Makedonia, Bekas Republik Yugosalv mk
Madagaskar mg
Malawi mw
Malaysia my
Maladewa mv
Mali ml
Malta mt
Kepulauan Marshall mh
Martinik mq
Mauritania mr
Mauritius mu
Mayotte yt
Meksiko mx
Negara Federasi Mikronesia fm
Republik Moldova md
Monako mc
Mongolia mn
Montserrat ms
Maroko ma
Mozambik mz
Myanmar mm
Namibia na
Nauru nr
Nepal np
Belanda nl
Antillen Belanda sebuah
Kaledonia Baru nc
Selandia Baru nz
Nikaragua ni
Niger ne
Nigeria ng
Niue nu
Pulau Norfolk nf
Kepulauan Mariana Utara mp
Norwegia no
Oman om
Pakistan pk
Palau pw
Wilayah Palestina, Terkuasai ps
Panama pa
Papua Nugini hal.
Paraguay py
Peru pe
Filipina ph
Pitcairn pn
Polandia pl
Portugal pt
Puerto Riko pr
Qatar qa
Reunion hal
Rumania ro
Federasi Rusia ru
Rwanda rw
Saint Helena sh
Saint Kitts dan Nevis kn
Saint Lucia lc
Saint Pierre dan Miquelon pm
Saint Vincent dan Grenadines vc
Samoa ws
San Marino sm
Sao Tome dan Príncipe st
Arab Saudi sa
Senegal sn
Serbia dan Montenegro cs
Seychelles sc
Sierra Leone sl
Singapura sg
Slovakia sk
Slovenia si
Kepulauan Solomon sb
Somalia so
Afrika Selatan za
Georgia Selatan dan Kepulauan Sandwich Selatan gs
Spanyol es
Sri Lanka lk
Sudan sd
Suriname sr
Svalbard dan Jan Mayen sj
eSwatini sz
Swedia se
Swiss ch
Republik Arab Suriah sy
Taiwan, Provinsi China tw
Tajikistan tj
Republik Bersatu Tanzania tz
Thailand th
Timor Leste tl
Togo tg
Tokelau tk
Tonga hingga
Trinidad dan Tobago tt
Tunisia tn
Turkiye tr
Turkmenistan tm
Kepulauan Turks dan Caicos tc
Tuvalu tv
Uganda ug
Ukraina ua
Uni Emirat Arab ae
Inggris Raya uk
Amerika Serikat us
Kepulauan Terluar Kecil Amerika Serikat um
Uruguay uy
Uzbekistan uz
Vanuatu vu
Venezuela ve
Vietnam vn
Kepulauan Virgin, Britania Raya vg
Kepulauan Virgin, AS vi
Wallis dan Futuna wf
Sahara Barat eh
Yaman ya
Zambia zm
Zimbabwe zw