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 persimpangan koleksi ke salah satu sisi operator ".".
Contoh

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

Boolean TIDAK [-]
Deskripsi

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

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

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

Catatan: Anda mungkin telah mengetahui bahwa contoh kedua di atas menggunakan operator Boolean AND untuk menentukan bahwa hasilnya 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 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 di kumpulan tersebut di sebelah kiri atau di sebelah kanan pipa ("|").
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 contoh ini menempatkan tanda kurung di lokasi yang berbeda dari kueri sampel untuk operator Boolean AND:
lr=-(lang_fr|lang_it)


Tanda kurung Boolean [()]
Deskripsi

Dengan operator ini, Anda dapat 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 evaluasi berbagai 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 menampilkan permintaan untuk hasil yang tidak ditulis dalam bahasa Prancis Italia. Karena contoh terakhir menggunakan operator OR, bukan operator AND, contoh ini juga harus mengubah lokasi tanda kurung:
lr=-(lang_fr|lang_it)

Escape URL

Untuk membuat permintaan penelusuran HTTP, Anda harus mengikuti konvensi tertentu agar Google dapat menerjemahkan permintaan HTTP 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 khusus: ; / ? : @ = &

Google menggunakan karakter khusus untuk mendekode URL dan menggunakan beberapa karakter khusus untuk meminta fitur penelusuran. Akibatnya, Anda harus meng-escape semua karakter non-alfanumerik dari URL yang muncul dalam nilai parameter penelusuran.

Untuk meng-escape string, konversi setiap urutan karakter spasi kosong menjadi satu tanda "+" (tanda plus) dan ganti karakter non-alfanumerik lainnya dengan encoding heksadesimal yang mewakili nilai karakter tersebut. Encoding heksadesimal untuk karakter khusus dan khusus yang tercantum di atas ditampilkan dalam tabel berikut. Setiap karakter ini harus di-escape dalam URL di 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
= %3 h
& %26
| %7C °C

Contoh

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

Anda dapat menemukan informasi tambahan tentang proses escape 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 algoritme gzip, Anda dapat memperoleh penghematan bandwidth sebesar 50 persen hingga 70 persen, yang dapat meningkatkan waktu respons.

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

Menerima Encoding: gzip

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

Encoding Konten: gzip

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

Perilaku ini ditetapkan dalam standar HTTP. Lihat dokumen itu untuk informasi tambahan tentang penggunaan kompresi gzip HTTP.

Nilai Internasional

Skema Encoding Karakter

Tabel berikut mencantumkan skema encoding karakter yang didukung Google. Anda dapat menetapkan parameter ie dan oe ke salah satu dari dua kolom pertama pada tabel ini. Nilai di kolom pertama adalah nama panggilan untuk skema encoding; nilai di kolom kedua adalah nama standar untuk skema encoding. Google mengembalikan nama standar dalam hasil XML, dan nama standar cocok untuk digunakan pada 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)
simklik ISO-8859-5 Bulgaria, Rusia
arab ISO-8859-6  
yunani ISO-8859-7 Yunani
Ibrrew ISO-8859-8 Ibrani
latin5 ISO-8859-9  
latin6 ISO-8859-10 Islandia
euc-jp EUC-Jepang Jepang
Euc-Kr EUC-KR Korea
Sji Shift_JIS Jepang
big5 Besar5 China Aks. Tradisional
gb GB2312 China Aksara Sederhana
utf8 UTF-8 Semua

Bahasa Antarmuka yang Didukung

Google mendukung lebih dari 80 bahasa. Bahasa antarmuka default-nya adalah bahasa Inggris. Daftar berikut mengidentifikasi semua bahasa antarmuka yang didukung Google.

Bahasa Tampilan Nilai Parameter hl
Afrika af
Albania sq
Amhar sm
Arab ar
Azerbaijan az
Basque eu
Belarusia be
Bengali bn
Bihari bh
Bosnia bs
Bulgaria bg
Katala ca
China (Aksara Sederhana) zh-CN
China (Aksara Tradisional) zh-TW
Kroat jam
Ceko cs
Dansk da
Belanda nl
Inggris en
Esperanto EO
Estonia et
Faroese untuk
Finlandia fi
Prancis fr
Frisia fy
Galisia gl
Georgia ka
Jerman de
Yunani el
Gujarati gu
Ibrani iw
Hindi hi
Hungaria hu
Islandia -
Indonesia id
Interlingua Dia
Irlandia ga
Italia it
Jepang ja
Jawa jw
Kannada kn
Korea ko
Latin La
Latvia lv
Lituania lt
Makedonia mk
Melayu ms
Malayam ml
Malta mt
Marathi mr
Nepal ne
Norwegia tidak
Norwegia (Nynorsk) nn
Occitan ok
Persia fa
Polandia pl
Portugis (Brasil) pt-BR
Portugis (Portugal) pt-PT
Punjabi pa
Rumania ro
Rusia ru
Gaelik Skotlandia gr
Serbia sr
Sinhala si
Slovakia sk
Slovenia sl
Spanyol es
Arab su
Swahili sw
Swedia sv
Tagalog tl
Tamil ta
Telugu te
Thai th
Tigrinya ti
Turki tr
Ukraina uk
Urdu ur
Uzbek uz
Vietnam vi
Wales cy
Xhosa xh
Zulu zu

