Mengganti setelan Chrome

Penggantian setelan merupakan cara bagi ekstensi untuk mengganti setelan Chrome yang dipilih. API ini tersedia di Windows dan Mac di semua versi Chrome terbaru.

Halaman beranda, penyedia penelusuran, dan halaman awal

Berikut adalah contoh cara mengubah halaman beranda, penyedia penelusuran, dan halaman awal di manifes ekstensi. Setiap domain yang digunakan di API setelan harus diverifikasi (melalui Google Search Console) oleh akun developer yang sama yang memublikasikan ekstensi tersebut. Perhatikan bahwa jika Anda memverifikasi kepemilikan untuk domain (misalnya, https://example.com), Anda dapat menggunakan subdomain atau halaman apa pun (misalnya, https://app.example.com atau https://example.com/page.html) dalam ekstensi Anda.

Menggunakan setelan akan menggantikan izin sekaligus meminta kemampuan atau izin tambahan apa pun tidak konsisten dengan kebijakan satu tujuan kami. Saat Chrome mendeteksi bahwa suatu item berpotensi melanggar kebijakan satu tujuan kami, dialog konfirmasi akan ditampilkan kepada pengguna. Ekstensi yang membatasi diri untuk hanya mengubah satu setelan tanpa mencari kemampuan atau izin tambahan tidak akan mendapatkan dialog konfirmasi.

Hal ini berlaku untuk Chrome 107 dan yang lebih baru.

{
  "name": "My extension",
  ...
  "chrome_settings_overrides": {
    "homepage": "https://www.homepage.com",
    "search_provider": {
        "name": "name.__MSG_url_domain__",
        "keyword": "keyword.__MSG_url_domain__",
        "search_url": "https://www.foo.__MSG_url_domain__/s?q={searchTerms}",
        "favicon_url": "https://www.foo.__MSG_url_domain__/favicon.ico",
        "suggest_url": "https://www.foo.__MSG_url_domain__/suggest?q={searchTerms}",
        "instant_url": "https://www.foo.__MSG_url_domain__/instant?q={searchTerms}",
        "image_url": "https://www.foo.__MSG_url_domain__/image?q={searchTerms}",
        "search_url_post_params": "search_lang=__MSG_url_domain__",
        "suggest_url_post_params": "suggest_lang=__MSG_url_domain__",
        "instant_url_post_params": "instant_lang=__MSG_url_domain__",
        "image_url_post_params": "image_lang=__MSG_url_domain__",
        "alternate_urls": [
          "https://www.moo.__MSG_url_domain__/s?q={searchTerms}",
          "https://www.noo.__MSG_url_domain__/s?q={searchTerms}"
        ],
        "encoding": "UTF-8",
        "is_default": true
    },
    "startup_pages": ["https://www.startup.com"]
   },
   "default_locale": "de",
   ...
}

Menyesuaikan nilai

Nilai dalam manifes dapat disesuaikan dengan cara berikut:

  • Semua nilai properti search_provider, homepage, dan startup_pages dapat dilokalkan menggunakan chrome.i18n API.

  • Untuk ekstensi eksternal, nilai URL search_provider, homepage, dan startup_pages dapat ditetapkan menggunakan kunci registry. Buat entri registry baru di samping kunci "update_url" (lihat petunjuk di sini). Nama kuncinya adalah "install_parameter", nilainya adalah string arbitrer:

    {
  "update_url": "https://clients2.google.com/service/update2/crx",
  "install_parameter": "Value"
}

    Semua kemunculan substring "__PARAM__" di URL manifes akan diganti dengan nilai "install_parameter". Jika "install_parameter" tidak ada, kemunculan "__PARAM__" akan dihapus. Perlu diperhatikan bahwa "__PARAM__" tidak boleh menjadi bagian dari nama host. Nama ini harus muncul setelah '/' pertama pada URL.

Referensi

Ekstensi dapat mengganti satu atau beberapa properti berikut dalam manifes:

alternate_urls (array string, opsional)
Daftar pola URL yang dapat digunakan selain search_url.
encoding (string, opsional)
Encoding yang digunakan untuk istilah penelusuran. Tindakan ini diperlukan jika Anda tidak menetapkan prepopulated_id.
favicon_url (string, opsional)
URL ikon untuk mesin telusur. Tindakan ini diperlukan jika Anda tidak menetapkan prepopulated_id.
homepage (string, opsional)
Nilai baru untuk halaman beranda.
image_url (string, opsional)
URL yang digunakan mesin telusur untuk penelusuran gambar. Jika tidak digunakan, mesin tidak mendukung penelusuran gambar.
image_url_post_params (string, opsional)
Parameter postingan untuk image_url.
is_default (boolean, wajib)
Menentukan apakah penyedia penelusuran harus bersifat default.
keyword (string, opsional)
Kata kunci omnibox untuk mesin telusur. Tindakan ini diperlukan jika Anda tidak menetapkan prepopulated_id.
name (string, opsional)
Nama mesin telusur yang ditampilkan kepada pengguna. Tindakan ini diperlukan jika Anda tidak menetapkan prepopulated_id.
prepopulated_id (bilangan bulat, opsional)
ID untuk mesin telusur bawaan Chrome.
search_provider (objek, opsional)
Mesin telusur.
search_url (string, wajib)
URL penelusuran yang digunakan mesin telusur.
search_url_post_params (string, opsional)
Parameter postingan untuk search_url.
startup_pages (array string, opsional)
Array sepanjang satu yang berisi URL yang akan digunakan sebagai halaman awal.
suggest_url (string, opsional)
URL yang digunakan mesin telusur untuk saran. Jika tidak digunakan, mesin tidak akan mendukung saran.
suggest_url_post_params (string, opsional)
Parameter postingan untuk suggest_url.