Referensi API XML

Halaman ini merujuk ke versi XML dari Custom Search JSON API, yang hanya tersedia untuk pelanggan Google Site Search.

  1. Ringkasan
  2. Format Permintaan Programmable Search Engine
    1. Ringkasan Permintaan
    2. Istilah Kueri
    3. Parameter Permintaan
      1. Contoh Kueri WebSearch
      2. Definisi Parameter Kueri WebSearch
      3. Penelusuran Lanjutan
      4. Parameter Kueri Penelusuran Lanjutan
      5. Persyaratan Kueri Khusus
      6. Contoh Kueri Gambar
      7. Parameter Kueri Penelusuran Gambar
      8. Batas Permintaan
    4. Presentasi Hasil dan Kueri Internasional
      1. Encoding Karakter
      2. Bahasa Antarmuka
      3. Penelusuran China Aksara Sederhana dan Tradisional
    5. Memfilter Hasil
      1. Pemfilteran Otomatis Hasil Penelusuran
      2. Pemfilteran Bahasa dan Negara
      3. Memfilter Konten Khusus Dewasa dengan SafeSearch
  3. Hasil XML
    1. DTD Hasil XML Google
    2. Tentang Respons XML
    3. Hasil XML untuk Kueri Penelusuran Reguler, Gambar, dan Lanjutan
      1. Penelusuran Reguler/Lanjutan: Contoh Kueri dan Hasil XML
      2. Penelusuran Reguler/Lanjutan: Tag XML
      3. Hasil XML untuk Kueri Penelusuran Gambar
      4. Penelusuran Gambar: Contoh Kueri dan Hasil XML
      5. Penelusuran Gambar: Tag 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

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 ke xml_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:

  • num—jumlah hasil penelusuran yang diminta
  • q—istilah penelusuran
  • start—indeks awal untuk hasil

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 0 (nol), yang berarti bahwa fitur tersebut diaktifkan. Nilai untuk parameter c2coff adalah:

Nilai Tindakan
1 Nonaktif
0 Diaktifkan
Contoh q=google&c2coff=1

klien
Deskripsi

Wajib diisi. Parameter client harus ditetapkan ke google-csbe.
Contoh q=google&client=google-csbe

cr
Deskripsi

Opsional. Parameter cr membatasi hasil penelusuran ke dokumen yang berasal dari negara tertentu. Anda dapat menggunakan operator Boolean dalam nilai parameter cr.

Google WebSearch menentukan negara dokumen dengan menganalisis:

  • domain level teratas (TLD) dari URL dokumen
  • lokasi geografis dari alamat IP server Web

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 cx menetapkan kode unik yang mengidentifikasi mesin telusur kustom. Anda harus menentukan Programmable Search Engine menggunakan parameter cx untuk mengambil hasil penelusuran dari mesin tersebut.

Untuk menemukan nilai parameter cx, buka tab Panel Kontrol > Kode pada mesin Anda dan temukan di area teks di bagian 'Tempelkan kode ini di halaman tempat Anda ingin kotak penelusuran muncul. Hasil penelusuran akan ditampilkan pada halaman yang dihosting Google'.
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 filter adalah 1, yang menunjukkan bahwa fitur ini diaktifkan. Nilai yang valid untuk parameter ini adalah:

Nilai Tindakan
1 Nonaktif
0 Diaktifkan

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 gl adalah kode negara dua huruf. Untuk hasil WebSearch, parameter gl meningkatkan hasil penelusuran yang negara asalnya cocok dengan nilai parameter. Lihat bagian Kode Negara untuk mengetahui daftar nilai yang valid.

Menentukan parameter value gl dalam permintaan WebSearch akan meningkatkan relevansi hasil. Hal ini terutama berlaku untuk pelanggan internasional dan, bahkan lebih spesifik, untuk pelanggan di negara-negara berbahasa Inggris selain Amerika Serikat.
Contoh

Permintaan ini meningkatkan dokumen yang ditulis dalam bahasa Inggris Raya di hasil WebSearch:
q=pizza&gl=uk

hl
Deskripsi

