Search

Respons terhadap permintaan penelusuran kustom.

Representasi JSON
{
  "kind": string,
  "url": {
    "type": string,
    "template": string
  },
  "queries": {
    "previousPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "request": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "nextPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ]
  },
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "context": {
    object
  },
  "searchInformation": {
    "searchTime": number,
    "formattedSearchTime": string,
    "totalResults": string,
    "formattedTotalResults": string
  },
  "spelling": {
    "correctedQuery": string,
    "htmlCorrectedQuery": string
  },
  "items": [
    {
      object (Result)
    }
  ]
}
Kolom
kind

string

ID unik untuk jenis objek saat ini. Untuk API ini adalah customsearch#search.

url

object

Elemen URL OpenSearch yang menentukan template untuk API ini.

url.type

string

Jenis MIME template URL OpenSearch untuk Custom Search JSON API.

url.template

string

Template OpenSearch sebenarnya untuk API ini.

queries

object

Berisi satu atau beberapa kumpulan metadata kueri, yang dikunci berdasarkan nama peran. Nama peran yang mungkin mencakup request yang ditentukan oleh peran kueri OpenSearch dan dua peran khusus: nextPage dan previousPage.

queries.previousPage[]

object

Metadata yang mewakili halaman hasil sebelumnya, jika ada.

queries.previousPage[].title

string

Deskripsi kueri.

queries.previousPage[].totalResults

string (int64 format)

Estimasi jumlah total hasil penelusuran. Mungkin tidak akurat.

queries.previousPage[].searchTerms

string

Istilah penelusuran yang dimasukkan oleh pengguna.

queries.previousPage[].count

integer

Jumlah hasil penelusuran yang ditampilkan dalam kumpulan ini.

queries.previousPage[].startIndex

integer

Indeks kumpulan hasil penelusuran saat ini ke dalam kumpulan total hasil, dengan indeks hasil pertama adalah 1.

queries.previousPage[].startPage

integer

Nomor halaman dari kumpulan hasil ini, dengan panjang halaman ditetapkan oleh properti count.

queries.previousPage[].language

string

Bahasa hasil penelusuran.

queries.previousPage[].inputEncoding

string

Encoding karakter didukung untuk permintaan penelusuran.

queries.previousPage[].outputEncoding

string

Encoding karakter didukung untuk hasil penelusuran.

queries.previousPage[].safe

string

Menentukan tingkat SafeSearch yang digunakan untuk memfilter hasil khusus dewasa. Ini adalah properti khusus yang tidak didefinisikan dalam spesifikasi OpenSearch. Nilai parameter yang valid adalah:

  • "off": Menonaktifkan SafeSearch

  • "active": Mengaktifkan SafeSearch

queries.previousPage[].cx

string

ID mesin yang dibuat menggunakan Control Panel Programmable Search Engine. Ini adalah properti khusus yang tidak ditentukan dalam spesifikasi OpenSearch. Parameter ini wajib.

queries.previousPage[].sort

string

Menentukan bahwa hasil harus diurutkan sesuai dengan ekspresi yang ditentukan. Misalnya, urutkan data berdasarkan tanggal.

queries.previousPage[].filter

string

Mengaktifkan atau menonaktifkan pemfilteran otomatis hasil penelusuran Google. Lihat Pemfilteran Otomatis untuk informasi lebih lanjut tentang filter hasil penelusuran Google. Nilai yang valid untuk parameter ini adalah:

  • 0: Nonaktif

  • 1: Diaktifkan (default)

Catatan: Secara default, Google menerapkan pemfilteran ke semua hasil penelusuran guna meningkatkan kualitas hasil tersebut.

queries.previousPage[].gl

string

Meningkatkan hasil penelusuran yang negara asalnya cocok dengan nilai parameter. Lihat Kode Negara untuk melihat daftar nilai yang valid.

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

queries.previousPage[].cr

string

Membatasi hasil penelusuran pada dokumen yang berasal dari negara tertentu. Anda dapat menggunakan operator Boolean dalam nilai parameter cr.

Google WebSearch menentukan negara dokumen dengan menganalisis hal-hal berikut:

  • Domain level teratas (TLD) dari URL dokumen.

  • Lokasi geografis dari alamat IP server web.