Nilai Koleksi Bahasa

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

Bahasa Nilai Parameter lr
Arab lang_ar
Bulgaria lang_bg
Katala lang_Ca
China (Aksara Sederhana) lang_zh-CN
China (Aksara Tradisional) lang_zh-TW
Kroasia lang_jam
Ceko lang_cs
Denmark lang_DA
Belanda lang_nl
Inggris lang_id
Estonia bahasa_lang
Finlandia lang_fi
Prancis lang_fr
Jerman lang_de
Yunani lang_el
Ibrani lang_iw
Hungaria lang_hu
Islandia lang_adalah
Indonesia ID_lang
Italia lang_it
Jepang lang_ja
Korea lang_ko
Latvia lang_LV
Lituania lang_lt
Norwegia lang_tidak
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
Turki 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 pedesaan
Aljazair negaraDZ
Samoa Amerika countryAS
Andora negaraAD
Angola negaraAO
Anguila countryAI
Antarktika countryAQ
Antigua dan Barbuda negaraAG
Argentina countryAR
Armenia countryAM
Aruba countryAW
Australia negaraAU
Austria countryAT
Azerbaijan negaraAZ
Bahama countryBS
Bahrain negaraBH
Bangladesh countryBD
Barbados countryBB
Belarus countryBY
Belgia countryBE
Belize negaraBZ
Benin negaraBJ
Bermuda countryBM
Bhutan countryBT
Bolivia countryBO
Bosnia-Herzegovina countryBA
Botswana negaraBW
Pulau Bouvet negaraBV
Brasil countryBR
Wilayah Samudra Hindia Inggris countryIO
Brunei Darussalam negaraBN
Bulgaria negaraBG
Burkina Faso negaraBF
Burundi BI country
Kamboja countryKH
Kamerun countryCM
Kanada countryCA
Tanjung Verde CV negara
Kepulauan Cayman countryKY
Republik Afrika Tengah negaraCF
Chad negaraTD
Cile countryCL
China countryCN
Pulau Natal countryCX
Kepulauan Cocos (Keeling) countryCC
Kolombia negaraCO
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 negaraCZ
Denmark negaraDK
Djibouti DJ negara
Dominika DM country
Republik Dominika countryDO
Timor Leste countryTP
Ekuador negaraEC
Mesir negaraEG
El Salvador countrySV
Guinea Ekuatorial countryGQ
Eritrea countryer
Estonia countryEE
Etiopia countryET
Uni Eropa negaraUni Eropa
Kepulauan Falkland (Malvinas) negaraFK
Kepulauan Faroe negaraFO
Fiji negaraFJ
Finlandia countryFI
Prancis negara
Prancis, Metropolitan negaraFX
Guyana Prancis countryGF
Polinesia Prancis negaraPF
Teritori Selatan Prancis countryTF
Gabon countryGA
Gambia pedesaanGM
Georgia countryGE
Jerman negaraDE
Ghana countryGH
Gibraltar GI negara
Yunani countryGR
Greenland countryGL
Grenada countryGD
Guadeloupe countryGP
Guam pedesaanGU
Guatemala countryGT
Guinea negaraGN
Guinea-Bissau pedesaanGW
Guyana countryGY
Haiti countryHT
Pulau Heard dan Kepulauan McDonald negaraHM
Takhta Suci (Negara Kota Vatikan) countryVA
Honduras negaraHN
Hong Kong negaraHK
Hungaria countryHU
Islandia countryIS
India countryIN
Indonesia countryID
Republik Islam Iran countryIR
Irak countryIQ
Irlandia countryIE
Israel countryIL
Italia countryIT
Jamaika negaraJM
Jepang negaraJP
Yordania negaraJO
Kazakhstan negaraKZ
Kenya countryKE
Kiribati countryKI
Republik Rakyat Demokratik Korea countryKP
Republik Korea countryKR
Kuwait pedesaanKW
Kirgizstan countryKG
Republik Demokratik Rakyat Laos countryLA
Latvia countryLV
Lebanon countryLB
Lesotho countryLS
Liberia countryLR
Jamahiriyah Arab Libya pedesaan
Liechtenstein countryLI
Lituania countryLT
Luksemburg countryLU
Makau countryMO
Makedonia Utara countryMK
Madagaskar MG negara
Malawi negaraMW
Malaysia countryMY
Maladewa countryMV
Mali countryML
Malta countryTT
Kepulauan Marshall negaraMH
Martinik negaraMQ
Mauritania countryMR
Mauritius countryMU
Mayotte countryYT
Meksiko countryMX
Negara Federasi Mikronesia countryFM
Republik Moldova countryMD
Monako countryMC
Mongolia negaraMN
Montserrat countryMS
Maroko countryMA
Mozambik negaraMZ
Myanmar countryMM
Namibia countryNA
Nauru countryNR
Nepal negaraNP
Belanda countryNL
Antilla Belanda countryAN
Kaledonia Baru countryNC
Selandia Baru negaraNZ
Nikaragua countryNI
Niger countryNE
Nigeria countryNG
Niue countryNU
Pulau Norfolk negaraNF
Kepulauan Mariana Utara countryMP
Norwegia negaraNO
Oman countryOM
Pakistan negaraPK
Palau negaraPW
Teritorial Palestina countryPS
Panama countryPA
Papua Nugini countryPG
Paraguay negaraPY
Peru negaraPE
Filipina negaraPH
Pitcairn negaraPN
Polandia countryPL
Portugal negaraPT
Puerto Riko countryPR
Qatar countryQA
Reunion countryRE
Rumania countryRO
Federasi Rusia countryRU
Rwanda pedesaanRW
Saint Helena countrySH
Saint Kitts dan Nevis negaraKN
Saint Lucia countryLC
Saint Pierre dan Miquelon negaraPM
Saint Vincent dan Grenadines countryVC
Samoa countryWS
San Marino countrySM
São Tomé dan Príncipe countryST
Arab Saudi negaraSA
Senegal negaraN
Serbia dan Montenegro countryCS
Seychelles countrySC
Sierra Leone countrySL
Singapura negaraSG
Slovakia countrySK
Slovenia negaraSI
Kepulauan Solomon negaraSB
Somalia countrySO
Afrika Selatan negaraZA
Georgia Selatan dan Kep. Sandwich Selatan countryGS
Spanyol negaraES
Sri Lanka countryLK
Sudan countrySD
Suriname countrySR
Svalbard dan Jan Mayen negaraSJ
eSwatini negaraSZ
Swedia countrySE
Swiss countryCH
Republik Arab Suriah negaraSY
Taiwan, Provinsi China countryTW
Tajikistan negaraTJ
Republik Bersatu Tanzania countryTZ
Thailand countryTH
Togo countryTG
Tokelau countryTK
Tonga pedesaanTO
Trinidad dan Tobago countryTT
Tunisia negaraTN
Turkiye countryTR
Turkmenistan negaraTM
Kepulauan Turks dan Caicos countryTC
Tuvalu countryTV
Uganda countryUG
Ukraina countryUA
Uni Emirat Arab countryAE
Inggris Raya countryUK
Amerika Serikat negara AS
Kepulauan Terluar Kecil Amerika Serikat countryUM
Uruguay countryUY
Uzbekistan negaraUZ
Vanuatu countryVU
Venezuela countryVE
Vietnam negaraVN
Kepulauan Virgin, Britania Raya countryVG
Kepulauan Virgin, AS negaraVI
Wallis dan Futuna negaraWF
Sahara Barat negaraEH
Yaman negaraYE
Yugoslavia negaraYU
Zambia negaraZM
Zimbabwe countryZZ