Opsional. Parameter hl menentukan bahasa antarmuka (bahasa host) antarmuka pengguna Anda. Untuk meningkatkan performa dan kualitas hasil penelusuran, Anda sangat dianjurkan untuk menetapkan parameter ini secara eksplisit.

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 hq menambahkan istilah kueri tertentu ke kueri, seolah-olah istilah tersebut dikombinasikan dengan operator AND logis.

Contoh

Permintaan ini menelusuri 'pizza' DAN 'cheese'. Ekspresinya sama dengan q=pizza+cheese.

q=pizza&hq=cheese

ie
Deskripsi

Opsional. Parameter ie menetapkan skema encoding karakter yang harus digunakan untuk menafsirkan string kueri. Nilai ie default adalah latin1.

Lihat bagian Encoding Karakter untuk diskusi mengenai kapan Anda mungkin perlu menggunakan parameter ini.

Lihat bagian Skema Encoding Karakter untuk daftar kemungkinan nilai ie.
Contoh q=google&ie=utf8&oe=utf8
lr
Deskripsi

Opsional. Parameter lr (pembatasan bahasa) membatasi hasil penelusuran ke dokumen yang ditulis dalam bahasa 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
  • bahasa sekunder, jika ada, yang digunakan dalam teks isi dokumen

Lihat bagian Nilai Koleksi Bahasa (lr) untuk mengetahui daftar nilai yang valid untuk parameter ini.
Contoh q=Frodo&lr=lang_en

num
Deskripsi

Opsional. Parameter num mengidentifikasi jumlah hasil penelusuran yang akan ditampilkan.

Nilai num default adalah 10, dan nilai maksimum adalah 20. Jika Anda meminta lebih dari 20 hasil, hanya 20 hasil yang akan ditampilkan.

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 oe menetapkan skema encoding karakter yang harus digunakan untuk mendekode hasil XML. Nilai oe default adalah latin1.

Lihat bagian Encoding Karakter untuk diskusi mengenai kapan Anda mungkin perlu menggunakan parameter ini.

Lihat bagian Skema Encoding Karakter untuk daftar kemungkinan nilai oe.
Contoh q=google&ie=utf8&oe=utf8

hasil
Deskripsi

Wajib diisi. Parameter output menentukan format hasil XML. Satu-satunya nilai yang valid untuk parameter ini adalah xml dan xml_no_dtd. Diagram di bawah menjelaskan perbedaan parameter value ini.

Nilai Format Output
xml_no_dtd Hasil XML tidak akan menyertakan pernyataan !DOCTYPE. (Direkomendasikan)
xml Hasil XML akan berisi referensi DTD Google. Baris kedua hasil akan mengidentifikasi jenis definisi dokumen (DTD) yang digunakan hasil: 
    <!DOCTYPE GSP SYSTEM "google.dtd">
Contoh output=xml_no_dtd
output=xml

q
Deskripsi