Lihat Nilai Parameter Negara (cr) untuk mengetahui daftar nilai yang valid untuk parameter ini.

queries.previousPage[].googleHost

string

Menentukan domain Google (misalnya, google.com, google.de, atau google.fr) yang harus dibatasi penelusurannya.

queries.previousPage[].disableCnTwTranslation

string

Mengaktifkan atau menonaktifkan fitur Penelusuran China Aksara Sederhana dan Tradisional.

Nilai yang didukung adalah:

  • 0: diaktifkan (default)

  • 1: dinonaktifkan

queries.previousPage[].hq

string

Menambahkan istilah kueri yang ditentukan ke kueri, seolah-olah istilah tersebut digabungkan dengan operator AND yang logis.

queries.previousPage[].hl

string

Menentukan bahasa antarmuka (bahasa host) antarmuka pengguna Anda. Menetapkan parameter ini secara eksplisit akan meningkatkan performa dan kualitas hasil penelusuran Anda.

Lihat bagian Bahasa Antarmuka dalam Presentasi Hasil dan Kueri Internasionalisasi untuk informasi selengkapnya, dan Bahasa Antarmuka yang Didukung untuk daftar bahasa yang didukung.

queries.previousPage[].siteSearch

string

Membatasi hasil ke URL dari situs tertentu.

queries.previousPage[].siteSearchFilter

string

Menentukan apakah akan menyertakan atau mengecualikan hasil dari situs yang disebutkan dalam parameter sitesearch. Nilai yang didukung adalah:

  • i: mencakup konten dari situs

  • e: mengecualikan konten dari situs

queries.previousPage[].exactTerms

string

Mengidentifikasi frasa yang harus berisi semua dokumen dalam hasil penelusuran.

queries.previousPage[].excludeTerms

string

Mengidentifikasi kata atau frasa yang tidak boleh muncul di dokumen apa pun di hasil penelusuran.

queries.previousPage[].linkSite

string

Menentukan bahwa semua hasil harus berisi link ke URL tertentu.

queries.previousPage[].orTerms

string

Memberikan istilah penelusuran tambahan untuk diperiksa dalam dokumen, dan 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.

queries.previousPage[].relatedSite

string

Menentukan bahwa semua hasil penelusuran harus berupa halaman yang terkait dengan URL yang ditentukan. Nilai parameter harus berupa URL.

queries.previousPage[].dateRestrict

string

Membatasi hasil ke URL berdasarkan tanggal. Nilai yang didukung meliputi:

  • 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 dalam beberapa tahun sebelumnya.

queries.previousPage[].lowRange

string

Menentukan nilai awal untuk rentang penelusuran. Gunakan cse:lowRange dan cse:highrange untuk menambahkan rentang penelusuran inklusif lowRange...highRange ke kueri.

queries.previousPage[].highRange

string

Menentukan nilai akhir untuk rentang penelusuran. Gunakan cse:lowRange dan cse:highrange untuk menambahkan rentang penelusuran inklusif lowRange...highRange ke kueri.

queries.previousPage[].fileType

string

