File konteks menjelaskan struktur mesin telusur Anda dan menentukan perilakunya. Cara terbaik untuk mulai mempelajari file konteks adalah dengan melihat contoh sederhana. Saat membangun kepercayaan diri, Anda mungkin ingin mulai bereksperimen dengan berbagai elemen dan atribut. Anda dapat mencoba setelan di Control Panel, lalu melihat versi XML yang dihasilkan yang didownload dari halaman Overview.
Kode berikut menjelaskan mesin telusur untuk perubahan iklim. Perhatikan bahwa mesin telusur ini telah mengaktifkan penelusuran gambar.
File konteks dasar mencakup elemen utama dan elemen turunan berikut.
Elemen
Wajib
Deskripsi
CustomSearchEngine
Wajib
Menyertakan semua informasi tentang mesin telusur. Memiliki atribut berikut:
keywords. Menentukan daftar (maksimal 100 karakter) kata kunci yang dipisahkan spasi yang dikaitkan dengan mesin telusur. Jika tidak ditentukan, Programmable Search Engine akan menggunakan nilai kosong.
language. Menentukan salah satu bahasa yang didukung untuk ditampilkan di antarmuka pengguna. Menentukan bahasa akan meningkatkan hasil dalam bahasa tersebut, tetapi tidak akan memfilter hasil dalam bahasa lain. Jika tidak ditentukan, Programmable Search Engine akan menggunakan en (bahasa Inggris). Jika nilainya null, Programmable Search Engine akan menggunakan bahasa lokal pengguna Anda.
autocompletions. Menunjukkan apakah Programmable Search Engine harus membuat pelengkapan otomatis DAFTAR ISTILAH untuk mesin telusur Anda. Nilai yang diizinkan adalah true atau false. Jika true, perhatikan bahwa pembuatan pelengkapan otomatis dapat membutuhkan waktu beberapa jam. Setelah menetapkan nilai ini, Anda harus mengubah kode kotak penelusuran untuk meminta pelengkapan otomatis. Anda bisa mendapatkan kode yang diperbarui dari tab Dapatkan kode di Panel Kontrol. Hanya mesin telusur yang menelusuri situs yang menyertakan situs—kumpulan situs yang telah ditentukan—yang dapat melengkapi kueri secara otomatis.
Title
Wajib
Nama mesin telusur. Tombol ini muncul di halaman beranda Programmable Search Engine dan halaman hasil.
Description
Wajib
Teks deskriptif yang muncul di halaman ringkasan mesin telusur Anda.
Context
Wajib
Menyimpan informasi tentang label. Menyertakan elemen turunan BackgroundLabels dan Facet.
BackgroundLabels
Opsional
Penampung untuk label yang digunakan untuk mempromosikan, menyertakan, atau mengecualikan situs dan halaman. Menyertakan satu atau beberapa elemen Label turunan.
Label
Opsional
Label yang digunakan untuk mempromosikan situs atau menentukan penyertaan/pengecualian situs. Memiliki atribut berikut:
name. Nama label.
mode. FILTER (mempromosikan atau menampilkan situs pilihan secara eksklusif) atau ELIMINATE (tidak menyertakan situs). Anda dapat menyesuaikan label ini sesuai keinginan.
LookAndFeel
Wajib
Mengontrol tampilan dan nuansa mesin telusur Anda. Elemen ini memiliki beberapa atribut dan elemen turunan yang dijelaskan secara mendetail di halaman Tampilan dan Nuansa.
ImageSearchSettings
Opsional
Menentukan apakah Penelusuran Gambar diaktifkan. Memiliki atribut berikut:
enable. Menentukan apakah Penelusuran Gambar diaktifkan untuk mesin telusur ini. Nilai yang diizinkan adalah true atau false.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2024-09-12 UTC."],[[["Custom Search Ads are customized using parameters categorized by their scope: Page Level, Configuration Settings, and Unit Level."],["Page Level parameters, such as `pubId` and `query`, manage ad behavior across the entire page while Unit Level parameters control individual ad units using attributes like `container` and `width`."],["Configuration settings provide control over aspects like ad filtering (`adsafe`), testing (`adtest`), and language targeting (`hl`)."],["Optional parameters offer further customization, such as defining ad click behavior (`linkTarget`), handling ad loading events (`adLoadedCallback`), and specifying the number of ads to display (`number`)."],["Parameters like `relatedSearchTargeting` and `terms` enable the implementation of related searches, enhancing the user experience by providing relevant content suggestions."]]],[]]