Opsional. Parameter q menentukan kueri penelusuran yang dimasukkan oleh pengguna. Meskipun parameter ini bersifat opsional, Anda harus menentukan nilai untuk minimal salah satu parameter kueri (as_epq, as_lq, as_oq, as_q untuk mendapatkan hasil penelusuran.

Ada juga sejumlah istilah kueri khusus yang dapat digunakan sebagai bagian dari nilai parameter q. Lihat Istilah Kueri Khusus untuk daftar dan definisi istilah ini.

Panel Kontrol Google Penelusuran menyertakan laporan kueri teratas yang dikirimkan menggunakan parameter q.

Catatan: Nilai yang ditentukan untuk parameter q harus di-escape URL.
Contoh q=vacation&as_oq=london+paris

aman
Deskripsi

Opsional. Parameter safe menunjukkan cara pemfilteran hasil penelusuran untuk konten khusus dewasa dan pornografi. Nilai default untuk parameter safe adalah off. Parameter value yang valid adalah:

Nilai Tindakan
off Nonaktifkan SafeSearch
medium Aktifkan SafeSearch
high Mengaktifkan versi SafeSearch yang lebih ketat

Lihat bagian Memfilter Konten Khusus Dewasa dengan SafeSearch untuk detail selengkapnya tentang fitur ini.
Contoh q=adult&safe=high

mulai
Deskripsi

Opsional. Parameter start menunjukkan hasil pertama yang cocok yang harus disertakan dalam hasil penelusuran. Parameter start menggunakan indeks berbasis nol, yang berarti hasil pertama adalah 0, hasil kedua adalah 1, dan seterusnya.

Parameter start berfungsi bersama dengan parameter num untuk menentukan hasil penelusuran yang akan ditampilkan. Perhatikan bahwa tidak lebih dari 1.000 hasil yang akan ditampilkan untuk kueri apa pun, bahkan jika lebih dari 1.000 dokumen cocok dengan kueri tersebut, jadi setelan mulai ke 1.000 atau lebih tidak akan memberikan hasil.
Contoh start=10

sort
Deskripsi

Opsional. Parameter sort menentukan bahwa hasil diurutkan sesuai dengan ekspresi yang ditentukan. Misalnya, urutkan data berdasarkan tanggal.
Contoh

sort=date

ud
Deskripsi

Opsional. Parameter ud menunjukkan apakah respons XML harus menyertakan URL yang dienkode IDN untuk hasil penelusuran. Dengan encoding IDN (International Domain Name), domain dapat ditampilkan menggunakan bahasa lokal, misalnya:

http://www.花井鮨.com

Nilai yang valid untuk parameter ini adalah 1 (default), artinya hasil XML harus menyertakan URL yang dienkode IDN, dan 0, artinya hasil XML tidak boleh menyertakan URL yang dienkode IDN. Jika parameter ud ditetapkan ke 1, URL yang dienkode ke IDN akan muncul dalam tag UD dalam hasil XML Anda.

Jika parameter ud ditetapkan ke 0, URL dalam contoh di atas akan ditampilkan sebagai:

http://www.xn--elq438j.com.

Catatan: Ini adalah fitur beta.
Contoh q=google&ud=1

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 as_dt mengontrol apakah akan menyertakan atau mengecualikan hasil dari situs yang disebutkan dalam parameter as_sitesearch. Nilai i dan e masing-masing menunjukkan penyertaan dan pengecualian.
Contoh as_dt=i,as_dt=e

as_epq
Deskripsi

Opsional. Parameter as_epq mengidentifikasi frasa yang harus berisi semua dokumen dalam hasil penelusuran. Anda juga dapat menggunakan istilah kueri penelusuran frasa untuk menelusuri frasa.
Contoh as_epq=abraham+lincoln

as_eq
Deskripsi

Opsional. Parameter as_eq mengidentifikasi kata atau frasa yang tidak boleh muncul di dokumen apa pun dalam hasil penelusuran. Anda juga dapat menggunakan istilah kueri exclude untuk memastikan bahwa kata atau frasa tertentu tidak akan muncul di dokumen dalam kumpulan hasil penelusuran.
Contoh

q=bass&as_eq=music.

as_lq
Deskripsi

Opsional. Parameter as_lq menentukan bahwa semua hasil penelusuran harus berisi link ke URL tertentu. Anda juga dapat menggunakan istilah kueri link: untuk jenis kueri ini.

Contoh

as_lq=www.google.com

as_nlo
Deskripsi

Opsional. Parameter as_nlo menentukan nilai awal untuk rentang penelusuran. Gunakan as_nlo dan as_nhi untuk menambahkan rentang penelusuran inklusif as_nlo...as_nhi ke kueri.

Contoh

Parameter berikut menetapkan rentang penelusuran dari 5 hingga 10, inklusif:

as_nlo=5&as_nhi=10
as_nhi
Deskripsi

Opsional. Parameter as_nhi menentukan nilai akhir untuk rentang penelusuran. Gunakan as_nlo dan as_nhi untuk menambahkan rentang penelusuran inklusif as_nlo...as_nhi ke kueri.
Contoh

Parameter berikut menetapkan rentang penelusuran dari 5 hingga 10, inklusif:

as_nlo=5&as_nhi=10
as_oq
Deskripsi

Opsional. Parameter as_oq memberikan istilah penelusuran tambahan untuk diperiksa dalam dokumen, di mana setiap dokumen dalam hasil penelusuran harus berisi setidaknya salah satu istilah penelusuran tambahan. Anda juga dapat menggunakan istilah kueri Boolean OR untuk jenis kueri ini.
Contoh

q=vacation&as_oq=London+Paris

as_q
Deskripsi

Opsional. Parameter as_q menyediakan istilah penelusuran yang akan diperiksa dalam dokumen. Parameter ini juga biasa digunakan untuk memungkinkan pengguna menentukan istilah tambahan yang akan ditelusuri dalam sekumpulan hasil penelusuran.
Contoh

q=president&as_q=John+Adams

as_qdr
Deskripsi

Opsional. Parameter as_qdr meminta hasil penelusuran dari jangka waktu tertentu (rentang tanggal cepat). Nilai-nilai berikut didukung:

d[number] meminta hasil dari jumlah hari terakhir yang ditentukan.
w[number] meminta hasil dari jumlah yang ditentukan dalam beberapa minggu terakhir.
m[number] meminta hasil dari jumlah yang ditentukan dalam beberapa bulan terakhir.
y[number] meminta hasil dari jumlah yang ditentukan pada tahun-tahun sebelumnya.
Contoh

Contoh ini meminta hasil dari setahun terakhir:

as_qdr=y

Contoh permintaan berikut ini dihasilkan dari 10 hari terakhir:

as_qdr=d10
as_sitesearch
Deskripsi

Opsional. Parameter as_sitesearch memungkinkan Anda menentukan bahwa semua hasil penelusuran harus berupa halaman dari situs tertentu. Dengan menyetel parameter as_dt, Anda juga dapat menggunakannya untuk mengecualikan halaman dari situs tertentu dari hasil penelusuran.
Contoh

q=vacation&as_sitesearch=www.google.com

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 link: memperoleh kumpulan halaman Web yang tertaut ke URL tertentu. Kueri penelusuran harus diformat sebagai link:URL tanpa spasi di antara istilah kueri link: dan URL.

Versi link: yang di-escape URL adalah link%3A.

Anda juga dapat menggunakan parameter permintaan as_lq untuk mengirim permintaan link:.

Catatan: Anda tidak dapat menentukan istilah kueri lain saat menggunakan link:.
Contoh

http://www.google.com/search?q=link%3Awww.example.com

Boolean OR Penelusuran [ OR ]
Deskripsi

Istilah kueri OR mengambil dokumen yang menyertakan salah satu dari serangkaian (dua atau beberapa) istilah kueri. Untuk menggunakan istilah kueri OR, masukkan istilah penelusuran OR, dalam huruf besar, di antara setiap istilah dalam deret.

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 (-) membatasi hasil untuk permintaan penelusuran tertentu ke dokumen yang tidak berisi kata atau frasa tertentu. Untuk menggunakan istilah kueri pengecualian, Anda perlu mengawali kata atau frasa yang akan dikecualikan dari dokumen yang cocok dengan "-" (tanda minus).

Versi - yang di-escape URL adalah %2D.

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 -filetype: mengecualikan dokumen dengan ekstensi file tertentu, seperti ".pdf" atau ".doc" dari hasil penelusuran. Kueri penelusuran harus diformat sebagai -filetype:EXTENSION tanpa spasi di antara istilah kueri -filetype: dan ekstensi yang ditentukan.

Versi -filetype: yang di-escape URL adalah %2Dfiletype%3A.

Catatan: Anda dapat mengecualikan beberapa jenis file dari hasil penelusuran dengan menambahkan lebih banyak istilah kueri -filetype: ke kueri Anda. Anda harus memiliki satu istilah kueri -filetype: dalam kueri penelusuran untuk setiap ekstensi file yang harus dikecualikan dari hasil penelusuran.

Jenis file yang didukung oleh Google meliputi:

  • Format Dokumen Portabel Adobe (pdf)
  • Adobe PostScript (ps)
  • Lotus 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)
  • Lotus WordPro (lwp)
  • Macwrite (mW)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (dokumen)
  • Microsoft Works (wks, wps, wdb)
  • Microsoft Write (wri)
  • Format Teks Kaya (rtf)
  • Shockwave Flash (swf)
  • Teks (ans, txt).

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:
q=Google+%2Dfiletype%3Apdf