Membatasi hasil ke file dengan ekstensi tertentu. 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 (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Format Teks Kaya (rtf)

  • Flash Gelombang Kejut (swf)

  • Teks (ans, txt).

Jenis file lainnya dapat ditambahkan di masa mendatang. Daftar terbaru selalu dapat ditemukan di FAQ jenis file Google.

queries.previousPage[].rights

string

Filter berdasarkan pemberian lisensi. Nilai yang didukung meliputi:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.previousPage[].searchType

string

Nilai yang diizinkan adalah web atau image. Jika tidak ditentukan, hasil akan dibatasi pada halaman web.

queries.previousPage[].imgSize

string

Membatasi hasil ke gambar dengan ukuran tertentu. Nilai yang didukung adalah:

  • icon (kecil)

  • small | medium | large | xlarge (sedang)

  • xxlarge (besar)

  • huge (ekstra besar)

queries.previousPage[].imgType

string

Membatasi hasil ke gambar dari jenis tertentu. Nilai yang didukung adalah:

  • clipart (Gambar klip)

  • face (Wajah)

  • lineart (Gambar garis)

  • photo (Foto)

  • animated (Animasi)

  • stock (Saham)

queries.previousPage[].imgColorType

string

Membatasi hasil ke gambar dengan jenis warna yang ditentukan. Nilai yang didukung adalah:

  • mono (hitam dan putih)

  • gray (skala abu-abu)

  • color (warna)

queries.previousPage[].imgDominantColor

string

Membatasi hasil pada gambar dengan warna dominan tertentu. Nilai yang didukung adalah:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.request[]

object

Metadata yang mewakili permintaan saat ini.

queries.request[].title

string

Deskripsi kueri.

queries.request[].totalResults

string (int64 format)

Estimasi jumlah total hasil penelusuran. Mungkin tidak akurat.

queries.request[].searchTerms

string

Istilah penelusuran yang dimasukkan oleh pengguna.

queries.request[].count

integer

Jumlah hasil penelusuran yang ditampilkan dalam kumpulan ini.

queries.request[].startIndex

integer

Indeks kumpulan hasil penelusuran saat ini ke dalam kumpulan total hasil, dengan indeks hasil pertama adalah 1.

queries.request[].startPage

integer

Nomor halaman dari kumpulan hasil ini, dengan panjang halaman ditetapkan oleh properti count.

queries.request[].language

string

Bahasa hasil penelusuran.

queries.request[].inputEncoding

string

Encoding karakter didukung untuk permintaan penelusuran.

queries.request[].outputEncoding

string

Encoding karakter didukung untuk hasil penelusuran.

queries.request[].safe

string

Menentukan tingkat SafeSearch yang digunakan untuk memfilter hasil khusus dewasa. Ini adalah properti khusus yang tidak didefinisikan dalam spesifikasi OpenSearch. Nilai parameter yang valid adalah:

  • "off": Menonaktifkan SafeSearch

  • "active": Mengaktifkan SafeSearch

queries.request[].cx

string

ID mesin yang dibuat menggunakan Control Panel Programmable Search Engine. Ini adalah properti khusus yang tidak ditentukan dalam spesifikasi OpenSearch. Parameter ini wajib.

queries.request[].sort

string

Menentukan bahwa hasil harus diurutkan sesuai dengan ekspresi yang ditentukan. Misalnya, urutkan data berdasarkan tanggal.

queries.request[].filter

string

Mengaktifkan atau menonaktifkan pemfilteran otomatis hasil penelusuran Google. Lihat Pemfilteran Otomatis untuk informasi lebih lanjut tentang filter hasil penelusuran Google. Nilai yang valid untuk parameter ini adalah:

  • 0: Nonaktif

  • 1: Diaktifkan (default)

Catatan: Secara default, Google menerapkan pemfilteran ke semua hasil penelusuran guna meningkatkan kualitas hasil tersebut.

queries.request[].gl

string

Meningkatkan hasil penelusuran yang negara asalnya cocok dengan nilai parameter. Lihat Kode Negara untuk melihat daftar nilai yang valid.

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

queries.request[].cr

string

Membatasi hasil penelusuran pada dokumen yang berasal dari negara tertentu. Anda dapat menggunakan operator Boolean dalam nilai parameter cr.

Google WebSearch menentukan negara dokumen dengan menganalisis hal-hal berikut:

  • Domain level teratas (TLD) dari URL dokumen.

  • Lokasi geografis dari alamat IP server web.

Lihat Nilai Parameter Negara (cr) untuk mengetahui daftar nilai yang valid untuk parameter ini.

queries.request[].googleHost

string

Menentukan domain Google (misalnya, google.com, google.de, atau google.fr) yang harus dibatasi penelusurannya.

queries.request[].disableCnTwTranslation

string

Mengaktifkan atau menonaktifkan fitur Penelusuran China Aksara Sederhana dan Tradisional.

Nilai yang didukung adalah:

  • 0: diaktifkan (default)

  • 1: dinonaktifkan

queries.request[].hq

string

Menambahkan istilah kueri yang ditentukan ke kueri, seolah-olah istilah tersebut digabungkan dengan operator AND yang logis.

queries.request[].hl

string

Menentukan bahasa antarmuka (bahasa host) antarmuka pengguna Anda. Menetapkan parameter ini secara eksplisit akan meningkatkan performa dan kualitas hasil penelusuran Anda.

Lihat bagian Bahasa Antarmuka dalam Presentasi Hasil dan Kueri Internasionalisasi untuk informasi selengkapnya, dan Bahasa Antarmuka yang Didukung untuk daftar bahasa yang didukung.

queries.request[].siteSearch

string

Membatasi hasil ke URL dari situs tertentu.

queries.request[].siteSearchFilter

string

Menentukan apakah akan menyertakan atau mengecualikan hasil dari situs yang disebutkan dalam parameter sitesearch. Nilai yang didukung adalah:

  • i: mencakup konten dari situs

  • e: mengecualikan konten dari situs

queries.request[].exactTerms

string

Mengidentifikasi frasa yang harus berisi semua dokumen dalam hasil penelusuran.

queries.request[].excludeTerms

string

Mengidentifikasi kata atau frasa yang tidak boleh muncul di dokumen apa pun di hasil penelusuran.

queries.request[].linkSite

string

Menentukan bahwa semua hasil harus berisi link ke URL tertentu.

queries.request[].orTerms

string

Memberikan istilah penelusuran tambahan untuk diperiksa dalam dokumen, dan 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.

queries.request[].relatedSite

string

Menentukan bahwa semua hasil penelusuran harus berupa halaman yang terkait dengan URL yang ditentukan. Nilai parameter harus berupa URL.

queries.request[].dateRestrict

string

Membatasi hasil ke URL berdasarkan tanggal. Nilai yang didukung meliputi:

  • 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 dalam beberapa tahun sebelumnya.

queries.request[].lowRange

string

Menentukan nilai awal untuk rentang penelusuran. Gunakan cse:lowRange dan cse:highrange untuk menambahkan rentang penelusuran inklusif lowRange...highRange ke kueri.

queries.request[].highRange

string

Menentukan nilai akhir untuk rentang penelusuran. Gunakan cse:lowRange dan cse:highrange untuk menambahkan rentang penelusuran inklusif lowRange...highRange ke kueri.

queries.request[].fileType

string

Membatasi hasil ke file dengan ekstensi tertentu. 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 (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Format Teks Kaya (rtf)

  • Flash Gelombang Kejut (swf)

  • Teks (ans, txt).

Jenis file lainnya dapat ditambahkan di masa mendatang. Daftar terbaru selalu dapat ditemukan di FAQ jenis file Google.

queries.request[].rights

string

Filter berdasarkan pemberian lisensi. Nilai yang didukung meliputi:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.request[].searchType

string

Nilai yang diizinkan adalah web atau image. Jika tidak ditentukan, hasil akan dibatasi pada halaman web.

queries.request[].imgSize

string

Membatasi hasil ke gambar dengan ukuran tertentu. Nilai yang didukung adalah:

  • icon (kecil)

  • small | medium | large | xlarge (sedang)

  • xxlarge (besar)

  • huge (ekstra besar)

queries.request[].imgType

string

Membatasi hasil ke gambar dari jenis tertentu. Nilai yang didukung adalah:

  • clipart (Gambar klip)

  • face (Wajah)

  • lineart (Gambar garis)

  • photo (Foto)

  • animated (Animasi)

  • stock (Saham)

queries.request[].imgColorType

string

Membatasi hasil ke gambar dengan jenis warna yang ditentukan. Nilai yang didukung adalah:

  • mono (hitam dan putih)

  • gray (skala abu-abu)

  • color (warna)

queries.request[].imgDominantColor

string

Membatasi hasil pada gambar dengan warna dominan tertentu. Nilai yang didukung adalah:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.nextPage[]

object

Metadata yang mewakili halaman hasil berikutnya, jika ada.

queries.nextPage[].title

string

Deskripsi kueri.

queries.nextPage[].totalResults

string (int64 format)

Estimasi jumlah total hasil penelusuran. Mungkin tidak akurat.

queries.nextPage[].searchTerms

string

Istilah penelusuran yang dimasukkan oleh pengguna.

queries.nextPage[].count

integer

Jumlah hasil penelusuran yang ditampilkan dalam kumpulan ini.

queries.nextPage[].startIndex

integer

Indeks kumpulan hasil penelusuran saat ini ke dalam kumpulan total hasil, dengan indeks hasil pertama adalah 1.

queries.nextPage[].startPage

integer

Nomor halaman dari kumpulan hasil ini, dengan panjang halaman ditetapkan oleh properti count.

queries.nextPage[].language

string

Bahasa hasil penelusuran.

queries.nextPage[].inputEncoding

string

Encoding karakter didukung untuk permintaan penelusuran.

queries.nextPage[].outputEncoding

string

Encoding karakter didukung untuk hasil penelusuran.

queries.nextPage[].safe

string

Menentukan tingkat SafeSearch yang digunakan untuk memfilter hasil khusus dewasa. Ini adalah properti khusus yang tidak didefinisikan dalam spesifikasi OpenSearch. Nilai parameter yang valid adalah:

  • "off": Menonaktifkan SafeSearch

  • "active": Mengaktifkan SafeSearch

queries.nextPage[].cx

string

ID mesin yang dibuat menggunakan Control Panel Programmable Search Engine. Ini adalah properti khusus yang tidak ditentukan dalam spesifikasi OpenSearch. Parameter ini wajib.

queries.nextPage[].sort

string

Menentukan bahwa hasil harus diurutkan sesuai dengan ekspresi yang ditentukan. Misalnya, urutkan data berdasarkan tanggal.

queries.nextPage[].filter

string

Mengaktifkan atau menonaktifkan pemfilteran otomatis hasil penelusuran Google. Lihat Pemfilteran Otomatis untuk informasi lebih lanjut tentang filter hasil penelusuran Google. Nilai yang valid untuk parameter ini adalah:

  • 0: Nonaktif

  • 1: Diaktifkan (default)

Catatan: Secara default, Google menerapkan pemfilteran ke semua hasil penelusuran guna meningkatkan kualitas hasil tersebut.

queries.nextPage[].gl

string

Meningkatkan hasil penelusuran yang negara asalnya cocok dengan nilai parameter. Lihat Kode Negara untuk melihat daftar nilai yang valid.

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

queries.nextPage[].cr

string

Membatasi hasil penelusuran pada dokumen yang berasal dari negara tertentu. Anda dapat menggunakan operator Boolean dalam nilai parameter cr.

Google WebSearch menentukan negara dokumen dengan menganalisis hal-hal berikut:

  • Domain level teratas (TLD) dari URL dokumen.

  • Lokasi geografis dari alamat IP server web.

Lihat Nilai Parameter Negara (cr) untuk mengetahui daftar nilai yang valid untuk parameter ini.

queries.nextPage[].googleHost

string

Menentukan domain Google (misalnya, google.com, google.de, atau google.fr) yang harus dibatasi penelusurannya.

queries.nextPage[].disableCnTwTranslation

string

Mengaktifkan atau menonaktifkan fitur Penelusuran China Aksara Sederhana dan Tradisional.

Nilai yang didukung adalah:

  • 0: diaktifkan (default)

  • 1: dinonaktifkan

queries.nextPage[].hq

string

Menambahkan istilah kueri yang ditentukan ke kueri, seolah-olah istilah tersebut digabungkan dengan operator AND yang logis.

queries.nextPage[].hl

string

Menentukan bahasa antarmuka (bahasa host) antarmuka pengguna Anda. Menetapkan parameter ini secara eksplisit akan meningkatkan performa dan kualitas hasil penelusuran Anda.

Lihat bagian Bahasa Antarmuka dalam Presentasi Hasil dan Kueri Internasionalisasi untuk informasi selengkapnya, dan Bahasa Antarmuka yang Didukung untuk daftar bahasa yang didukung.

queries.nextPage[].siteSearch

string

Membatasi hasil ke URL dari situs tertentu.

queries.nextPage[].siteSearchFilter

string

Menentukan apakah akan menyertakan atau mengecualikan hasil dari situs yang disebutkan dalam parameter sitesearch. Nilai yang didukung adalah:

  • i: mencakup konten dari situs

  • e: mengecualikan konten dari situs

queries.nextPage[].exactTerms

string

Mengidentifikasi frasa yang harus berisi semua dokumen dalam hasil penelusuran.

queries.nextPage[].excludeTerms

string

Mengidentifikasi kata atau frasa yang tidak boleh muncul di dokumen apa pun di hasil penelusuran.

queries.nextPage[].linkSite

string

Menentukan bahwa semua hasil harus berisi link ke URL tertentu.

queries.nextPage[].orTerms

string

Memberikan istilah penelusuran tambahan untuk diperiksa dalam dokumen, dan 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.

queries.nextPage[].relatedSite

string

Menentukan bahwa semua hasil penelusuran harus berupa halaman yang terkait dengan URL yang ditentukan. Nilai parameter harus berupa URL.

queries.nextPage[].dateRestrict

string

Membatasi hasil ke URL berdasarkan tanggal. Nilai yang didukung meliputi:

  • 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 dalam beberapa tahun sebelumnya.

queries.nextPage[].lowRange

string

Menentukan nilai awal untuk rentang penelusuran. Gunakan cse:lowRange dan cse:highrange untuk menambahkan rentang penelusuran inklusif lowRange...highRange ke kueri.

queries.nextPage[].highRange

string

Menentukan nilai akhir untuk rentang penelusuran. Gunakan cse:lowRange dan cse:highrange untuk menambahkan rentang penelusuran inklusif lowRange...highRange ke kueri.

queries.nextPage[].fileType

string

Membatasi hasil ke file dengan ekstensi tertentu. 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 (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Format Teks Kaya (rtf)

  • Flash Gelombang Kejut (swf)

  • Teks (ans, txt).

Jenis file lainnya dapat ditambahkan di masa mendatang. Daftar terbaru selalu dapat ditemukan di FAQ jenis file Google.

queries.nextPage[].rights

string

Filter berdasarkan pemberian lisensi. Nilai yang didukung meliputi:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.nextPage[].searchType

string

Nilai yang diizinkan adalah web atau image. Jika tidak ditentukan, hasil akan dibatasi pada halaman web.

queries.nextPage[].imgSize

string

Membatasi hasil ke gambar dengan ukuran tertentu. Nilai yang didukung adalah:

  • icon (kecil)

  • small | medium | large | xlarge (sedang)

  • xxlarge (besar)

  • huge (ekstra besar)

queries.nextPage[].imgType

string

Membatasi hasil ke gambar dari jenis tertentu. Nilai yang didukung adalah:

  • clipart (Gambar klip)

  • face (Wajah)

  • lineart (Gambar garis)

  • photo (Foto)

  • animated (Animasi)

  • stock (Saham)

queries.nextPage[].imgColorType

string

Membatasi hasil ke gambar dengan jenis warna yang ditentukan. Nilai yang didukung adalah:

  • mono (hitam dan putih)

  • gray (skala abu-abu)

  • color (warna)

queries.nextPage[].imgDominantColor

string

Membatasi hasil pada gambar dengan warna dominan tertentu. Nilai yang didukung adalah:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

promotions[]

object (Promotion)

Kumpulan promosi. Ditampilkan hanya jika file konfigurasi mesin telusur kustom menetapkan promosi untuk kueri tertentu.

context

object (Struct format)

Metadata dan penajaman yang terkait dengan mesin telusur tertentu, termasuk:

  • Nama mesin telusur yang digunakan untuk kueri.

  • Kumpulan objek faset (penyempurnaan) yang dapat digunakan untuk menyaring penelusuran.

searchInformation

object

Metadata tentang penelusuran ini, termasuk waktu penelusuran dan total hasil.

searchInformation.searchTime

number

Waktu yang dibutuhkan server untuk menampilkan hasil penelusuran.

searchInformation.formattedSearchTime

string

Waktu yang dibutuhkan server untuk menampilkan hasil penelusuran, yang diformat sesuai dengan gaya lokal.

searchInformation.totalResults

string

Jumlah total hasil penelusuran yang dihasilkan oleh kueri.

searchInformation.formattedTotalResults

string

Jumlah total hasil penelusuran, yang diformat sesuai dengan gaya lokal.

spelling

object

Mengenkapsulasi kueri yang telah dikoreksi.

spelling.correctedQuery

string

Kueri yang telah dikoreksi.

spelling.htmlCorrectedQuery

string

Kueri yang telah diperbaiki, diformat dalam HTML.

items[]

object (Result)

Kumpulan hasil penelusuran kustom saat ini.

Promosi

Hasil promosi.

Representasi JSON
{
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "bodyLines": [
    {
      "title": string,
      "htmlTitle": string,
      "url": string,
      "link": string
    }
  ],
  "image": {
    "source": string,
    "width": integer,
    "height": integer
  }
}
Kolom
title

string

Judul promosi.

htmlTitle

string

Judul promosi, dalam HTML.

bodyLines[]

object

Array objek blok untuk promosi ini.

bodyLines[].title

string

Teks objek blok, jika berisi teks.

bodyLines[].htmlTitle

string

Teks objek blok dalam HTML, jika berisi teks.

bodyLines[].url

string

URL link objek blok, jika ada.

bodyLines[].link

string

Teks link dari link objek blok, jika memiliki link.

image

object

Gambar yang terkait dengan promosi ini, jika ada.

image.source

string

URL gambar untuk link promosi ini.

image.width

integer

Lebar gambar dalam piksel.

image.height

integer

Tinggi gambar dalam piksel.

Hasil

Hasil penelusuran kustom.

Representasi JSON
{
  "kind": string,
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "snippet": string,
  "htmlSnippet": string,
  "cacheId": string,
  "formattedUrl": string,
  "htmlFormattedUrl": string,
  "pagemap": {
    object
  },
  "mime": string,
  "fileFormat": string,
  "image": {
    "contextLink": string,
    "height": integer,
    "width": integer,
    "byteSize": integer,
    "thumbnailLink": string,
    "thumbnailHeight": integer,
    "thumbnailWidth": integer
  },
  "labels": [
    {
      "name": string,
      "displayName": string,
      "label_with_op": string
    }
  ]
}
Kolom
kind

string

ID unik untuk jenis objek saat ini. Untuk API ini, parameternya adalah customsearch#result.

title

string

Judul hasil penelusuran, dalam teks biasa.

htmlTitle

string

Judul hasil penelusuran, dalam HTML.

snippet

string

Cuplikan hasil penelusuran, dalam teks biasa.

htmlSnippet

string

Cuplikan hasil penelusuran, dalam HTML.

cacheId

string

Menunjukkan ID versi cache Google untuk hasil penelusuran.

formattedUrl

string

URL yang ditampilkan setelah cuplikan untuk setiap hasil penelusuran.

htmlFormattedUrl

string

URL berformat HTML yang ditampilkan setelah cuplikan untuk setiap hasil penelusuran.

pagemap

object (Struct format)

Berisi informasi PageMap untuk hasil penelusuran ini.

mime

string

Jenis MIME dari hasil penelusuran.

fileFormat

string

Format file hasil penelusuran.

image

object

Mengenkapsulasi semua informasi tentang gambar yang ditampilkan dalam hasil penelusuran.

image.contextLink

string

URL yang mengarah ke halaman yang menghosting gambar.

image.height

integer

Tinggi gambar, dalam piksel.

image.width

integer

Lebar gambar, dalam piksel.

image.byteSize

integer

Ukuran gambar, dalam byte.

image.thumbnailLink

string

URL ke gambar thumbnail.

image.thumbnailHeight

integer

Tinggi gambar thumbnail, dalam piksel.

image.thumbnailWidth

integer

Lebar gambar thumbnail, dalam piksel.

labels[]

object

Mengenkapsulasi semua informasi tentang label penyempurnaan.

labels[].name

string

Nama label penajaman, yang dapat Anda gunakan untuk menyaring penelusuran. Jangan tampilkan ini di antarmuka pengguna Anda; sebagai gantinya, gunakan displayName.

labels[].displayName

string

Nama tampilan label penajaman. Ini adalah nama yang harus Anda tampilkan di antarmuka pengguna.

labels[].label_with_op

string

Label penajaman dan operasi penajaman terkait.