Kode Negara

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

Negara Kode Negara
Afganistan af
Albania al
Aljazair dz
Samoa Amerika sebagai
Andora iklan
Angola Ao
Anguila ai
Antarktika Aq
Antigua dan Barbuda rata-rata
Argentina ar
Armenia am
Aruba aw
Australia au
Austria pada
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-Herzegovina ba
Botswana mg
Pulau Bouvet bv
Brasil br
Wilayah Samudra Hindia Inggris io
Brunei Darussalam bn
Bulgaria bg
Burkina Faso bf
Burundi dua
Kamboja kh
Kamerun cm
Kanada ca
Tanjung Verde CV
Kepulauan Cayman ky
Republik Afrika Tengah cf
Chad td
Cile cl
China 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) fk
Kepulauan Faroe untuk
Fiji FJ
Finlandia fi
Prancis fr
Guyana Prancis gf
Polinesia Prancis SPF
Teritori Selatan Prancis TT
Gabon ga
Gambia gm
Georgia ge
Jerman de
Ghana gh
Gibraltar gi
Yunani gr
Greenland gl
Grenada gr
Guadeloupe gp
Guam gu
Guatemala gt
Guinea gn
Guinea-Bissau gw
Guyana Gy
Haiti ht
Pulau Heard dan Kepulauan McDonald hmm
Takhta Suci (Negara Kota Vatikan) Va
Honduras hn
Hong Kong hk
Hungaria hu
Islandia -
India in
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
Jamahiriyah Arab Libya ly
Liechtenstein li
Lituania lt
Luksemburg lu
Makau bln
Makedonia Utara mk
Madagaskar mg
Malawi BM
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
Antilla Belanda sebuah
Kaledonia Baru NC
Selandia Baru nz
Nikaragua ni
Niger ne
Nigeria ng
Niue nuk
Pulau Norfolk NF
Kepulauan Mariana Utara mp
Norwegia tidak
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 bls
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 mg
San Marino sm
São Tomé 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 Kep. Sandwich Selatan gr
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 to
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 AS
Kepulauan Terluar Kecil Amerika Serikat um
Uruguay uy
Uzbekistan uz
Vanuatu v
Venezuela ve
Vietnam vn
Kepulauan Virgin, Britania Raya vg
Kepulauan Virgin, AS vi
Wallis dan Futuna wf
Sahara Barat eh
Yaman ya
Zambia z
Zimbabwe ZW