Contoh ini menampilkan dokumen yang menyebutkan "Google", tetapi mengecualikan dokumen PDF dan Word:
q=Google+%2Dfiletype%3Apdf+%2Dfiletype%3Adoc

Pemfilteran Jenis File [ filetype: ]
Deskripsi

Istilah kueri filetype: membatasi hasil penelusuran pada dokumen dengan ekstensi file tertentu, seperti ".pdf" atau ".doc". Kueri penelusuran harus diformat sebagai filetype:EXTENSION tanpa spasi antara istilah kueri filetype: dan ekstensi yang ditentukan.

Versi filetype: yang di-escape URL adalah filetype%3A.

Anda dapat membatasi hasil penelusuran ke dokumen yang cocok dengan salah satu dari beberapa ekstensi file dengan menambahkan lebih banyak istilah kueri filetype: ke kueri Anda. Anda harus memiliki satu istilah kueri filetype: di kueri penelusuran untuk setiap ekstensi file yang harus disertakan dalam hasil penelusuran. Beberapa istilah kueri filetype: harus dipisahkan menggunakan istilah kueri OR.

Secara default, hasil penelusuran akan menyertakan dokumen dengan ekstensi file apa pun.

Jenis file yang didukung oleh Google meliputi:

  • Format Dokumen Portabel Adobe (pdf)
  • Adobe PostScript (ps)
  • Lotus 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)
  • Lotus WordPro (lwp)
  • Macwrite (mW)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (dokumen)
  • Microsoft Works (wks, wps, wdb)
  • Microsoft Write (wri)
  • Format Teks Kaya (rtf)
  • Shockwave Flash (swf)
  • Teks (ans, txt).

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":
q=Google+filetype%3Apdf

