Halaman ini merujuk ke versi XML JSON API Custom Search, yang hanya tersedia untuk Pelanggan Google Penelusuran Situs.
- Ringkasan
- Format Permintaan Programmable Search Engine
- Hasil XML
Ringkasan
Layanan Google WebSearch memungkinkan Google Site Search pelanggan untuk menampilkan hasil penelusuran Google di situs web mereka. Tujuan Layanan WebSearch menggunakan protokol berbasis HTTP sederhana untuk melayani penelusuran hasil pengujian tersebut. Administrator penelusuran memiliki kontrol penuh atas cara mereka meminta hasil penelusuran dan cara hasil tersebut ditampilkan kepada pengguna akhir. Dokumen ini menjelaskan detail teknis Google format permintaan penelusuran dan hasil penelusuran.
Untuk mengambil hasil Google WebSearch, aplikasi Anda akan mengirim permintaan HTTP sederhana ke Google. Google kemudian menampilkan hasil penelusuran dalam XML format font. Hasil berformat XML memberi Anda kemampuan untuk menyesuaikan bagaimana hasil penelusuran ditampilkan.
Format Permintaan WebSearch
- Minta Ringkasan
- Persyaratan Kueri
- Parameter Permintaan
- Contoh Kueri WebSearch
- Kueri WebSearch Definisi Parameter
- Contoh Kueri Gambar
- Kueri Penelusuran Gambar Definisi Parameter
- Penelusuran Lanjutan
- Penelusuran Lanjutan Parameter Kueri
- Persyaratan Kueri Khusus
- Batas Permintaan
Ikhtisar Permintaan
Permintaan penelusuran Google adalah perintah HTTP GET
standar. Ini
berisi kumpulan parameter yang relevan dengan
terhadap kueri. Parameter ini disertakan dalam URL permintaan sebagai name=value
pasangan yang dipisahkan oleh karakter ampersand (&). Parameter mencakup
data seperti kueri penelusuran dan ID mesin unik (cx
) yang mengidentifikasi
yang membuat permintaan HTTP. Layanan WebSearch atau Penelusuran Gambar menampilkan
XML menghasilkan respons terhadap permintaan HTTP Anda.
Persyaratan Kueri
Sebagian besar permintaan penelusuran menyertakan satu atau beberapa istilah kueri. Istilah kueri muncul sebagai nilai parameter dalam permintaan penelusuran.
Istilah kueri dapat menentukan beberapa jenis informasi yang akan difilter dan mengatur hasil penelusuran yang ditampilkan Google. Kueri dapat menentukan:
- Kata atau frasa yang akan disertakan atau
kecuali
- Semua kata dalam kueri penelusuran (default)
- Frasa yang sama persis di kueri penelusuran
- Kata atau frasa apa pun dalam kueri penelusuran
- Lokasi dalam dokumen untuk mencari
istilah penelusuran
- Di mana saja dalam dokumen (default)
- Hanya dalam isi dokumen
- Hanya dalam judul dokumen
- Hanya dalam URL dokumen
- Hanya di link dalam dokumen
- Batasan pada dokumen itu sendiri
- Menyertakan atau mengecualikan dokumen dari jenis file tertentu (seperti file PDF atau dokumen Word)
- Kueri URL khusus yang menampilkan
tentang URL tertentu, daripada melakukan penelusuran
- Kueri yang menampilkan informasi umum tentang URL, seperti kategori, cuplikan, atau bahasa Direktori Terbukanya
- Kueri yang menampilkan kumpulan halaman web yang tertaut ke sebuah URL
- Kueri yang menampilkan kumpulan halaman web yang mirip dengan URL tertentu
Penelusuran Default
Nilai parameter kueri penelusuran harus berupa URL yang di-escape. Perlu diketahui bahwa Anda akan menggantikan tanda plus ("+") untuk setiap urutan spasi kosong pada kueri penelusuran. Hal ini dibahas lebih lanjut di bagian Pelarian URL dalam dokumen ini.
Istilah kueri penelusuran dikirimkan ke layanan WebSearch menggunakan parameter q. J contoh istilah kueri penelusuran adalah:
q=horses+cows+pigs
Secara default, layanan Google WebSearch hanya menampilkan dokumen menyertakan semua istilah dalam kueri pencarian.
Parameter Permintaan
Bagian ini mencantumkan parameter yang dapat Anda gunakan saat membuat permintaan penelusuran. Parameter ini dibagi menjadi dua daftar. Daftar pertama berisi parameter yang relevan dengan semua permintaan penelusuran. Daftar kedua berisi parameter yang adalah hanya relevan dengan permintaan penelusuran lanjutan.
Tiga parameter permintaan diperlukan:
- Parameter client harus ditetapkan ke
google-csbe
- Parameter output menentukan
format hasil XML yang dikembalikan; hasil dapat ditampilkan dengan (xml)
atau tanpa (
xml_no_dtd
) referensi ke DTD Google. Saran dari kami menetapkan nilai ini kexml_no_dtd
. Catatan: Jika Anda tidak menentukan parameter ini, hasilnya akan ditampilkan dalam HTML bukan XML.
- Parameter cx yang mewakili
ID mesin telusur.
Parameter permintaan yang paling umum digunakan selain yang yang disebutkan di atas adalah:
Contoh Kueri WebSearch
Contoh di bawah ini menunjukkan beberapa permintaan HTTP WebSearch untuk menggambarkan bagaimana parameter kueri yang berbeda digunakan. Definisi untuk parameter kueri yang berbeda disediakan dalam Kueri WebSearch Definisi Parameter dan Kueri Penelusuran Lanjutan Parameter dalam dokumen ini.
Permintaan ini meminta 10 hasil pertama (start=0&num=10
)
untuk istilah kueri "red sox" (q=red+sox
). Kueri juga
menentukan bahwa hasil harus berasal dari situs web Kanada (cr=countryCA
)
dan harus ditulis dalam bahasa Prancis (lr=lang_fr
). Terakhir, kueri
menentukan nilai untuk client, output,
dan parameter cx, yang ketiganya diperlukan.
http://www.google.com/search?
start=0
&num=10
&q=red+sox
&cr=countryCA
&lr=lang_fr
&client=google-csbe
&output=xml_no_dtd
&cx=00255077836266642015:u-scht7a-8i
Contoh ini menggunakan beberapa kueri penelusuran lanjutan
parameter untuk menyesuaikan kueri penelusuran lebih lanjut. Permintaan ini menggunakan as_q
parameter (as_q=red+sox
), bukan parameter q. Model ini juga menggunakan
as_eq untuk mengecualikan dokumen yang berisi kata "Yankees" dari
hasil penelusuran (as_eq=yankees
).
http://www.google.com/search?
start=0
&num=10
&as_q=red+sox
&as_eq=Yankees
&client=google-csbe
&output=xml_no_dtd
&cx=00255077836266642015:u-scht7a-8i
Definisi Parameter Kueri WebSearch
c2coff | |||||||
---|---|---|---|---|---|---|---|
Deskripsi | Opsional. Parameter c2coff mengaktifkan atau menonaktifkan fungsi Menyederhanakan dan Penelusuran China Aksara Tradisional. Nilai default untuk parameter ini adalah
|
||||||
Contoh | q=google&c2coff=1 |
klien | |
---|---|
Deskripsi | Wajib diisi. Parameter |
Contoh | q=google&client=google-csbe |
cr | |
---|---|
Deskripsi | Opsional. Parameter Google WebSearch menentukan negara dokumen dengan menganalisis:
Lihat Parameter Negara (cr) Nilai untuk daftar nilai yang valid untuk parameter ini. |
Contoh | q=Frodo&cr=countryNZ |
CX | |
---|---|
Deskripsi | Wajib diisi. Parameter |
Contoh | q=Frodo&cx=00255077836266642015:u-scht7a-8i |
filter | |||||||
---|---|---|---|---|---|---|---|
Deskripsi | Opsional. Parameter filter mengaktifkan atau menonaktifkan pemfilteran otomatis hasil penelusuran Google. Lihat bagian Pemfilteran Otomatis dokumen untuk informasi lebih lanjut tentang filter hasil penelusuran Google. Nilai default untuk parameter
Catatan: Secara default, Google menerapkan pemfilteran ke semua hasil penelusuran untuk meningkatkan kualitas hasil tersebut. |
||||||
Contoh | q=google&filter=0 |
gl | |
---|---|
Deskripsi | Opsional. Nilai parameter Menentukan nilai parameter |
Contoh | Permintaan ini akan meningkatkan dokumen yang ditulis di Inggris Raya dalam
Hasil Penelusuran Web: |
hl | |
---|---|
Deskripsi | Opsional. Parameter Lihat bagian Bahasa Antarmuka pada Internasionalisasi Kueri dan Presentasi Hasil untuk mengetahui informasi lebih lanjut serta Bahasa Antarmuka yang Didukung untuk mengetahui daftar bahasa yang didukung. |
Contoh | Permintaan ini menargetkan iklan untuk anggur dalam bahasa Prancis. (Vin adalah adalah istilah Prancis untuk wine.) q=vin&ip=10.10.10.10&ad=w5&hl=fr |
hq | |
---|---|
Deskripsi | Opsional. Parameter |
Contoh | Permintaan ini menelusuri 'pizza' DAN 'keju'. Ekspresinya sama dengan
|
ie | |
---|---|
Deskripsi | Opsional. Parameter Lihat bagian Encoding Karakter untuk diskusi tentang kapan Anda perlu menggunakan parameter ini. Lihat Encoding Karakter
Schemes untuk daftar kemungkinan nilai |
Contoh | q=google&ie=utf8&oe=utf8 |
lr | |
---|---|
Deskripsi | Opsional. Parameter Google WebSearch menentukan bahasa dokumen dengan menganalisis:
Lihat bagian Bahasa ( |
Contoh | q=Frodo&lr=lang_en |
angka | |
---|---|
Deskripsi | Opsional. Parameter Nilai Catatan: Jika jumlah total hasil penelusuran kurang daripada jumlah hasil yang diminta, semua hasil penelusuran yang tersedia akan dikembalikan. |
Contoh | q=google&num=10 |
oe | |
---|---|
Deskripsi | Opsional. Parameter Lihat bagian Encoding Karakter untuk diskusi tentang kapan Anda perlu menggunakan parameter ini. Lihat Encoding Karakter
Schemes untuk daftar kemungkinan nilai |
Contoh | q=google&ie=utf8&oe=utf8 |
hasil | |||||||
---|---|---|---|---|---|---|---|
Deskripsi | Wajib diisi. Parameter
|
||||||
Contoh | output=xml_no_dtd |
q | |
---|---|
Deskripsi | Opsional. Parameter Ada juga sejumlah istilah kueri
khusus yang dapat
digunakan sebagai bagian dari parameter Panel Kontrol Google Penelusuran menyertakan laporan dari
kueri yang dikirimkan menggunakan parameter Catatan: Nilai yang ditentukan untuk parameter q harus di-escape URL. |
Contoh | q=vacation&as_oq=london+paris |
aman | |||||||||
---|---|---|---|---|---|---|---|---|---|
Deskripsi | Opsional. Parameter
Lihat artikel Memfilter Konten Khusus Dewasa dengan SafeSearch untuk mengetahui detail selengkapnya tentang fitur ini. |
||||||||
Contoh | q=adult&safe=high |
mulai | |
---|---|
Deskripsi | Opsional. Parameter Parameter |
Contoh | start=10 |
mengurutkan | |
---|---|
Deskripsi | Opsional. Parameter |
Contoh |
|
ud | |
---|---|
Deskripsi | Opsional. Parameter http://www.花井鮨.com Nilai yang valid untuk parameter ini adalah Jika parameter http://www.xn--elq438j.com. Catatan: Fitur ini adalah fitur beta. |
Contoh | q=google&ud=1 |
Penelusuran Lanjutan
Parameter kueri tambahan yang tercantum di bawah gambar relevan dengan kueri penelusuran lanjutan. Saat Anda melakukan penelusuran lanjutan, nilai beberapa parameter (mis. as_eq, as_epq, as_oq, dll.) semuanya diperhitungkan dalam kueri istilah untuk penelusuran tersebut. Gambar menampilkan halaman Penelusuran Lanjutan Google. Pada gambar, nama masing-masing Parameter penelusuran lanjutan ditulis dalam teks merah di dalam atau di samping bidang pada halaman yang sesuai dengan parameter tersebut.
![](https://services.google.com/images/as_examples/advanced_search.jpg?authuser=8&hl=id)
Parameter Kueri Penelusuran Lanjutan
as_dt | |
---|---|
Deskripsi | Opsional. Parameter |
Contoh | as_dt=i,as_dt=e |
as_epq | |
---|---|
Deskripsi | Opsional. Parameter |
Contoh | as_epq=abraham+lincoln |
as_eq | |
---|---|
Deskripsi | Opsional. Parameter |
Contoh |
|
as_lq | |
---|---|
Deskripsi | Opsional. Parameter |
Contoh |
|
as_nlo | |
---|---|
Deskripsi | Opsional. Parameter |
Contoh | Parameter berikut menetapkan rentang penelusuran dari 5 hingga 10, inklusif:
|
as_nhi | |
---|---|
Deskripsi | Opsional. Parameter |
Contoh | Parameter berikut menetapkan rentang penelusuran dari 5 hingga 10, inklusif:
|
as_oq | |
---|---|
Deskripsi | Opsional. Parameter |
Contoh |
|
as_q | |
---|---|
Deskripsi | Opsional. Parameter |
Contoh |
|
as_qdr | |
---|---|
Deskripsi | Opsional. Parameter
|
Contoh |
Contoh ini meminta hasil dari tahun lalu:
Contoh ini meminta hasil dari 10 hari terakhir:
|
as_sitesearch | |
---|---|
Deskripsi | Opsional. Parameter |
Contoh |
|
Istilah Kueri Khusus
Google WebSearch memungkinkan penggunaan beberapa istilah kueri khusus yang
mengakses kemampuan tambahan mesin telusur Google. Ini
istilah kueri khusus harus disertakan dalam nilai parameter permintaan q. Seperti istilah kueri lainnya,
istilah kueri khusus harus di-escape URL. J
jumlah istilah kueri khusus berisi tanda titik dua (:). Karakter ini
juga harus di-escape URL; nilai URL yang di-escape adalah %3A
.
Link Kembali [link:] | |
---|---|
Deskripsi | Istilah kueri Versi Anda juga dapat menggunakan permintaan as_lq
untuk mengirim permintaan Catatan: Anda tidak dapat menentukan istilah kueri lainnya jika
menggunakan |
Contoh |
|
Boolean ATAU Penelusuran [ ATAU ] | |
---|---|
Deskripsi | Istilah kueri Anda juga dapat menggunakan permintaan as_oq untuk mengirim penelusuran istilah apa pun dalam sekumpulan istilah. Catatan: Jika permintaan penelusuran menentukan kueri "London+OR+Paris", hasil penelusuran akan mencakup dokumen yang berisi setidaknya salah satu dari dua kata tersebut. Dalam beberapa kasus, dokumen dalam hasil penelusuran mungkin berisi kedua kata tersebut. |
Contoh | Telusuri London atau Paris: Input pengguna:
london OR
paris Istilah kueri:q=london+OR+paris Telusuri tempat liburan dan London atau Paris: Istilah kueri:
q=vacation+london+OR+paris Telusuri liburan dan salah satu dari London, Paris, atau cokelat: Istilah kueri:
q=vacation+london+OR+paris+OR+chocolates Mencari liburan dan cokelat serta london atau paris, dengan bobot terendah yang diberikan untuk cokelat: Istilah kueri:
q=vacation+london+OR+paris+chocolates Mencari liburan, cokelat, dan bunga dalam dokumen yang juga berisi London atau Paris: Istilah kueri:
q=vacation+london+OR+paris+chocolates+flowers Cari liburan dan salah satu dari London atau Paris dan juga telusuri untuk salah satu cokelat atau bunga: Istilah kueri: q=vacation+london+OR+paris+chocolates+OR+flowers |
Kecualikan Istilah Kueri [-] | |
---|---|
Deskripsi | Istilah kueri yang dikecualikan ( Versi Istilah kueri yang dikecualikan berguna saat istilah penelusuran memiliki dari satu arti. Misalnya, kata "bass" dapat menampilkan hasil tentang ikan atau musik. Jika Anda mencari dokumen tentang ikan, Anda dapat mengecualikan dokumen tentang musik dari hasil penelusuran menggunakan istilah kueri pengecualian. Anda juga dapat menggunakan permintaan as_eq parameter untuk mengecualikan dokumen yang cocok dengan kata atau frasa tertentu dari hasil penelusuran. |
Contoh | Input pengguna: bass -music Istilah kueri: q=bass+%2Dmusic |
Pengecualian Jenis File [ {i>-filetype<i}: ] | |
---|---|
Deskripsi | Istilah kueri Versi Catatan: Anda dapat mengecualikan beberapa
jenis file dari hasil penelusuran dengan menambahkan lebih banyak kueri Jenis file yang didukung oleh Google meliputi:
Jenis file lainnya dapat ditambahkan di masa mendatang. Terbaru daftar ini dapat ditemukan di FAQ jenis file Google. |
Contoh | Contoh ini menampilkan dokumen yang menyebutkan "Google" tapi itu
bukan dokumen PDF: Contoh ini menampilkan dokumen yang menyebutkan "Google" tapi
tidak termasuk dokumen PDF dan Word: |
Pemfilteran Jenis File [ filetype: ] | |
---|---|
Deskripsi | Istilah kueri Versi Anda dapat membatasi penelusuran
hasil ke dokumen yang cocok dengan salah satu
dari beberapa ekstensi file dengan menambahkan
Secara default, hasil penelusuran akan sertakan dokumen dengan ekstensi file apa pun. Jenis file yang didukung oleh Google meliputi:
Jenis file lainnya dapat ditambahkan di masa mendatang. Terbaru daftar ini dapat ditemukan di FAQ jenis file Google. |
Contoh | Contoh ini menampilkan dokumen PDF yang menyebutkan "Google": Contoh ini menampilkan dokumen PDF dan Word yang menyebutkan
"Google": |
Sertakan Istilah Kueri [+] | |
---|---|
Deskripsi | Istilah kueri include (+) menentukan bahwa sebuah kata atau frasa harus muncul di semua dokumen yang disertakan dalam hasil penelusuran. Untuk menggunakan menyertakan istilah kueri, Anda akan mengawali kata atau frasa yang harus disertakan dalam semua hasil penelusuran dengan "+" (tanda plus). Versi Sebaiknya Anda menggunakan |
Contoh | Input pengguna: Star Wars Episode +I Istilah kueri: q=Star+Wars+Episode+%2BI |
Penelusuran Hanya Link, semua persyaratan [ allinlinks: ] | |
---|---|
Deskripsi | Istilah kueri Jika kueri penelusuran Anda menyertakan kueri Versi |
Contoh | Input pengguna:allinlinks: Google search Istilah kueri: q=allinlinks%3A+Google+search |
Penelusuran Frasa | |
---|---|
Deskripsi | Istilah kueri penelusuran frasa (") memungkinkan Anda menelusuri frasa lengkap dengan mengapit frasa dengan tanda kutip atau dengan menghubungkannya dengan tanda hubung. Versi Penelusuran frasa sangat berguna jika Anda menelusuri untuk kutipan terkenal atau nama diri. Anda juga dapat menggunakan permintaan as_epq untuk mengirimkan penelusuran frasa. |
Contoh | Input pengguna:"Abraham Lincoln" Istilah kueri: q=%22Abraham+Lincoln%22 |
Penelusuran Hanya Teks, semua istilah [allintext:] | |
---|---|
Deskripsi | Istilah kueri Jika kueri penelusuran Anda menyertakan kueri Versi |
Contoh | Contoh ini menentukan bahwa kata
"Google" dan "telusuri" harus muncul di isi semua dokumen yang disertakan
dalam hasil penelusuran: Input pengguna: allintext:Google search Istilah kueri: q=allintext%3AGoogle+search |
Penelusuran Judul, istilah tunggal [intitle:] | |
---|---|
Deskripsi | Istilah kueri Catatan: Anda dapat menentukan lebih banyak
dari satu kata yang harus disertakan
dalam judul dokumen dengan
istilah kueri Versi |
Contoh | Contoh ini menunjukkan bahwa kata "Google" harus muncul di
judul dokumen apa pun dalam hasil pencarian, dan kata
"telusuri" harus muncul di mana saja di judul, URL, link, atau teks isi
dari dokumen tersebut: |
Penelusuran Judul, semua istilah [allintitle:] | |
---|---|
Deskripsi | Istilah kueri Catatan: Menempatkan Versi |
Contoh | Contoh ini menunjukkan bahwa kata "Google" dan "telusuri"
harus muncul di judul dokumen apa pun di hasil penelusuran: |
Penelusuran URL, istilah tunggal [inurl:] | |
---|---|
Deskripsi | Istilah kueri Kueri Versi |
Contoh | Contoh ini menunjukkan bahwa kata "Google" harus muncul di
URL dari dokumen apa pun dalam hasil penelusuran, dan kata "telusuri"
harus muncul di mana pun pada judul, URL, link, atau teks isi
dokumen: |
Penelusuran URL, semua istilah [allinurl:] | |
---|---|
Deskripsi | Istilah kueri Istilah kueri Versi |
Contoh | Contoh ini menunjukkan bahwa kata "Google" dan "telusuri"
harus muncul di URL dokumen apa pun di hasil penelusuran: |
Info Dokumen Web [info:] | |
---|---|
Deskripsi | Istilah kueri Versi Catatan: Anda tidak dapat menentukan istilah kueri lainnya jika
menggunakan |
Contoh | Input pengguna: info:www.google.com Istilah kueri: q=info%3Awww.google.com |
Contoh Kueri Gambar
Contoh di bawah ini menunjukkan beberapa permintaan HTTP Gambar untuk mengilustrasikan bagaimana parameter kueri yang berbeda digunakan. Definisi untuk berbagai parameter kueri diberikan di bagian Definisi Parameter Kueri Gambar dalam dokumen ini.
Permintaan ini meminta 5 hasil pertama (start=0&num=5
) untuk istilah kueri "monyet" (q=monkey
), dengan jenis file .png. Terakhir, kueri menentukan nilai untuk parameter client
, output
, dan cx
, yang ketiganya diperlukan.
http://www.google.com/cse? searchtype=image start=0 &num=5 &q=monkey &as_filetype=png &client=google-csbe &output=xml_no_dtd &cx=00255077836266642015:u-scht7a-8i
Parameter Kueri Penelusuran Gambar
as_filetype | |
---|---|
Deskripsi | Opsional. Menampilkan gambar dari jenis tertentu. Nilai yang diizinkan adalah: |
Contoh | q=google&as_filetype=png |
imgsz | |
---|---|
Deskripsi | Opsional. Menampilkan gambar dengan ukuran tertentu, dengan ukuran dapat berupa salah satu dari:
|
Contoh | q=google&as_filetype=png&imgsz=icon |
{i>imgtype<i} | |
---|---|
Deskripsi | Opsional. Menampilkan gambar jenis, yang dapat berupa salah satu dari:
|
Contoh | q=google&as_filetype=png&imgtype=photo |
imgc | |
---|---|
Deskripsi | Opsional. Menampilkan gambar hitam putih, hitam putih, atau berwarna:
|
Contoh | q=google&as_filetype=png&imgc=gray |
imgcolor | |
---|---|
Deskripsi | Opsional. Menampilkan gambar dengan warna dominan tertentu:
|
Contoh | q=google&as_filetype=png&imgcolor=yellow |
as_rights | |
---|---|
Deskripsi | Opsional. Filter berdasarkan pemberian lisensi. Nilai yang didukung meliputi:
|
Contoh | q=cats&as_filetype=png&as_rights=cc_attribute |
Batas Permintaan
Diagram di bawah ini mencantumkan batasan terkait permintaan penelusuran yang kirim ke Google:
Komponen | Batas | Komentar |
---|---|---|
Panjang permintaan penelusuran | 2048 byte | |
Jumlah istilah kueri | 10 | mencakup istilah dalam parameter berikut: q, as_epq, as_eq, as_lq, as_oq, as_q |
Jumlah hasil | 20 | Jika Anda menetapkan parameter num ke angka yang lebih besar dari 20, hanya 20 hasil yang ditampilkan. Kepada mendapatkan lebih banyak hasil, Anda harus mengirim beberapa permintaan dan tambahkan nilai parameter start dengan setiap permintaan. |
Menginternasionalkan Kueri dan Presentasi Hasil
Layanan Google WebSearch memungkinkan Anda mencari dokumen dalam beberapa bahasa. Anda dapat menentukan pengkodean karakter yang seharusnya digunakan untuk menafsirkan permintaan HTTP Anda dan untuk mengenkode respons XML Anda (menggunakan penelusuran ie dan oe ). Anda juga dapat memfilter hasil agar hanya menyertakan dokumen yang ditulis dalam bahasa tertentu.
Bagian berikut membahas masalah yang terkait dengan penelusuran di beberapa bahasa:
Pengkodean Karakter
Server mengirim data, seperti halaman web, ke agen pengguna, seperti {i>browser<i}, sebagai urutan byte yang dienkode. Agen pengguna kemudian mendekode {i>byte<i} menjadi urutan karakter. Saat mengirim permintaan ke WebSearch, Anda dapat menentukan skema encoding untuk dan untuk respons XML yang diterima.
Anda dapat menggunakan parameter permintaan ie untuk menentukan
mekanisme penyandian data untuk karakter
dalam permintaan HTTP Anda. Anda dapat
gunakan juga parameter oe untuk menentukan encoding
skema yang harus digunakan Google untuk mengenkode respons XML Anda. Jika Anda
menggunakan skema encoding selain ISO-8859-1
(atau latin1
), pastikan Anda telah menentukan nilai yang benar
untuk parameter ie dan oe.
Catatan: Jika Anda menyediakan fungsi penelusuran untuk beberapa
sebaiknya gunakan nilai encoding utf8
(UTF-8)
untuk parameter ie dan oe.
Silakan lihat Karakter Lampiran Skema Encoding untuk daftar lengkap nilai yang yang dapat Anda gunakan untuk parameter ie dan oe.
Untuk informasi umum lebih lanjut tentang encoding karakter, lihat http://www.w3.org/TR/REC-html40/charset.html.
Bahasa Antarmuka
Anda dapat menggunakan parameter permintaan hl untuk mengidentifikasi bahasa antarmuka grafis. Nilai parameter hl dapat memengaruhi hasil penelusuran XML, terutama pada kueri internasional jika pembatasan bahasa (menggunakan parameter lr) tidak ditentukan secara eksplisit. Dengan demikian kasus, parameter hl dapat mempromosikan hasil penelusuran dalam bahasa yang sama dengan bahasa input pengguna.
Sebaiknya tetapkan parameter hl secara eksplisit di hasil penelusuran untuk memastikan bahwa Google memilih kualitas tertinggi hasil penelusuran untuk setiap kueri.
Lihat Antarmuka yang Didukung Bahasa untuk mengetahui daftar lengkap nilai yang valid untuk parameter hl.
Mencari Dokumen yang Tertulis dalam Bahasa Tertentu
Anda dapat menggunakan parameter permintaan lr untuk membatasi hasil penelusuran pada dokumen yang ditulis dalam bahasa atau sekumpulan bahasa.
Parameter lr mendukung Operator Boolean untuk memungkinkan Anda menentukan beberapa bahasa yang harus disertakan (atau dikecualikan) dari penelusuran hasil pengujian tersebut.
Contoh berikut menunjukkan bagaimana Anda dapat menggunakan Operator Boolean untuk meminta dokumen di bahasa yang berbeda.
Untuk dokumen yang ditulis dalam bahasa Jepang:
lr=lang_jp
Untuk dokumen yang ditulis dalam bahasa Italia atau Jerman:
lr=lang_it|lang_de
Untuk dokumen yang tidak ditulis dalam bahasa Hungaria atau Ceko:
lr=(-lang_hu).(-lang_cs)
Lihat Koleksi Bahasa Bagian Values untuk daftar lengkap nilai yang mungkin untuk parameter lr dan Boolean Operator untuk diskusi lengkap tentang penggunaan operator.
Penelusuran China Aksara Sederhana dan Tradisional
China Aksara Sederhana dan China Aksara Tradisional adalah dua varian tulisan berbahasa China. Konsep yang sama dapat ditulis secara berbeda dalam setiap varian. Dengan kueri di salah satu variannya, Google Layanan WebSearch dapat menampilkan hasil yang menyertakan halaman dalam pada semua varian.
Untuk menggunakan fitur ini:
- Setel parameter permintaan c2coff ke 0
dan - Lakukan salah satu hal berikut:
Contoh berikut menunjukkan parameter kueri yang akan Anda sertakan dalam permintaan hasil dalam bahasa China Aksara Sederhana dan Tradisional. (Perhatikan bahwa informasi tambahan yang diperlukan, seperti sebagai klien, tidak disertakan dalam contoh.)
search?hl=zh-CN &lr=lang_zh-TW|lang_zh-CN &c2coff=0
Memfilter Hasil
Google WebSearch menyediakan sejumlah cara untuk memfilter penelusuran hasil:
- Otomatis Pemfilteran Hasil Penelusuran
- Pemfilteran Bahasa dan Negara
- Memfilter Konten Khusus Dewasa dengan SafeSearch
Pemfilteran Otomatis Hasil Penelusuran
Dalam upaya untuk memberikan hasil penelusuran terbaik, Google menggunakan dua teknik untuk secara otomatis memfilter hasil penelusuran yang umumnya dianggap tidak diinginkan:
-
Konten Duplikat—Jika beberapa dokumen berisi informasi yang sama, maka hanya dokumen paling relevan dari kumpulan tersebut yang disertakan dalam hasil penelusuran Anda.
-
Host Crowding—Jika ada banyak hasil penelusuran dari situs yang sama, Google mungkin tidak menampilkan semua hasil dari situs tersebut atau mungkin tampilkan hasil yang lebih rendah di
peringkat daripada yang seharusnya.
Sebaiknya biarkan filter ini aktif untuk permintaan penelusuran umum karena filter tersebut meningkatkan kualitas sebagian besar konten penelusuran secara signifikan hasil pengujian tersebut. Namun, Anda dapat mengabaikan filter otomatis ini dengan menetapkan parameter kueri filter ke 0 di kolom permintaan penelusuran.
Pemfilteran Bahasa dan Negara
Layanan Google WebSearch mengembalikan hasil dari indeks master berupa semua dokumen Web. Indeks master berisi subkoleksi dari dokumen yang dikelompokkan menurut atribut tertentu, termasuk bahasa dan negara asal.
Anda dapat menggunakan parameter permintaan lr dan cr untuk membatasi hasil penelusuran ke subkoleksi dari dokumen yang ditulis dalam bahasa tertentu atau berasal dari negara tertentu.
Google WebSearch menentukan bahasa dokumen dengan menganalisis:
- domain level teratas (TLD) dari URL dokumen
- tag meta bahasa dalam dokumen
- bahasa utama yang digunakan dalam teks isi dokumen
Lihat juga definisi parameter lr, bagian Menelusuri
Dokumen yang Ditulis dalam Bahasa Tertentu dan Nilai Pengumpulan Bahasa yang dapat
digunakan sebagai nilai untuk parameter lr untuk mengetahui
informasi tentang cara membatasi hasil berdasarkan bahasa.
Google WebSearch menentukan negara dokumen dengan menganalisis:
- domain level teratas (TLD) dari URL dokumen
- lokasi geografis dari alamat IP server web
Lihat juga definisi parameter cr dan Pengumpulan Negara Nilai yang dapat digunakan sebagai nilai untuk parameter cr guna mendapatkan informasi selengkapnya tentang cara membatasi hasil berdasarkan negara tempat asal.
Catatan: Anda dapat menggabungkan bahasa dan nilai negara untuk menyesuaikan hasil penelusuran Anda. Sebagai misalnya, Anda dapat meminta dokumen yang ditulis dalam bahasa Prancis dan berasal dari Prancis atau Kanada, atau Anda dapat meminta dokumen yang datang dari Holland dan tidak ditulis dalam bahasa Inggris. Parameter lr dan cr mendukung Operator Boolean.
Memfilter Konten Khusus Dewasa dengan SafeSearch
Banyak pelanggan Google yang tidak ingin menampilkan hasil penelusuran untuk situs yang berisi konten khusus dewasa. Dengan menggunakan filter SafeSearch kami, Anda dapat menyaring untuk hasil penelusuran yang berisi konten khusus dewasa dan menghapusnya. Filter Google menggunakan teknologi eksklusif untuk memeriksa kata kunci dan frasa dan URL. Meskipun tidak ada filter yang akurat 100 persen, SafeSearch akan menghapus sebagian besar konten khusus dewasa dari penelusuran Anda hasil pengujian tersebut.
Google berusaha menjaga SafeSearch tetap terbaru dan komprehensif bisa dilakukan dengan terus meng-crawl Web dan menggabungkan update dari saran pengguna.
SafeSearch tersedia dalam bahasa berikut:
Belanda Inggris Prancis Jerman |
Italia Portugis (Brasil) Spanyol China Aksara Tradisional |
Anda dapat menyesuaikan sejauh mana Google memfilter hasil Anda konten khusus dewasa menggunakan parameter kueri safe. Tabel berikut menjelaskan setelan SafeSearch Google dan bagaimana setelan tersebut setelan akan memengaruhi hasil penelusuran Anda:
Level SafeSearch | Deskripsi |
---|---|
tinggi | Mengaktifkan versi yang lebih ketat tentang SafeSearch. |
sedang | Memblokir laman web yang berisi pornografi dan konten seksual vulgar lainnya. |
nonaktif | Tidak memfilter konten dewasa konten dari hasil penelusuran. |
* Setelan SafeSearch default adalah nonaktif.
Jika Anda telah mengaktifkan SafeSearch dan Anda menemukan situs yang berisi konten menyinggung di hasil Anda, kirimkan URL situs melalui email ke safesearch@google.com, dan kami akan menyelidiki situs tersebut.
Hasil XML
- XML Google DTD hasil
- Tentang Respons XML
- XML Hasil untuk Kueri Penelusuran Reguler dan Lanjutan
- Penelusuran Reguler/Lanjutan: Contoh Kueri dan Hasil XML
- Penelusuran Reguler/Lanjutan: Tag XML
DTD Hasil XML Google
Google menggunakan DTD yang sama untuk mendeskripsikan format XML untuk semua jenis hasil penelusuran. Banyak tag dan atribut berlaku untuk semua jenis penelusuran. Namun, beberapa tag hanya berlaku untuk jenis penelusuran. Akibatnya, definisi dalam DTD mungkin kurang membatasi dari definisi yang diberikan dalam dokumen ini.
Dokumen ini menjelaskan aspek-aspek DTD yang relevan untuk WebSearch. Saat Anda melihat DTD, jika Anda sedang mengerjakan WebSearch, Anda dapat mengabaikan tag dan atribut yang tidak didokumentasikan di sini. Jika definisinya berbeda antara DTD dan dokumentasi, fakta tersebut dicatat dalam dokumen ini.
Google dapat menampilkan hasil XML dengan atau tanpa referensi ke DTD terbaru. DTD adalah panduan untuk membantu administrator penelusuran dan parser XML memahami hasil XML Google. Karena XML Google tata bahasa dapat berubah dari waktu ke waktu, Anda sebaiknya tidak mengonfigurasi menggunakan DTD untuk memvalidasi setiap hasil XML.
Selain itu, Anda tidak boleh mengonfigurasi parser XML untuk mengambil DTD setiap kali Anda mengirimkan permintaan penelusuran. Google memperbarui DTD jarang, dan permintaan ini menimbulkan penundaan dan {i>bandwidth<i} yang tidak perlu lainnya.
Google merekomendasikan agar Anda menggunakan format output xml_no_dtd untuk mendapatkan hasil XML. Jika Anda menentukan format output xml dalam permintaan penelusuran, satu-satunya perbedaan adalah penyertaan baris berikut dalam hasil XML:
<!DOCTYPE GSP SYSTEM "google.dtd">
Anda dapat mengakses DTD terbaru di http://www.google.com/google.dtd.
Perlu diketahui bahwa tidak semua fitur di DTD dapat tersedia atau didukung saat ini.
Tentang Respons XML
- Semua nilai elemen adalah HTML valid yang cocok untuk ditampilkan kecuali dinyatakan lain dalam definisi tag XML.
- Beberapa nilai elemen adalah URL yang harus dienkode dengan HTML sebelum kolom tersebut ditampilkan.
- Parser XML Anda harus mengabaikan atribut dan tag yang tidak terdokumentasi. Hal ini memungkinkan aplikasi Anda terus berfungsi tanpa modifikasi jika Google menambahkan lebih banyak fitur ke output XML.
- Karakter tertentu harus di-escape saat disertakan sebagai nilai dalam
Tag XML. Prosesor XML Anda harus mengonversi entitas ini kembali ke
karakter yang sesuai. Jika Anda tidak mengonversi entity dengan benar,
browser dapat, misalnya, merender & karakter sebagai "&".
Elemen XML
Standard mendokumentasikan karakter-karakter ini; karakter-karakter ini
direproduksi dalam tabel di bawah:
Karakter Formulir yang Di-escape Entitas Kode Karakter Ampersand & & & Petik Satu ' ' ' Petik Dua " " " Lebih Dari > > > Kurang Dari < < <
Hasil XML untuk Kueri Penelusuran Reguler dan Lanjutan
Penelusuran Reguler/Lanjutan: Contoh Kueri dan Hasil XML
Contoh permintaan WebSearch ini meminta 10 hasil (num=10
)
tentang istilah penelusuran "socer" (q=socer
), yang merupakan kata
"sepak bola" sengaja dieja salah untuk contoh ini.)
http://www.google.com/search?
q=socer
&hl=en
&start=10
&num=10
&output=xml
&client=google-csbe
&cx=00255077836266642015:u-scht7a-8i
Permintaan ini akan memberikan hasil XML di bawah. Perhatikan bahwa ada beberapa komentar dalam hasil XML untuk menunjukkan di mana tag tertentu disertakan dalam hasil.
<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?>
<GSP VER="3.2">
<TM>0.452923</TM>
<Q>socer</Q>
<PARAM name="cx" value="00255077836266642015:u-scht7a-8i" original_value="00255077836266642015%3Au-scht7a-8i"/>
<PARAM name="hl" value="en" original_value="en"/>
<PARAM name="q" value="socer" original_value="socer"/>
<PARAM name="output" value="xml" original_value="xml"/>
<PARAM name="client" value="google-csbe" original_value="google-csbe"/>
<PARAM name="num" value="10" original_value="10"/>
<Spelling>
<Suggestion q="soccer"><b><i>soccer</i></b></Suggestion>
</Spelling>
<Context>
<title>Sample Vacation CSE</title>
<Facet>
<FacetItem>
<label>restaurants</label>
<anchor_text>restaurants</anchor_text>
</FacetItem>
<FacetItem>
<label>wineries</label>
<anchor_text>wineries</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>golf_courses</label>
<anchor_text>golf courses</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>hotels</label>
<anchor_text>hotels</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>nightlife</label>
<anchor_text>nightlife</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>soccer_sites</label>
<anchor_text>soccer sites</anchor_text>
</FacetItem>
</Facet>
</Context>
<RES SN="1" EN="10">
<M>6080</M>
/*
* The FI tag after the comment indicates that the result
* set has been filtered. If the number of results were exact, the
* FI tag would be replaced by an XT tag in the same format.
*/
<FI />
<NB>
/*
* Since the request is for the first page of results, the PU tag,
* which contains a link to the previous page of search results,
* is not included in this XML result. If the sample result did include
* a previous page of results, it would be listed here, in the same format
* as the NU tag on the following line
*/
<NU>/search?q=socer&hl=en&lr=&ie=UTF-8&output=xml&client=test&start=10&sa=N</NU>
</NB>
<R N="1">
<U>http://www.soccerconnection.net/</U>
<UE>http://www.soccerconnection.net/</UE>
<T>SoccerConnection.net</T>
<CRAWLDATE>May 21, 2007</CRAWLDATE>
<S><b>soccer</b>; players; coaches; ball; world cup;<b>...</b></S>
<Label>transcodable_pages</Label>
<Label>accessible</Label>
<Label>soccer_sites</Label>
<LANG>en</LANG>
<HAS>
<DI>
<DT>SoccerConnection.net</DT>
<DS>Post your <b>soccer</b> resume directly on the Internet.</DS>
</DI>
<L/>
<C SZ="8k" CID="kWAPoYw1xIUJ"/>
<RT/>
</HAS>
</R>
/*
* The result includes nine more results, each enclosed by an R tag.
*/
</RES>
</GSP>
Penelusuran Reguler/Lanjutan: Tag XML
Respons XML untuk permintaan penelusuran reguler dan penelusuran lanjutan keduanya menggunakan rangkaian tag XML yang sama. Tag XML ini ditampilkan di contoh XML di atas dan dijelaskan dalam tabel di bawah.
Tag XML di bawah ini dicantumkan menurut abjad berdasarkan nama tag, dan masing-masing berisi deskripsi tag, contoh yang menunjukkan cara tag akan muncul dalam hasil XML dan format tag saat ini. Jika tag merupakan subtag dari tag XML lain atau jika tag memiliki sub tag atau atribut sendiri, informasi itu juga disediakan dalam di tabel definisi tag.
Simbol tertentu mungkin ditampilkan di sebelah beberapa sub tag dalam di bawah ini. Berikut adalah simbol-simbol tersebut, beserta maknanya:
* = nol atau beberapa instance subtag
+ = satu atau beberapa instance subtag
A | B | C | D | F | G | J | P | B | M | N | M | T | R | S | T | U | X |
anchor_text | |
---|---|
Definisi | Tag <anchor_text> menentukan teks yang yang harus Anda tampilkan kepada pengguna untuk mengidentifikasi penyempurnaan label yang terkait dengan kumpulan hasil penelusuran. Sejak perbaikan label mengganti karakter non-alfanumerik dengan garis bawah, Anda tidak boleh tampilkan nilai tag <label> di antarmuka pengguna Anda. Sebagai gantinya, Anda harus menampilkan nilai tag <anchor_text>. |
Contoh | <anchor_text>golf kursus</anchor_text> |
Subtag dari | FacetItem |
Format Konten | Teks |
BLOKIR | |
---|---|
Definisi | Tag ini merangkum konten blok dalam baris isi hasil promosi. Setiap blok memiliki subtag T, U, dan L. Tag T yang tidak kosong menunjukkan bahwa blok tersebut berisi teks; Tag U dan L yang tidak kosong menunjukkan bahwa blok tersebut berisi link (dengan URL yang diberikan dalam subtag U dan teks link dalam subtag L). |
Subtag | T, U, L |
Subtag dari | BODY_LINE |
Format Konten | Kosong |
BODY_LINE | |
---|---|
Definisi | Tag ini mengenkapsulasi konten baris dalam isi hasil yang dipromosikan. Setiap baris isi terdiri dari beberapa tag BLOKIR, yang berisi beberapa teks atau link dengan URL dan teks link. |
Subtag | BLOKIR* |
Subtag dari | SL_MAIN |
Format Konten | Kosong |
C | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definisi | Tag <C> menunjukkan bahwa layanan WebSearch
dapat mengambil versi cache dari URL hasil penelusuran ini. Anda tidak dapat
mengambil halaman yang di-cache melalui XML API, tetapi Anda bisa mengalihkan pengguna
ke www.google.com untuk melakukannya
saat ini. |
|||||||||
Atribut |
|
|||||||||
Contoh | <C SZ="6 rb" CID="kvOXK_cYSSgJ" /> | |||||||||
Subtag dari | MEMILIKI | |||||||||
Format Konten | Kosong |
C2C | |
---|---|
Definisi | Tag <C2C> menunjukkan bahwa hasilnya mengacu pada laman berbahasa China Aksara Tradisional. Tag ini hanya muncul jika setelan Aksara Sederhana dan Tradisional Penelusuran Bahasa China diaktifkan. Lihat definisi parameter kueri c2coff untuk mengetahui informasi selengkapnya tentang mengaktifkan dan menonaktifkan fitur ini. |
Format Konten | Teks |
Konteks | |
---|---|
Definisi | Tag <Context> merangkum daftar label penajaman yang terkait dengan sekumpulan hasil penelusuran. |
Contoh | <Context> |
Subtag | title, Facet+ |
Format Konten | Penampung |
TANGGAL MERAH | |
---|---|
Definisi | Tag <CRAWLDATE> mengidentifikasi tanggal saat
terakhir di-crawl. |
Contoh | <CRAWLDATE>21 Mei, 2005</CRAWLDATE> |
Subtag dari | R |
Format Konten | Teks |
DI | |
---|---|
Definisi | Tag <DI> merangkum Project Direktori Terbuka (ODP) untuk hasil penelusuran tunggal. |
Contoh | <DI> |
Subtag | DT? DS? |
Subtag dari | MEMILIKI |
Format Konten | Kosong |
DS | |
---|---|
Definisi | Tag <DS> memberikan ringkasan yang tercantum untuk satu kategori dalam direktori ODP. |
Contoh | <DS>Posting <b>sepak bola</b> lanjutkan secara langsung di Internet.</DS> |
Subtag dari | DI |
Format Konten | Teks (dapat berisi HTML) |
DT | |
---|---|
Definisi | Tag <DT> memberikan judul untuk satu yang tercantum dalam direktori ODP. |
Contoh | <DT>SoccerConnection.net</DT> |
Subtag dari | DI |
Format Konten | Teks (dapat berisi HTML) |
Faset | |
---|---|
Definisi | Tag <Facet> berisi pengelompokan tag <FacetItem> yang logis. Anda dapat membuat pengelompokan ini menggunakan Programmable Search Engine Format Spesifikasi XML Engine. Jika Anda tidak membuat pengelompokan, results_xml_tag_Context><Context> tag tersebut akan memuat hingga empat tag <Facet>. Item di dalam setiap tag <Facet> akan dikelompokkan untuk tujuan tampilan, namun mungkin tidak memiliki hubungan. |
Contoh | <Facet> |
Subtag | FacetItem+, judul+ |
Subtag dari | Konteks |
Format Konten | Penampung |
FacetItem | |
---|---|
Definisi | Tag <FacetItem> merangkum informasi tentang label penajaman yang terkait dengan serangkaian hasil penelusuran. |
Contoh | <FacetItem> |
Subtag | label, anchor_text+ |
Subtag dari | Faset |
Format Konten | FacetItem |
FI | |
---|---|
Definisi | Tag <FI> berfungsi sebagai tanda yang menunjukkan apakah pemfilteran dokumen dilakukan untuk penelusuran tersebut. Lihat bagian Pemfilteran Otomatis dokumen ini untuk informasi selengkapnya tentang hasil penelusuran Google filter. |
Contoh | <FI> |
Subtag dari | RES |
Format Konten | Kosong |
PSG | |||||||
---|---|---|---|---|---|---|---|
Definisi | Tag <GSP> mengenkapsulasi semua data yang dikembalikan dalam hasil penelusuran XML Google. "GSP" bernilai singkatan dari "Google Search Protocol". |
||||||
Atribut |
|
||||||
Contoh | <GSP VER="3.2"> | ||||||
Subtag | PARAM+, T, RES?, TM | ||||||
Format Konten | Kosong |
MEMILIKI | |
---|---|
Definisi | Tag <HAS> merangkum
informasi tentang penelusuran khusus
parameter permintaan yang didukung untuk URL tertentu.
Catatan: Definisi <HAS> untuk WebSearch lebih ketat daripada di DTD. |
Subtag | DI?, K?, C?, RT? |
Subtag dari | R |
ISURL | |
---|---|
Definisi | Google menampilkan tag <ISURL> jika kueri penelusuran terkait adalah URL. |
Subtag dari | GSP |
Format Konten | Kosong |
L | |
---|---|
Definisi | Adanya tag <L> menunjukkan bahwa layanan WebSearch dapat menemukan situs lain yang menautkan URL hasil penelusuran ini. Untuk menemukan situs tersebut, Anda akan menggunakan istilah kueri khusus link:. |
Subtag dari | MEMILIKI |
Format Konten | Kosong |
label | |
---|---|
Definisi | Tag <label> menentukan label penyempurnaan yang dapat digunakan untuk memfilter hasil penelusuran yang Anda terima. Untuk menggunakan label penajaman, tambahkan string lainnya:[[label tag value]] ke nilai parameter q dalam permintaan HTTP Anda ke Google sebagai yang ditunjukkan dalam contoh berikut. Perhatikan bahwa nilai ini harus di-escape URL sebelum Anda mengirim kueri ke Google. This example uses the refinement label golf_courses to Catatan: Tag <label> tidak sama dengan tag <Label>, yang mengidentifikasi label penyempurnaan yang dikaitkan dengan URL tertentu dalam hasil penelusuran Anda. |
Contoh | <label>golf_courses</label> |
Subtag dari | FacetItem |
Format Konten | Teks |
LANG | |
---|---|
Definisi | Tag <LANG> berisi tebakan terbaik dari Google bahasa hasil penelusuran. |
Contoh | <LANG>id</LANG> |
Subtag dari | R |
Format Konten | Teks |
M | |
---|---|
Definisi | Tag <M> mengidentifikasi total estimasi jumlah hasil pencarian. Catatan: Perkiraan ini mungkin tidak akurat. |
Contoh | <M>16200000</M> |
Subtag dari | RES |
Format Konten | Teks |
NB | |
---|---|
Definisi | Tag <NB> merangkum informasi navigasi—link ke halaman hasil penelusuran berikutnya atau halaman hasil penelusuran—untuk set hasil. Catatan: Tag ini hanya ada jika ada hasil lainnya. |
Contoh | <NB> |
Subtag | NU? PU? |
Subtag dari | RES |
Format Konten | Kosong |
NU | |
---|---|
Definisi | Tag <NU> berisi tautan relatif ke halaman hasil penelusuran berikutnya. |
Contoh | <NU>/search?q=flowers&num=10&hl=id&ie=UTF-8 &output=xml&client=test&start=10</NU> |
Subtag dari | Catatan |
Format Konten | Teks (URL Relatif) |
PARAM | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Definisi | Tag <PARAM> mengidentifikasi parameter input yang dikirimkan dalam permintaan HTTP yang terkait dengan hasil XML. Informasi tentang parameter terdapat dalam atribut tag—nama, nilai, nilai_asli—dan akan ada satu tag PARAM untuk setiap parameter yang dikirim dalam permintaan HTTP. |
||||||||||||
Atribut |
|
||||||||||||
Contoh | <nama PARAM="cr" value="countryNZ" original_value="countryNZ" /> | ||||||||||||
Subtag dari | GSP | ||||||||||||
Format Konten | Rumit |
PU | |
---|---|
Definisi | Tag <PU> memberikan tautan relatif ke halaman hasil penelusuran sebelumnya. |
Contoh | <PU>/search?q=flowers&num=10&hl=id&output=xml &client=test&start=10</PU> |
Subtag dari | Catatan |
Format Konten | Teks (URL Relatif) |
T | |
---|---|
Definisi | Tag <Q> mengidentifikasi kueri penelusuran yang dikirimkan dalam permintaan HTTP yang terkait dengan hasil XML. |
Contoh | <Q>pizza</Q> |
Subtag dari | GSP |
Format Konten | Teks |
R | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definisi | Tag <R> merangkum detail hasil penelusuran individual. Catatan: Definisi tag <R> untuk WebSearch lebih ketat daripada di DTD. |
|||||||||
Atribut |
|
|||||||||
Subtag | U, UE, T?, CRAWLDATE, S?, LANG?, MEMILIKI | |||||||||
Subtag dari | RES |
RES | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definisi | Tag <RES> merangkum kumpulan elemen hasil penelusuran dan detail tentang hasil tersebut. |
|||||||||
Atribut |
|
|||||||||
Contoh | <RES SN="1" EN="10"> | |||||||||
Subtag | M, FI?, XT? Catatan? R* | |||||||||
Subtag dari | GSP | |||||||||
Format Konten | Kosong |
S | |
---|---|
Definisi | Tag <S> berisi cuplikan penelusuran hasil yang menampilkan istilah kueri yang ditandai dalam cetak tebal. Pemisah baris adalah disertakan dalam kutipan untuk pembungkusan teks yang tepat. |
Contoh | <S>Washington (CNN) -- Tawaran untuk mengakhiri Kebuntuan senat atas Presiden <b>Bush's</b> keputusan yudisial akan membiarkan lima kandidat maju ke tahap pemungutan suara terakhir sambil mempertahankan <b>...<b>...</b><S> |
Subtag dari | R |
Format Konten | Teks (HTML) |
SL_MAIN | |
---|---|
Definisi | Tag ini merangkum konten hasil promosi. Gunakan untuk mengurai promosi. Teks anchor dan URL link judul masing-masing terdapat dalam subtag T dan U. Baris teks isi dan link terdapat dalam subtag BODY_LINE. |
Subtag | BODY_LINE*, K, U |
Subtag dari | SL_RESULTS |
Format Konten | Kosong |
SL_RESULTS | |
---|---|
Definisi | Tag container untuk hasil yang dipromosikan. Salah satunya akan muncul setiap kali Anda memiliki promosi di hasil penelusuran. Subtag SL_MAIN berisi data hasil utama. |
Subtag | SL_MAIN* |
Subtag dari | R |
Format Konten | Kosong |
Ejaan | |
---|---|
Definisi | Tag <Ejaan> merangkum alternatif saran ejaan untuk kueri yang dikirim. Tag ini hanya muncul di halaman pertama hasil penelusuran. Saran ejaan tersedia di Inggris, China, Jepang, dan Korea. Catatan: Google hanya akan menampilkan saran ejaan untuk kueri yang memiliki nilai parameter gl huruf kecil. |
Contoh | <Ejaan> |
Subtag | Saran |
Subtag dari | GSP |
Format Konten | Kosong |
Saran | |||||||
---|---|---|---|---|---|---|---|
Definisi | Tag <Suggestion> berisi saran ejaan alternatif untuk kueri yang dikirimkan. Anda dapat menggunakan konten tag untuk menyarankan ejaan alternatif kepada pengguna penelusuran Anda. Nilai atribut q adalah atribut Saran ejaan yang dikurung URL yang dapat Anda gunakan sebagai istilah kueri. | ||||||
Atribut |
|
||||||
Contoh | <Saran q="soccer">&lt;b&gt;&lt;i&gt;soccer&lt;/i&gt;&lt;/b&gt;</Suggestion> | ||||||
Subtag dari | Ejaan | ||||||
Format Konten | Teks (HTML) |
S | |
---|---|
Definisi | Tag <T> berisi judul dari hasil. |
Contoh | <T>Pantai Timur Amici Restoran Piza</T> |
Subtag dari | R |
Format Konten | Teks (HTML) |
judul | |
---|---|
Definisi | Sebagai turunan dari <Context>, tag <Context> berisi nama Programmable Search Engine Anda. Sebagai turunan dari <Facet>, tag <title> memberikan judul untuk sekumpulan faset. |
Contoh | Sebagai turunan dari <Context>: <title>Penelusuran Saya Engine</title> Sebagai turunan dari <Facet>: <title>facet title [judul]</title> |
Subtag dari | Konteks, Facet |
Format Konten | Teks |
TM | |
---|---|
Definisi | Tag <TM> mengidentifikasi total waktu server yang diperlukan untuk menampilkan hasil penelusuran, yang diukur dalam hitungan detik. |
Contoh | <TM>0,100445</TM> |
Subtag dari | GSP |
Format Konten | Teks (Bilangan floating point) |
TT | |
---|---|
Definisi | Tag <TT> menyediakan penelusuran tips ini. |
Contoh | <TT><i>Tips: Untuk sebagian besar {i>browser<i}, menekan tombol {i>Return<i} akan memberikan hasil yang sama dengan tombol Telusuri.</i></TT> |
Subtag dari | GSP |
U | |
---|---|
Definisi | Tag <U> memberikan URL hasil penelusuran. |
Contoh | <U>http://www.dominos.com/</U> |
Subtag dari | R |
Format Konten | Teks (URL Absolut) |
UD | |
---|---|
Definisi | Tag <UD> menyediakan ID yang dienkode dengan IDN (International Domain Name) untuk hasil penelusuran. Nilai ini memungkinkan domain yang akan ditampilkan menggunakan bahasa lokal. Misalnya, URL yang dienkode dengan IDN http://www.%E8%8A%B1%E4%BA%95.com dapat didekode dan ditampilkan sebagai http://www.花 searched鮨.com. Tag <UD> ini hanya akan dimasukkan dalam hasil penelusuran untuk permintaan yang menyertakan parameter ud. Catatan: Fitur ini adalah fitur beta. |
Contoh | <UD>http://www.%E8%8A%B1%E4%BA%95.com/</UD> |
Subtag dari | R |
Format Konten | Teks (URL berenkode IDN) |
UE | |
---|---|
Definisi | Tag <UE> menyediakan URL hasil penelusuran. Nilai di-escape URL sehingga sesuai untuk diteruskan sebagai parameter kueri di URL. |
Contoh | <UE>http://www.dominos.com/</UE> |
Subtag dari | R |
Format Konten | Teks (URL yang di-escape URL) |
XT | |
---|---|
Definisi | Tag <XT> menunjukkan bahwa estimasi total hasil, seperti yang ditentukan oleh tag M, sebenarnya mewakili jumlah total hasil. Lihat Otomatis Bagian pemfilteran dalam dokumen ini untuk mengetahui detail selengkapnya. |
Contoh | <XT /> |
Subtag dari | RES |
Format Konten | Kosong |
Hasil XML untuk Kueri Penelusuran Gambar
Contoh Permintaan gambar ini meminta 5 hasil (num=5) tentang istilah penelusuran "monyet" (q=monyet).
http://www.google.com/cse? searchtype=image &num=2 &q=monkey &client=google-csbe &output=xml_no_dtd &cx=00255077836266642015:u-scht7a-8i
Permintaan ini akan memberikan hasil XML di bawah.
<GSP VER="3.2"> <TM>0.395037</TM> <Q>monkeys</Q> <PARAM name="cx" value="011737558837375720776:mbfrjmyam1g" original_value="011737558837375720776:mbfrjmyam1g" url_<escaped_value="011737558837375720776%3Ambfrjmyam1g" js_escaped_value="011737558837375720776:mbfrjmyam1g"/> <PARAM name="client" value="google-csbe" original_value="google-csbe" url_escaped_value="google-csbe" js_escaped_value="google-csbe"/> <PARAM name="q" value="monkeys" original_value="monkeys" url_escaped_value="monkeys" js_escaped_value="monkeys"/> <PARAM name="num" value="2" original_value="2" url_escaped_value="2" js_escaped_value="2"/> <PARAM name="output" value="xml_no_dtd" original_value="xml_no_dtd" url_escaped_value="xml_no_dtd" js_escaped_value="xml_no_dtd"/> <PARAM name="adkw" value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" original_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" url_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" js_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A"/> <PARAM name="hl" value="en" original_value="en" url_escaped_value="en" js_escaped_value="en"/> <PARAM name="oe" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/> <PARAM name="ie" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/> <PARAM name="boostcse" value="0" original_value="0" url_escaped_value="0" js_escaped_value="0"/> <Context> <title>domestigeek</title> </Context> <ARES/> <RES SN="1" EN="2"> <M>2500000</M> <NB> <NU>/images?q=monkeys&num=2&hl=en&client=google-csbe&cx=011737558837375720776:mbfrjmyam1g&boostcse=0&output=xml_no_dtd &ie=UTF-8&oe=UTF-8&tbm=isch&ei=786oTsLiJaaFiALKrPChBg&start=2&sa=N </NU> </NB> <RG START="1" SIZE="2"/> <R N="1" MIME="image/jpeg"> <RU>http://www.flickr.com/photos/fncll/135465558/</RU> <U> http://farm1.static.flickr.com/46/135465558_123402af8c.jpg </U> <UE> http://farm1.static.flickr.com/46/135465558_123402af8c.jpg </UE> <T>Computer <b>Monkeys</b> | Flickr - Photo Sharing!</T> <RK>0</RK> <BYLINEDATE>1146034800</BYLINEDATE> <S>Computer <b>Monkeys</b> | Flickr</S> <LANG>en</LANG> <IMG WH="500" HT="305" IID="ANd9GcQARKLwzi-t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"> <SZ>88386</SZ> <IN/> </IMG> <TBN TYPE="0" WH="130" HT="79" URL="http://t0.gstatic.com/images?q=tbn:ANd9GcQARKLwzi- t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"/> </R> <R N="2" MIME="image/jpeg"> <RU> http://www.flickr.com/photos/flickerbulb/187044366/ </RU> <U> http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg </U> <UE> http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg </UE> <T> one. ugly. <b>monkey</b>. | Flickr - Photo Sharing! </T> <RK>0</RK> <BYLINEDATE>1152514800</BYLINEDATE> <S>one. ugly. <b>monkey</b>.</S> <LANG>en</LANG> <IMG WH="400" HT="481" IID="ANd9GcQ3Qom0bYbee4fThCQVi96jMEwMU6IvVf2b8K5vERKVw- EF4tQQnDDKOq0"><SZ>58339</SZ> <IN/> </IMG> <TBN TYPE="0" WH="107" HT="129" URL="http://t1.gstatic.com/images?q=tbn:ANd9GcQ3Qom0bYbee4fThCQ Vi96jMEwMU6IvVf2b8K5vERKVw-EF4tQQnDDKOq0"/> </R> </RES> </GSP>
Penelusuran Gambar: Tag XML
Tabel di bawah menampilkan tag XML tambahan yang digunakan dalam respons XML untuk kueri penelusuran gambar.
Simbol tertentu mungkin ditampilkan di sebelah beberapa sub tag dalam di bawah ini. Berikut adalah simbol-simbol tersebut, beserta maknanya:
* = nol atau beberapa instance subtag
+ = satu atau beberapa instance subtag
RG | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definisi | Tag <RG> mencakup detail setiap hasil penelusuran gambar. |
|||||||||
Atribut |
| |||||||||
Subtag dari | RES |
RU | |
---|---|
Definisi | Tag <RU tag> menyertakan detail setiap hasil penelusuran gambar. |
Subtag dari | R |