Halaman ini merujuk ke versi XML dari Custom Search JSON API, yang hanya tersedia untuk pelanggan Google Site Search.
- Ringkasan
- Format Permintaan Programmable Search Engine
- Hasil XML
Ringkasan
Layanan Google WebSearch memungkinkan pelanggan Google Penelusuran Situs menampilkan hasil penelusuran Google di situs mereka sendiri. Layanan WebSearch menggunakan protokol berbasis HTTP yang sederhana untuk menampilkan hasil penelusuran. Administrator Penelusuran memiliki kontrol penuh atas cara mereka meminta hasil penelusuran dan cara mereka menampilkan hasil tersebut kepada pengguna akhir. Dokumen ini menjelaskan detail teknis permintaan dan format hasil penelusuran Google.
Untuk mengambil hasil Google WebSearch, aplikasi Anda mengirimkan permintaan HTTP sederhana ke Google. Kemudian, Google menampilkan hasil penelusuran dalam format XML. Hasil berformat XML memungkinkan Anda menyesuaikan cara hasil penelusuran ditampilkan.
Format Permintaan WebSearch
- Ringkasan Permintaan
- Istilah Kueri
- Parameter Permintaan
- Contoh Kueri WebSearch
- Definisi Parameter Kueri WebSearch
- Contoh Kueri Gambar
- Definisi Parameter Kueri Penelusuran Gambar
- Penelusuran Lanjutan
- Parameter Kueri Penelusuran Lanjutan
- Persyaratan Kueri Khusus
- Batas Permintaan
Ikhtisar Permintaan
Permintaan penelusuran Google adalah perintah HTTP GET
standar. Alat ini
mencakup kumpulan parameter yang relevan dengan
kueri Anda. Parameter ini disertakan dalam URL permintaan sebagai pasangan nama=nilai yang dipisahkan oleh karakter ampersand (&). Parameter mencakup
data seperti kueri penelusuran dan ID mesin unik (cx
) yang mengidentifikasi
mesin yang membuat permintaan HTTP. Layanan WebSearch atau Penelusuran Gambar menampilkan
hasil XML sebagai respons terhadap permintaan HTTP Anda.
Persyaratan Kueri
Sebagian besar permintaan penelusuran berisi satu atau beberapa istilah kueri. Istilah kueri muncul sebagai nilai parameter dalam permintaan penelusuran.
Istilah kueri dapat menentukan beberapa jenis informasi untuk memfilter dan mengatur hasil penelusuran yang ditampilkan Google. Kueri dapat menentukan:
- Kata atau frasa yang akan disertakan atau
dikecualikan
- Semua kata dalam kueri penelusuran (default)
- Frasa yang sama persis dalam 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
- Pembatasan pada dokumen itu sendiri
- Menyertakan atau mengecualikan dokumen jenis file tertentu (seperti file PDF atau dokumen Word)
- Kueri URL khusus yang menampilkan
informasi tentang URL tertentu, bukan melakukan penelusuran
- Kueri yang menampilkan informasi umum tentang URL, seperti kategori, cuplikan, atau bahasa Direktori Terbuka
- Kueri yang menampilkan kumpulan halaman web yang ditautkan ke URL
- Kueri yang menampilkan sekumpulan halaman web yang mirip dengan URL tertentu
Penelusuran Default
Nilai parameter kueri penelusuran harus di-escape URL. Perhatikan bahwa Anda akan mengganti tanda plus ("+") untuk setiap urutan spasi kosong dalam kueri penelusuran. Hal ini dibahas lebih lanjut di bagian Penarikan URL dalam dokumen ini.
Istilah kueri penelusuran dikirimkan ke layanan WebSearch menggunakan parameter q. Contoh istilah kueri penelusuran adalah:
q=horses+cows+pigs
Secara default, layanan Google WebSearch hanya menampilkan dokumen yang menyertakan semua istilah dalam kueri penelusuran.
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 hanya relevan dengan permintaan penelusuran lanjutan.
Diperlukan tiga parameter permintaan:
- Parameter client harus ditetapkan ke
google-csbe
- Parameter output menentukan format hasil XML yang ditampilkan; hasil dapat ditampilkan dengan (xml) atau tanpa (
xml_no_dtd
) referensi ke DTD Google. Sebaiknya tetapkan nilai ini kexml_no_dtd
. Catatan: Jika Anda tidak menentukan parameter ini, hasilnya akan ditampilkan dalam HTML, bukan XML.
- Parameter cx yang mewakili ID unik mesin.
Parameter permintaan yang paling umum digunakan selain yang disebutkan di atas adalah:
Contoh Kueri WebSearch
Contoh di bawah ini menunjukkan beberapa permintaan HTTP WebSearch untuk menggambarkan cara penggunaan parameter kueri yang berbeda. Definisi untuk parameter kueri yang berbeda tersedia di bagian Definisi Parameter Kueri WebSearch dan Parameter Kueri Penelusuran Lanjutan 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 Kanada (cr=countryCA
)
dan harus ditulis dalam bahasa Prancis (lr=lang_fr
). Terakhir, kueri
menentukan nilai untuk parameter client, output,
dan 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 parameter kueri penelusuran lanjutan untuk menyesuaikan kueri penelusuran lebih lanjut. Permintaan ini menggunakan parameter as_q (as_q=red+sox
), bukan parameter q. Parameter ini juga menggunakan parameter as_eq untuk mengecualikan dokumen apa pun 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 fitur Penelusuran China Sederhana dan 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 bagian Nilai Parameter Negara (cr) untuk mengetahui 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 pada dokumen ini untuk informasi selengkapnya tentang filter hasil penelusuran Google. Nilai default untuk parameter
Catatan: Secara default, Google menerapkan pemfilteran ke semua hasil penelusuran guna meningkatkan kualitas hasil tersebut. |
||||||
Contoh | q=google&filter=0 |
gl | |
---|---|
Deskripsi | Opsional. Nilai parameter Menentukan parameter value |
Contoh | Permintaan ini meningkatkan dokumen yang ditulis dalam bahasa Inggris Raya di
hasil WebSearch: |
hl | |
---|---|
Deskripsi | Opsional. Parameter Lihat bagian Bahasa Antarmuka pada Presentasi Hasil dan Kueri Internasional untuk mengetahui informasi selengkapnya dan Bahasa Antarmuka yang Didukung untuk daftar bahasa yang didukung. |
Contoh | Permintaan ini menargetkan iklan untuk anggur dalam bahasa Prancis. (Vin adalah istilah bahasa Prancis untuk anggur.) q=vin&ip=10.10.10.10&ad=w5&hl=fr |
hq | |
---|---|
Deskripsi | Opsional. Parameter |
Contoh | Permintaan ini menelusuri 'pizza' DAN 'cheese'. Ekspresinya sama dengan
|
ie | |
---|---|
Deskripsi | Opsional. Parameter Lihat bagian Encoding Karakter untuk diskusi mengenai kapan Anda mungkin perlu menggunakan parameter ini. Lihat bagian Skema Encoding
Karakter untuk daftar kemungkinan nilai |
Contoh | q=google&ie=utf8&oe=utf8 |
lr | |
---|---|
Deskripsi | Opsional. Parameter Google WebSearch menentukan bahasa dokumen dengan menganalisis:
Lihat bagian Nilai Koleksi
Bahasa ( |
Contoh | q=Frodo&lr=lang_en |
num | |
---|---|
Deskripsi | Opsional. Parameter Nilai Catatan: Jika jumlah total hasil penelusuran kurang dari jumlah hasil yang diminta, semua hasil penelusuran yang tersedia akan ditampilkan. |
Contoh | q=google&num=10 |
oe | |
---|---|
Deskripsi | Opsional. Parameter Lihat bagian Encoding Karakter untuk diskusi mengenai kapan Anda mungkin perlu menggunakan parameter ini. Lihat bagian Skema Encoding
Karakter 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 nilai parameter
Panel Kontrol Google Penelusuran menyertakan laporan kueri
teratas 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 bagian Memfilter Konten Khusus Dewasa dengan SafeSearch untuk detail selengkapnya tentang fitur ini. |
||||||||
Contoh | q=adult&safe=high |
mulai | |
---|---|
Deskripsi | Opsional. Parameter Parameter |
Contoh | start=10 |
sort | |
---|---|
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: 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 mengirimkan penelusuran lanjutan, nilai beberapa parameter (mis. as_eq, as_epq, as_oq, dll.) semuanya diperhitungkan dalam istilah kueri untuk penelusuran tersebut. Gambar menampilkan halaman Penelusuran Lanjutan Google. Pada gambar, nama setiap parameter penelusuran lanjutan ditulis dalam teks red di dalam atau di samping kolom pada halaman yang terkait dengan parameter tersebut.
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 setahun terakhir:
Contoh permintaan berikut ini dihasilkan 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. Istilah kueri khusus ini harus disertakan dalam nilai parameter permintaan q. Seperti istilah kueri lainnya, istilah kueri
khusus harus di-escape URL. Sejumlah istilah kueri khusus berisi titik dua (:). Karakter ini juga harus di-escape URL; nilai URL-nya adalah %3A
.
Link Kembali [link:] | |
---|---|
Deskripsi | Istilah kueri Versi Anda juga dapat menggunakan parameter permintaan as_lq untuk mengirim permintaan Catatan: Anda tidak dapat menentukan istilah kueri lain saat menggunakan |
Contoh |
|
Boolean OR Penelusuran [ OR ] | |
---|---|
Deskripsi | Istilah kueri Anda juga dapat menggunakan parameter permintaan as_oq untuk mengirim penelusuran untuk istilah apa pun dalam kumpulan istilah. Catatan: Jika permintaan penelusuran menentukan kueri "London+OR+Paris", hasil penelusuran akan menyertakan dokumen yang berisi setidaknya salah satu dari dua kata tersebut. Pada beberapa kasus, dokumen dalam hasil penelusuran dapat berisi kedua kata tersebut. |
Contoh | Telusuri London atau Paris: Input pengguna:
london OR
paris Istilah kueri:q=london+OR+paris Telusuri liburan dan antara 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 Telusuri liburan dan cokelat, serta London atau paris, dengan bobot terkecil yang diberikan pada cokelat: Istilah kueri:
q=vacation+london+OR+paris+chocolates Telusuri liburan, cokelat, dan bunga dalam dokumen yang juga berisi tentang London atau Paris: Istilah kueri:
q=vacation+london+OR+paris+chocolates+flowers Telusuri liburan dan salah satu dari London atau Paris dan juga telusuri salah satu cokelat atau bunga: Istilah kueri: q=vacation+london+OR+paris+chocolates+OR+flowers |
Kecualikan Istilah Kueri [-] | |
---|---|
Deskripsi | Istilah kueri kecualikan ( Versi Istilah kueri pengecualian berguna jika istilah penelusuran memiliki lebih 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 untuk mengecualikan. Anda juga dapat menggunakan parameter permintaan as_eq 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 [ -filetype: ] | |
---|---|
Deskripsi | Istilah kueri Versi Catatan: Anda dapat mengecualikan beberapa
jenis file dari hasil penelusuran dengan menambahkan lebih banyak istilah kueri
Jenis file yang didukung oleh Google meliputi:
Jenis file lainnya dapat ditambahkan di masa mendatang. Daftar terbaru selalu dapat ditemukan di FAQ jenis file Google. |
Contoh | Contoh ini menampilkan dokumen yang menyebutkan "Google" tetapi
bukan dokumen PDF: Contoh ini menampilkan dokumen yang menyebutkan "Google", tetapi
mengecualikan dokumen PDF dan Word: |
Pemfilteran Jenis File [ filetype: ] | |
---|---|
Deskripsi | Istilah kueri Versi Anda dapat membatasi hasil penelusuran ke dokumen yang cocok dengan salah satu dari beberapa ekstensi file dengan menambahkan lebih banyak istilah kueri Secara default, hasil penelusuran akan menyertakan dokumen dengan ekstensi file apa pun. Jenis file yang didukung oleh Google meliputi:
Jenis file lainnya dapat ditambahkan di masa mendatang. Daftar terbaru selalu 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 istilah penyertaan kueri, Anda perlu mengawali kata atau frasa yang harus disertakan dalam semua hasil penelusuran dengan "+" (tanda plus). Versi Anda harus menggunakan |
Contoh | Input pengguna: Star Wars Episode +I Istilah kueri: q=Star+Wars+Episode+%2BI |
Penelusuran Hanya Link, semua istilah [ allinlinks: ] | |
---|---|
Deskripsi | Istilah kueri Jika kueri penelusuran Anda menyertakan istilah 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 menyertakan frasa tersebut dalam tanda kutip atau dengan menghubungkannya dengan tanda hubung. Versi Penelusuran frasa sangat berguna jika Anda menelusuri kutipan terkenal atau nama wajar. Anda juga dapat menggunakan parameter permintaan as_epq untuk mengirimkan penelusuran frasa. |
Contoh | Input pengguna:"Abraham Lincoln" Istilah kueri: q=%22Abraham+Lincoln%22 |
Penelusuran Khusus Teks, semua istilah [allintext:] | |
---|---|
Deskripsi | Istilah kueri Jika kueri penelusuran Anda menyertakan istilah kueri Versi |
Contoh | Contoh ini menetapkan bahwa kata "Google" dan "penelusuran" harus muncul dalam 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 dari satu kata yang harus disertakan dalam judul dokumen dengan menempatkan istilah kueri Versi |
Contoh | Contoh ini menetapkan bahwa kata "Google" harus muncul pada
judul dokumen apa pun dalam hasil penelusuran, dan kata
"penelusuran" harus muncul di mana saja dalam judul, URL, link, atau teks isi
dokumen tersebut: |
Penelusuran Judul, semua istilah [allintitle:] | |
---|---|
Deskripsi | Istilah kueri Catatan: Menempatkan Versi |
Contoh | Contoh ini menetapkan bahwa kata "Google" dan "penelusuran"
harus muncul dalam judul dokumen apa pun di hasil penelusuran: |
Penelusuran URL, istilah tunggal [inurl:] | |
---|---|
Deskripsi | Istilah kueri Istilah kueri Versi |
Contoh | Contoh ini menetapkan bahwa kata "Google" harus muncul di
URL semua dokumen dalam hasil penelusuran, dan kata "penelusuran"
harus muncul di mana saja pada judul, URL, link, atau teks isi dokumen
tersebut: |
Penelusuran URL, semua istilah [allinurl:] | |
---|---|
Deskripsi | Istilah kueri Istilah kueri Versi |
Contoh | Contoh ini menetapkan bahwa kata "Google" dan "penelusuran"
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 lain saat menggunakan |
Contoh | Input pengguna: info:www.google.com Istilah kueri: q=info%3Awww.google.com |
Contoh Kueri Gambar
Contoh di bawah ini menampilkan beberapa permintaan HTTP Gambar untuk menggambarkan cara penggunaan parameter kueri yang berbeda. Definisi untuk berbagai parameter kueri tersedia 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 yang ditentukan. Nilai yang diizinkan adalah: |
Contoh | q=google&as_filetype=png |
! | |
---|---|
Deskripsi | Opsional. Menampilkan gambar dengan ukuran tertentu, dengan ukuran dapat berupa salah satu dari:
|
Contoh | q=google&as_filetype=png&imgsz=icon |
jenis gambar | |
---|---|
Deskripsi | Opsional. Menampilkan gambar berjenis, yang dapat berupa salah satu dari:
|
Contoh | q=google&as_filetype=png&imgtype=photo |
gambar | |
---|---|
Deskripsi | Opsional. Menampilkan gambar hitam dan putih, hitam putih, atau berwarna:
|
Contoh | q=google&as_filetype=png&imgc=gray |
warnaimg | |
---|---|
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 mencantumkan batasan pada permintaan penelusuran yang Anda 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. Untuk mendapatkan lebih banyak hasil, Anda harus mengirim beberapa permintaan dan menaikkan nilai parameter start dengan setiap permintaan. |
Presentasi Hasil dan Kueri Internasionalisasi
Layanan Google WebSearch memungkinkan Anda menelusuri dokumen dalam berbagai bahasa. Anda dapat menentukan encoding karakter yang harus digunakan untuk menafsirkan permintaan HTTP dan mengenkode respons XML (menggunakan parameter penelusuran ie dan oe). Anda juga dapat memfilter hasil agar hanya menyertakan dokumen yang ditulis dalam bahasa tertentu.
Bagian berikut membahas masalah terkait penelusuran dalam berbagai bahasa:
Pengkodean Karakter
Server mengirim data, seperti halaman web, ke agen pengguna, seperti browser, sebagai urutan byte yang dienkode. Selanjutnya, agen pengguna akan mendekode byte tersebut menjadi urutan karakter. Ketika mengirim permintaan ke layanan WebSearch, Anda dapat menentukan skema encoding untuk kueri penelusuran dan respons XML yang Anda terima.
Anda dapat menggunakan parameter permintaan ie untuk menentukan mekanisme encoding untuk karakter dalam permintaan HTTP Anda. Anda juga dapat
menggunakan parameter oe untuk menentukan skema encoding
yang harus digunakan Google untuk mengenkode respons XML Anda. Jika Anda menggunakan skema encoding selain ISO-8859-1
(atau latin1
), pastikan Anda menentukan nilai yang benar untuk parameter ie dan oe.
Catatan: Jika Anda menyediakan fungsi penelusuran untuk beberapa
bahasa, sebaiknya gunakan nilai encoding utf8
(UTF-8) untuk
parameter ie dan oe.
Lihat lampiran Skema Encoding Karakter untuk mengetahui daftar lengkap nilai yang dapat Anda gunakan untuk parameter ie dan oe.
Untuk informasi yang lebih umum tentang encoding karakter, baca http://www.w3.org/TR/REC-html40/charset.html.
Bahasa Antarmuka
Anda dapat menggunakan parameter permintaan hl untuk mengidentifikasi bahasa antarmuka grafis Anda. Nilai parameter hl dapat memengaruhi hasil penelusuran XML, terutama pada kueri internasional jika pembatasan bahasa (menggunakan parameter lr) tidak ditentukan secara eksplisit. Dalam kasus semacam itu, 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 Google memilih hasil penelusuran berkualitas tertinggi untuk setiap kueri.
Lihat bagian Bahasa Antarmuka yang Didukung untuk mengetahui daftar lengkap nilai yang valid untuk parameter hl.
Menelusuri Dokumen yang Ditulis dalam Bahasa Tertentu
Anda dapat menggunakan parameter permintaan lr untuk membatasi hasil penelusuran ke dokumen yang ditulis dalam bahasa atau sekumpulan bahasa tertentu.
Parameter lr mendukung Operator Boolean agar Anda dapat menentukan beberapa bahasa yang harus disertakan (atau dikecualikan) dari hasil penelusuran.
Contoh berikut menunjukkan cara menggunakan Operator Boolean untuk meminta dokumen dalam 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 bagian Nilai Pengumpulan Bahasa untuk mengetahui daftar lengkap kemungkinan nilai untuk parameter lr dan bagian Operator Boolean untuk mengetahui pembahasan lengkap tentang penggunaan operator ini.
Penelusuran China Aksara Sederhana dan Tradisional
China Aksara Sederhana dan Tradisional adalah dua varian tulisan dari bahasa China. Konsep yang sama dapat ditulis secara berbeda di setiap varian. Dengan mempertimbangkan kueri di salah satu varian, layanan Google WebSearch dapat menampilkan hasil yang menyertakan halaman di kedua varian.
Untuk menggunakan fitur ini:
- Setel parameter permintaan c2coff ke 0
dan - Lakukan salah satu tindakan berikut:
Contoh berikut menunjukkan parameter kueri yang akan Anda sertakan dalam permintaan untuk hasil dalam bahasa China aksara sederhana dan tradisional. (Perhatikan bahwa informasi tambahan yang diperlukan, seperti klien, tidak disertakan dalam contoh.)
search?hl=zh-CN &lr=lang_zh-TW|lang_zh-CN &c2coff=0
Memfilter Hasil
Google WebSearch memberikan sejumlah cara untuk memfilter hasil penelusuran:
- Pemfilteran Otomatis 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 otomatis memfilter hasil penelusuran yang umumnya dianggap tidak diinginkan:
-
Konten Duplikat—Jika beberapa dokumen berisi informasi yang sama, 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 menampilkan hasil yang lebih rendah dalam
peringkat daripada seharusnya.
Sebaiknya biarkan filter ini aktif untuk permintaan penelusuran biasa karena filter tersebut akan meningkatkan kualitas sebagian besar hasil penelusuran secara signifikan. Namun, Anda dapat mengabaikan filter otomatis ini dengan menetapkan parameter kueri filter ke 0 dalam permintaan penelusuran.
Pemfilteran Bahasa dan Negara
Layanan Google WebSearch menampilkan hasil dari indeks master semua dokumen Web. Indeks master berisi subkoleksi dokumen yang dikelompokkan berdasarkan atribut tertentu, termasuk bahasa dan negara asal.
Anda dapat menggunakan parameter permintaan lr dan cr untuk membatasi hasil penelusuran ke subkoleksi dokumen yang masing-masing 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 di Menelusuri
Dokumen yang Ditulis dalam Bahasa Tertentu, dan Nilai Koleksi Bahasa yang dapat
digunakan sebagai nilai untuk parameter lr untuk mengetahui informasi
lebih lanjut tentang 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 Nilai Pengumpulan Negara yang dapat digunakan sebagai nilai untuk parameter cr untuk mengetahui informasi lebih lanjut tentang cara membatasi hasil berdasarkan negara asal.
Catatan: Anda dapat menggabungkan nilai bahasa dan nilai negara untuk menyesuaikan hasil penelusuran. Misalnya, Anda dapat meminta dokumen yang ditulis dalam bahasa Prancis dan berasal dari Prancis atau Kanada, atau Anda dapat meminta dokumen yang berasal dari Belanda 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 filter SafeSearch kami, Anda dapat menyaring hasil penelusuran yang berisi konten khusus dewasa dan menghapusnya. Filter Google menggunakan teknologi eksklusif untuk memeriksa kata kunci, frasa, dan URL. Meskipun tidak ada filter yang 100 persen akurat, SafeSearch akan menghapus sebagian besar konten khusus dewasa dari hasil penelusuran Anda.
Google berupaya menjaga SafeSearch agar selalu terbaru dan komprehensif dengan terus meng-crawl Web dan menyertakan pembaruan dari saran pengguna.
SafeSearch tersedia dalam bahasa berikut:
Belanda Inggris Prancis Jerman |
Italia Portugis (Brasil) Spanyol China Tradisional |
Anda dapat menyesuaikan sejauh mana Google memfilter hasil untuk konten khusus dewasa menggunakan parameter kueri safe. Tabel berikut menjelaskan setelan SafeSearch Google dan bagaimana setelan tersebut akan memengaruhi hasil penelusuran Anda:
Tingkat SafeSearch | Deskripsi |
---|---|
tinggi | Mengaktifkan versi SafeSearch yang lebih ketat. |
medium | Memblokir halaman web yang berisi pornografi dan konten seksual vulgar lainnya. |
nonaktif | Tidak memfilter konten khusus dewasa dari hasil penelusuran. |
* Setelan SafeSearch default adalah nonaktif.
Jika Anda telah mengaktifkan SafeSearch dan menemukan situs yang berisi konten menyinggung dalam hasil penelusuran Anda, harap kirimkan URL situs tersebut melalui email ke safesearch@google.com, dan kami akan menyelidiki situs tersebut.
Hasil XML
- DTD Hasil XML Google
- Tentang Respons XML
- Hasil XML 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 dalam mendeskripsikan format XML untuk semua jenis hasil penelusuran. Banyak tag dan atribut yang berlaku untuk semua jenis penelusuran. Namun, beberapa tag hanya berlaku untuk jenis penelusuran tertentu. Akibatnya, definisi dalam DTD mungkin tidak terlalu ketat dibandingkan definisi yang diberikan dalam dokumen ini.
Dokumen ini menjelaskan aspek DTD yang relevan untuk WebSearch. Saat melihat DTD, jika menangani WebSearch, Anda dapat mengabaikan tag dan atribut yang tidak didokumentasikan di sini dengan aman. Jika definisinya berbeda antara DTD dan dokumentasi, fakta tersebut akan 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 tata bahasa XML Google dapat berubah dari waktu ke waktu, Anda tidak boleh mengonfigurasi parser agar menggunakan DTD untuk memvalidasi setiap hasil XML.
Selain itu, Anda tidak boleh mengonfigurasi parser XML untuk mengambil DTD setiap kali mengirimkan permintaan penelusuran. Google jarang memperbarui DTD, dan permintaan ini menyebabkan keterlambatan dan persyaratan bandwidth yang tidak perlu.
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.
Harap diperhatikan bahwa mungkin tidak semua fitur di DTD tersedia atau didukung saat ini.
Tentang Respons XML
- Semua nilai elemen adalah HTML valid yang cocok untuk ditampilkan kecuali jika dinyatakan lain dalam definisi tag XML.
- Beberapa nilai elemen adalah URL yang perlu dienkode dengan HTML sebelum ditampilkan.
- Parser XML Anda harus mengabaikan atribut dan tag yang tidak terdokumentasi. Hal ini memungkinkan aplikasi Anda untuk terus berfungsi tanpa modifikasi jika Google menambahkan lebih banyak fitur ke output XML.
- Karakter tertentu harus di-escape jika disertakan sebagai nilai dalam
tag XML. Pemroses XML Anda harus mengonversi entitas ini kembali ke
karakter yang sesuai. Jika Anda tidak mengonversi entitas dengan benar, browser dapat, misalnya, merender karakter & menjadi "&".
Standar XML mendokumentasikan karakter tersebut; karakter tersebut direproduksi pada 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" yang sengaja salah dieja 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 menghasilkan hasil XML di bawah ini. Perhatikan bahwa ada beberapa komentar dalam hasil XML untuk menunjukkan tempat tag tertentu yang tidak disertakan dalam hasil akan muncul.
<?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 permintaan penelusuran lanjutan menggunakan kumpulan tag XML yang sama. Tag XML ini ditunjukkan dalam contoh XML di atas dan dijelaskan dalam tabel di bawah.
Tag XML di bawah ini tercantum menurut abjad berdasarkan nama tag, dan setiap definisi tag berisi deskripsi tag, contoh yang menunjukkan tampilan tag dalam hasil XML, dan format konten tag. Jika tag adalah subtag dari tag XML lain, atau jika tag memiliki subtag atau atribut sendiri, informasi tersebut juga disediakan dalam tabel definisi tag.
Simbol-simbol tertentu dapat ditampilkan di samping beberapa subtag dalam definisi 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 | T | M | K | M | N | M | T | R | S | T | U | X |
anchor_text | |
---|---|
Definisi | Tag <anchor_text> menentukan teks yang harus Anda tampilkan kepada pengguna untuk mengidentifikasi label penyempurnaan yang terkait dengan kumpulan hasil penelusuran. Karena label penajaman akan menggantikan karakter non-alfanumerik dengan garis bawah, Anda tidak boleh menampilkan nilai tag <label> di antarmuka pengguna Anda. Sebagai gantinya, Anda harus menampilkan nilai tag <anchor_text>. |
Contoh | <anchor_text>lapangan golf</anchor_text> |
Sub tag dari | FacetItem |
Format Konten | Teks |
BLOKIR | |
---|---|
Definisi | Tag ini mengenkapsulasi konten blok dalam baris isi hasil promosi. Setiap blok memiliki subtag T, U, dan L. Tag T yang tidak kosong menunjukkan bahwa blok berisi teks; tag U dan L yang tidak kosong menunjukkan bahwa blok berisi link (dengan URL yang diberikan dalam subtag U dan teks link dalam subtag L). |
Subtag | T, U, K |
Sub tag dari | BODY_LINE |
Format Konten | Kosong |
BODY_LINE | |
---|---|
Definisi | Tag ini mengenkapsulasi konten baris di 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* |
Sub tag dari | SL_MAIN |
Format Konten | Kosong |
C | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definisi | Tag <C> menunjukkan bahwa layanan WebSearch
dapat mengambil versi yang di-cache dari URL hasil penelusuran ini. Anda tidak bisa
mengambil halaman yang di-cache melalui XML API, tetapi Anda dapat mengalihkan pengguna
ke www.google.com untuk konten
ini. |
|||||||||
Atribut |
|
|||||||||
Contoh | <C SZ="6k" CID="kvOXK_cYSSgJ" /> | |||||||||
Sub tag dari | HAS | |||||||||
Format Konten | Kosong |
C2C | |
---|---|
Definisi | Tag <C2C> menunjukkan bahwa hasil penelusuran merujuk ke halaman berbahasa China Aksara Tradisional. Tag ini hanya muncul jika Penelusuran China Aksara Sederhana dan Tradisional diaktifkan. Lihat definisi parameter kueri c2coff untuk mengetahui informasi selengkapnya tentang cara mengaktifkan dan menonaktifkan fitur ini. |
Format Konten | Teks |
Konteks | |
---|---|
Definisi | Tag <Context> merangkum daftar label penajaman yang terkait dengan kumpulan hasil penelusuran. |
Contoh | <Context> |
Subtag | title, Facet+ |
Format Konten | Container |
TANGGAL PERAYAPAN | |
---|---|
Definisi | Tag <CRAWLDATE> mengidentifikasi tanggal
halaman terakhir di-crawl. |
Contoh | <CRAWLDATE>21 Mei 2005</CRAWLDATE> |
Sub tag dari | R |
Format Konten | Teks |
DI | |
---|---|
Definisi | Tag <DI> merangkum informasi kategori Open Directory Project (ODP) untuk satu hasil penelusuran. |
Contoh | <DI> |
Subtag | DT?, DS? |
Sub tag dari | HAS |
Format Konten | Kosong |
DS | |
---|---|
Definisi | Tag <DS> memberikan ringkasan yang tercantum untuk satu kategori di direktori ODP. |
Contoh | <DS>Posting <b>football</b> resume Anda langsung di Internet.</DS> |
Sub tag dari | DI |
Format Konten | Teks (mungkin berisi HTML) |
DT | |
---|---|
Definisi | Tag <DT> memberikan judul untuk satu kategori yang tercantum di direktori ODP. |
Contoh | <DT>Sepak Bola.net</DT> |
Sub tag dari | DI |
Format Konten | Teks (mungkin berisi HTML) |
Faset | |
---|---|
Definisi | Tag <Facet> berisi pengelompokan logis tag <FacetItem>. Anda dapat membuat pengelompokan ini menggunakan format Spesifikasi XML Programmable Search Engine. Jika Anda tidak membuat pengelompokan ini, tag results_xml_tag_Context><Context> akan berisi hingga empat tag <Facet>. Item dalam setiap tag <Facet> akan dikelompokkan untuk tujuan tampilan, tetapi mungkin tidak memiliki hubungan yang logis. |
Contoh | <Facet> |
Subtag | FacetItem+, title+ |
Sub tag dari | Konteks |
Format Konten | Container |
FacetItem | |
---|---|
Definisi | Tag <FacetItem> merangkum informasi tentang label penajaman yang terkait dengan kumpulan hasil penelusuran. |
Contoh | <FacetItem> |
Subtag | label, anchor_text+ |
Sub tag dari | Faset |
Format Konten | FacetItem |
FI | |
---|---|
Definisi | Tag <FI> berfungsi sebagai flag yang menunjukkan apakah pemfilteran dokumen telah dilakukan untuk penelusuran atau tidak. Lihat bagian Pemfilteran Otomatis pada dokumen ini untuk informasi lebih lanjut tentang filter hasil penelusuran Google. |
Contoh | <FI /> |
Sub tag dari | RES |
Format Konten | Kosong |
PSG | |||||||
---|---|---|---|---|---|---|---|
Definisi | Tag <GSP> merangkum semua data yang ditampilkan dalam hasil penelusuran XML Google. "GSP" adalah singkatan dari "Google Search Protocol". |
||||||
Atribut |
|
||||||
Contoh | <GSP VER="3.2"> | ||||||
Subtag | PARAM+, Q, RES?, TM | ||||||
Format Konten | Kosong |
HAS | |
---|---|
Definisi | Tag <HAS> merangkum
informasi tentang parameter permintaan
penelusuran khusus yang didukung untuk URL tertentu.
Catatan: Definisi <HAS> untuk WebSearch lebih ketat daripada dalam DTD. |
Subtag | DI?, K?, C?, RT? |
Sub tag dari | R |
ISURL | |
---|---|
Definisi | Google menampilkan tag <ISURL> jika kueri penelusuran terkait adalah URL. |
Sub tag dari | GSP |
Format Konten | Kosong |
L | |
---|---|
Definisi | Keberadaan tag <L> menunjukkan bahwa layanan WebSearch dapat menemukan situs lain yang tertaut ke URL hasil penelusuran ini. Untuk menemukan situs seperti itu, Anda akan menggunakan istilah kueri khusus link:. |
Sub tag dari | HAS |
Format Konten | Kosong |
label | |
---|---|
Definisi | Tag <label> menentukan label penajaman yang dapat Anda gunakan untuk memfilter hasil penelusuran yang Anda terima. Untuk menggunakan label penajaman, tambahkan string more:[[label tag value]] ke nilai parameter q dalam permintaan HTTP Anda ke Google seperti yang ditunjukkan dalam contoh berikut. Perlu diperhatikan bahwa nilai ini harus di-escape URL sebelum Anda mengirimkan kueri ke Google. This example uses the refinement label golf_courses to Catatan: Tag <label> tidak sama dengan tag <Label>, yang mengidentifikasi label penajaman yang terkait dengan URL tertentu dalam hasil penelusuran Anda. |
Contoh | <label>kursus_golf</label> |
Sub tag dari | FacetItem |
Format Konten | Teks |
LANG | |
---|---|
Definisi | Tag <LANG> berisi tebakan terbaik Google untuk bahasa hasil penelusuran. |
Contoh | <LANG>en</LANG> |
Sub tag dari | R |
Format Konten | Teks |
S | |
---|---|
Definisi | Tag <M> mengidentifikasi estimasi total jumlah hasil untuk penelusuran. Catatan: Estimasi ini mungkin tidak akurat. |
Contoh | <M>16200000</M> |
Sub tag dari | RES |
Format Konten | Teks |
NB | |
---|---|
Definisi | Tag <NB> merangkum informasi navigasi—link ke halaman hasil penelusuran berikutnya atau halaman hasil penelusuran sebelumnya—untuk kumpulan hasil. Catatan: Tag ini hanya ada jika ada lebih banyak hasil yang tersedia. |
Contoh | <NB> |
Subtag | NU?, PU? |
Sub tag dari | RES |
Format Konten | Kosong |
NU | |
---|---|
Definisi | Tag <NU> berisi link 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> |
Sub tag dari | Catatan |
Format Konten | Teks (URL Relatif) |
PARAM | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Definisi | Tag <PARAM> mengidentifikasi parameter input yang dikirim dalam permintaan HTTP yang terkait dengan hasil XML. Informasi tentang parameter terdapat dalam atribut tag—name, value, original_value—dan akan ada satu tag PARAM untuk setiap parameter yang dikirim dalam permintaan HTTP. |
||||||||||||
Atribut |
|
||||||||||||
Contoh | <PARAM name="cr" value="countryNZ" original_value="countryNZ" /> | ||||||||||||
Sub tag dari | GSP | ||||||||||||
Format Konten | Kompleks |
PU | |
---|---|
Definisi | Tag <PU> memberikan link relatif ke halaman hasil penelusuran sebelumnya. |
Contoh | <PU>/search?q=flowers&num=10&hl=id&output=xml &client=test&start=10</PU> |
Sub tag 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> |
Sub tag dari | GSP |
Format Konten | Teks |
R | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definisi | Tag <R> mengenkapsulasi detail setiap hasil penelusuran. Catatan: Definisi tag <R> untuk WebSearch lebih ketat daripada di DTD. |
|||||||||
Atribut |
|
|||||||||
Subtag | U, UE, T?, CRAWLDATE, S?, LANG?, HAS | |||||||||
Sub tag dari | RES |
RESPO | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definisi | Tag <RES> mengenkapsulasi kumpulan hasil penelusuran individual dan detail tentang hasil tersebut. |
|||||||||
Atribut |
|
|||||||||
Contoh | <RES SN="1" EN="10"> | |||||||||
Subtag | P, FI?, XT?, NB?, R* | |||||||||
Sub tag dari | GSP | |||||||||
Format Konten | Kosong |
S | |
---|---|
Definisi | Tag <S> berisi kutipan untuk hasil penelusuran yang menampilkan istilah kueri yang ditandai dengan huruf tebal. Jeda baris disertakan di dalam kutipan untuk penggabungan teks yang tepat. |
Contoh | <S>Washington (CNN) -- Sebuah tawaran untuk mengakhiri kebuntuan atas Senat atas Presiden AS & b>Bush's</b> hasil yudisial akan memungkinkan lima kandidat melaju ke pemungutan suara akhir sekaligus mempertahankan . |
Sub tag dari | R |
Format Konten | Teks (HTML) |
SL_MAIN | |
---|---|
Definisi | Tag ini mengenkapsulasi konten hasil promosi. Gunakan untuk mengurai promosi. Teks link 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*, T, U |
Sub tag dari | SL_RESULTS |
Format Konten | Kosong |
SL_RESULTS | |
---|---|
Definisi | Tag penampung 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* |
Sub tag dari | R |
Format Konten | Kosong |
Ejaan | |
---|---|
Definisi | Tag <Spelling> merangkum saran ejaan alternatif untuk kueri yang dikirimkan. Tag ini hanya muncul di halaman pertama hasil penelusuran. Saran ejaan tersedia dalam bahasa Inggris, China, Jepang, dan Korea. Catatan: Google hanya akan menampilkan saran ejaan untuk kueri dengan nilai parameter gl dalam huruf kecil. |
Contoh | <Spelling> |
Subtag | Saran |
Sub tag 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. Nilai atribut q adalah saran ejaan yang di-escape URL yang dapat Anda gunakan sebagai istilah kueri. | ||||||
Atribut |
|
||||||
Contoh | <Saran q="sepak bola"><b><i>sepak bola</i></b></Suggestion> | ||||||
Sub tag dari | Ejaan | ||||||
Format Konten | Teks (HTML) |
T | |
---|---|
Definisi | Tag <T> berisi judul hasil. |
Contoh | <T>Pizza Hut di Pantai Timur Amici</T> |
Sub tag dari | R |
Format Konten | Teks (HTML) |
title | |
---|---|
Definisi | Sebagai turunan dari <Context>, tag <title> berisi nama Programmable Search Engine Anda. Sebagai turunan dari <Facet>, tag <title> memberikan judul untuk serangkaian faset. |
Contoh | Sebagai turunan dari <Context>: <title>My Search Engine</title> Sebagai turunan dari <Facet>: <title>facet title</title> |
Sub tag dari | Context, Facet |
Format Konten | Teks |
TM | |
---|---|
Definisi | Tag <TM> mengidentifikasi total waktu server yang diperlukan untuk menampilkan hasil penelusuran, yang diukur dalam detik. |
Contoh | <TM>0,100445</TM> |
Sub tag dari | GSP |
Format Konten | Teks (Angka floating point) |
TT | |
---|---|
Definisi | Tag <TT> memberikan tips penelusuran. |
Contoh | <TT><i>Tip: Untuk sebagian besar browser, menekan tombol Return akan memberikan hasil yang sama dengan mengklik tombol Search.</i></TT> |
Sub tag dari | GSP |
U | |
---|---|
Definisi | Tag <U> menyediakan URL hasil penelusuran. |
Contoh | <U>http://www.dominos.com/</U> |
Sub tag dari | R |
Format Konten | Teks (URL Absolut) |
UD | |
---|---|
Definisi | Tag <UD> menyediakan URL yang dienkode IDN (Nama Domain Internasional) untuk hasil penelusuran. Nilai ini memungkinkan domain 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.花Localization鮨.com. Tag <UD> ini hanya akan disertakan dalam hasil penelusuran untuk permintaan yang menyertakan parameter ud. Catatan: Ini adalah fitur beta. |
Contoh | <UD>http://www.%E8%8A%B1%E4%BA%95.com/</UD> |
Sub tag dari | R |
Format Konten | Teks (URL berenkode IDN) |
UE | |
---|---|
Definisi | Tag <UE> menyediakan URL hasil penelusuran. Nilai ini di-escape URL sehingga cocok untuk diteruskan sebagai parameter kueri dalam URL. |
Contoh | <UE>http://www.dominos.com/</UE> |
Sub tag dari | R |
Format Konten | Teks (URL yang di-escape URL) |
XT | |
---|---|
Definisi | Tag <XT> menunjukkan bahwa estimasi jumlah total hasil, sebagaimana ditentukan oleh tag M, sebenarnya mewakili jumlah total hasil yang tepat. Lihat bagian Pemfilteran Otomatis pada dokumen ini untuk detail selengkapnya. |
Contoh | <XT /> |
Sub tag dari | RES |
Format Konten | Kosong |
Hasil XML untuk Kueri Penelusuran Gambar
Permintaan Gambar sampel 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 menghasilkan hasil XML di bawah ini.
<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 ini menunjukkan tag XML tambahan yang digunakan dalam respons XML untuk kueri penelusuran gambar.
Simbol-simbol tertentu dapat ditampilkan di samping beberapa subtag dalam definisi di bawah ini. Berikut adalah simbol-simbol tersebut, beserta maknanya:
* = nol atau beberapa instance subtag
+ = satu atau beberapa instance subtag
RG | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definisi | Tag <RG> menampung detail setiap hasil penelusuran gambar. |
|||||||||
Atribut |
| |||||||||
Sub tag dari | RES |
RU | |
---|---|
Definisi | Tag <RU tag> menyertakan detail setiap hasil penelusuran gambar. |
Sub tag dari | R |