Contoh ini menampilkan dokumen PDF dan Word yang menyebutkan "Google":
q=Google+filetype%3Apdf+OR+filetype%3Adoc

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 + yang di-escape URL (tanda plus) adalah %2B.

Anda harus menggunakan + sebelum kata umum yang biasanya dihapus oleh Google sebelum mengidentifikasi hasil penelusuran.
Contoh Input pengguna: Star Wars Episode +I
Istilah kueri: q=Star+Wars+Episode+%2BI

Penelusuran Hanya Link, semua istilah [ allinlinks: ]
Deskripsi

Istilah kueri allinlinks: mengharuskan dokumen dalam hasil penelusuran berisi semua kata dalam kueri penelusuran di link URL. Kueri penelusuran harus diformat sebagai allinlinks: yang diikuti dengan kata-kata dalam kueri penelusuran Anda.

Jika kueri penelusuran Anda menyertakan istilah kueri allinlinks:, Google hanya akan memeriksa link URL dalam dokumen untuk menemukan kata dalam kueri penelusuran Anda, dengan mengabaikan teks lain dalam dokumen, judul dokumen, dan URL setiap dokumen. Perlu diperhatikan bahwa URL dokumen berbeda dengan link URL yang terdapat dalam dokumen.

Versi allinlinks: yang di-escape URL adalah allinlinks%3A.
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 " yang di-escape URL (tanda kutip) adalah %22.

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 allintext: mengharuskan setiap dokumen di hasil penelusuran berisi semua kata yang ada dalam kueri penelusuran di isi dokumen. Kueri harus diformat sebagai allintext: yang diikuti dengan kata-kata dalam kueri penelusuran Anda.

Jika kueri penelusuran Anda menyertakan istilah kueri allintext:, Google hanya akan memeriksa teks isi dokumen untuk kata-kata dalam kueri penelusuran Anda, dengan mengabaikan link dalam dokumen, judul dokumen, dan URL dokumen tersebut.

Versi allintext: yang di-escape URL adalah allintext%3A.
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 intitle: membatasi hasil penelusuran pada dokumen yang berisi kata tertentu dalam judul dokumen. Kueri penelusuran harus diformat sebagai intitle:WORD tanpa spasi di antara istilah kueri intitle: dan kata berikutnya.

Catatan: Anda dapat menentukan lebih dari satu kata yang harus disertakan dalam judul dokumen dengan menempatkan istilah kueri intitle: di depan setiap kata tersebut. Anda juga dapat menggunakan istilah kueri allintitle: untuk menentukan bahwa semua kata kueri harus disertakan dalam judul dokumen yang ada di hasil penelusuran.

Versi intitle: yang di-escape URL adalah intitle%3A.
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:
Input pengguna:intitle:Google search
Istilah kueri:q=intitle%3AGoogle+search

Penelusuran Judul, semua istilah [allintitle:]
Deskripsi

Istilah kueri allintitle: membatasi hasil penelusuran pada dokumen yang berisi semua kata kueri dalam judul dokumen. Untuk menggunakan istilah kueri allintitle:, sertakan "allintitle:" di awal kueri penelusuran.

Catatan: Menempatkan allintitle: di awal kueri penelusuran sama dengan menempatkan intitle: di depan setiap kata dalam kueri penelusuran.

Versi allintitle: yang di-escape URL adalah allintitle%3A.
Contoh

Contoh ini menetapkan bahwa kata "Google" dan "penelusuran" harus muncul dalam judul dokumen apa pun di hasil penelusuran:
Input pengguna: allintitle: Google search
Istilah kueri: q=allintitle%3A+Google+search

Penelusuran URL, istilah tunggal [inurl:]
Deskripsi

Istilah kueri inurl: membatasi hasil penelusuran pada dokumen yang berisi kata tertentu dalam URL dokumen. Kueri penelusuran harus diformat sebagai inurl:WORD tanpa spasi di antara istilah kueri inurl: dan kata berikutnya.

Istilah kueri inurl: mengabaikan tanda baca dan hanya menggunakan kata pertama setelah operator inurl:. Anda dapat menentukan lebih dari satu kata yang harus disertakan dalam URL dokumen dengan menempatkan istilah kueri inurl: di depan setiap kata tersebut. Anda juga dapat menggunakan istilah kueri allinurl: untuk menentukan bahwa semua kata kueri harus disertakan di URL dokumen yang ada di hasil penelusuran.

Versi inurl: yang di-escape URL adalah inurl%3A.
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:
Input pengguna: inurl:Google search
Istilah kueri: q=inurl%3AGoogle+search

Penelusuran URL, semua istilah [allinurl:]
Deskripsi

Istilah kueri allinurl: membatasi hasil penelusuran pada dokumen yang berisi semua kata kueri dalam URL dokumen. Untuk menggunakan istilah kueri allinurl:, sertakan allinurl: di awal kueri penelusuran Anda.

Istilah kueri allinurl: mengabaikan tanda baca, sehingga hanya berfungsi pada kata, bukan pada komponen URL. Misalnya, allinurl: uk/scotland akan membatasi hasil pada dokumen yang berisi kata "uk" dan "skotlandia" di URL-nya, tetapi tidak akan mewajibkan kedua kata tersebut muncul dalam urutan tertentu atau dipisahkan dengan garis miring.

Versi allinurl: yang di-escape URL adalah allinurl%3A.
Contoh

Contoh ini menetapkan bahwa kata "Google" dan "penelusuran" harus muncul di URL dokumen apa pun di hasil penelusuran:
Input pengguna: allinurl: Google search
Istilah kueri: q=allinurl%3A+Google+search


Info Dokumen Web [info:]
Deskripsi

Istilah kueri info: mengambil informasi umum tentang URL selama URL tersebut disertakan dalam indeks penelusuran Google. Kueri penelusuran harus diformat sebagai info:URL tanpa spasi antara istilah kueri info: dan URL.

Versi info: yang di-escape URL adalah info%3A.

Catatan: Anda tidak dapat menentukan istilah kueri lain saat menggunakan info:.
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: bmp, gif, png, jpg, dan svg.
Contoh q=google&as_filetype=png

!
Deskripsi

Opsional. Menampilkan gambar dengan ukuran tertentu, dengan ukuran dapat berupa salah satu dari:

  • icon (kecil)
  • small|medium|large|xlarge (sedang)
  • xxlarge (besar)
  • huge (ekstra besar)

Contoh q=google&as_filetype=png&imgsz=icon

jenis gambar
Deskripsi

Opsional. Menampilkan gambar berjenis, yang dapat berupa salah satu dari:

  • clipart (gambar klip)
  • face (wajah)
  • lineart (linear)
  • news (berita)
  • photo (foto)
Contoh q=google&as_filetype=png&imgtype=photo

gambar
Deskripsi

Opsional. Menampilkan gambar hitam dan putih, hitam putih, atau berwarna:

  • mono (hitam dan putih)
  • gray (skala abu-abu)
  • color (warna)
Contoh q=google&as_filetype=png&imgc=gray

warnaimg
Deskripsi

Opsional. Menampilkan gambar dengan warna dominan tertentu:

  • yellow
  • green
  • teal
  • blue
  • purple
  • pink
  • white
  • gray
  • black
  • brown
Contoh q=google&as_filetype=png&imgcolor=yellow

as_rights
Deskripsi

Opsional. Filter berdasarkan pemberian lisensi. Nilai yang didukung meliputi:

  • cc_publicdomain
  • cc_attribute
  • cc_sharealike
  • cc_noncommercial
  • cc_nonderived
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.

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:

  1. Setel parameter permintaan c2coff ke 0
    dan
  2. Lakukan salah satu tindakan berikut:
    • Jangan tetapkan parameter permintaan lr
      atau
    • Setel parameter permintaan lr ke lr=lang_zh-TW|lang_zh-CN

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

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

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 "&amp;". Standar XML mendokumentasikan karakter tersebut; karakter tersebut direproduksi pada tabel di bawah:

    Karakter Formulir yang Di-escape Entitas Kode Karakter
    Ampersand & &amp; &#38;
    Petik Satu ' &apos; &#39;
    Petik Dua " &quot; &#34;
    Lebih Dari > &gt; &#62;
    Kurang Dari < &lt; &#60;

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:

? = subtag opsional
* = 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
Nama Format Deskripsi
SZ Teks (Bilangan Bulat + "k") Memberikan ukuran versi hasil penelusuran yang di-cache dalam kilobyte ("k").
CID Teks Mengidentifikasi dokumen dalam cache Google. Untuk mengambil dokumen dari cache, kirim istilah penelusuran yang dibuat sebagai berikut:
cache:CIDtext:escapedURL

URL yang di-escape tersedia di tag UE.
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. CRAWLDATE tidak ditampilkan untuk setiap halaman hasil penelusuran.
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 &lt;b&gt;football&lt;/b&gt; 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
Nama Format Deskripsi
VERSI Teks (Bilangan Bulat) Atribut VER menentukan versi output hasil penelusuran. Versi output saat ini adalah "3.2".
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
filter search results about Palm Springs:
    q=Palm+Springs+more:golf_courses

The URL-escaped version of this query is:
    q=Palm+Springs+more%3Agolf_courses

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
Nama Format Deskripsi
name Teks Nama parameter input.
value HTML Versi format HTML dari nilai parameter input.
original_value Teks Versi asli URL yang di-escape dari nilai parameter input.
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
Nama Format Deskripsi
N Teks (Bilangan Bulat) Menunjukkan indeks (berbasis 1) dari hasil penelusuran ini.
MIME Teks Menunjukkan jenis MIME hasil penelusuran.
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
Nama Format Deskripsi
SN Teks (Bilangan Bulat) Menunjukkan indeks (berbasis 1) dari hasil penelusuran pertama yang ditampilkan dalam set hasil ini.
ID Teks (Bilangan Bulat) Menunjukkan indeks (berbasis 1) dari hasil penelusuran terakhir yang ditampilkan dalam set hasil ini.
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&gt;Bush&#39;s&lt;/b&gt; 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
Nama Format Deskripsi
q Teks Atribut q menentukan versi URL-di-escape dari saran ejaan.
Contoh <Saran q="sepak bola">&lt;b&gt;&lt;i&gt;sepak bola&lt;/i&gt;&lt;/b&gt;</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>&lt;i&gt;Tip: Untuk sebagian besar browser, menekan tombol Return akan memberikan hasil yang sama dengan mengklik tombol Search.&lt;/i&gt;</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:

? = subtag opsional
* = nol atau beberapa instance subtag
+ = satu atau beberapa instance subtag

RG
Definisi

Tag <RG> menampung detail setiap hasil penelusuran gambar.
Atribut
Nama Format Deskripsi
N Teks (Bilangan Bulat) Menunjukkan indeks (berbasis 1) dari hasil penelusuran ini.
MIME Teks Menunjukkan jenis MIME hasil penelusuran.
Sub tag dari RES
RU
Definisi

Tag <RU tag> menyertakan detail setiap hasil penelusuran gambar.
Sub tag dari R