Mengganti setelan Chrome

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

Halaman beranda, penyedia penelusuran, dan halaman awal

Berikut ini contoh cara mengubah halaman beranda, penyedia penelusuran, dan halaman awal di manifes ekstensi. Domain yang digunakan dalam API setelan harus diverifikasi (melalui Google Search Console) oleh akun developer yang sama yang memublikasikan ekstensi. 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.

Penggunaan setelan tersebut akan mengganti izin sekaligus meminta kemampuan atau izin tambahan apa pun tidak sesuai dengan kebijakan tujuan tunggal kami. Saat Chrome mendeteksi bahwa item berpotensi melanggar kebijakan satu tujuan kami, dialog konfirmasi akan ditampilkan kepada pengguna. Ekstensi yang hanya boleh 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 diparameterisasi menggunakan kunci {i>registry<i}. Buat entri registry baru di samping Kunci "update_url" (lihat petunjuk di sini). Nama kuncinya adalah "install_parameter", nilai adalah string arbitrer:

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

    Semua kemunculan substring "__PARAM__" dalam 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. Hal itu harus terjadi setelah '/' pertama di 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 diisi)
URL penelusuran yang digunakan mesin telusur.
search_url_post_params (string, opsional)
Parameter postingan untuk search_url.
startup_pages (array string, opsional)
Array panjang berisi URL yang akan digunakan sebagai halaman awal.
suggest_url (string, opsional)
URL yang digunakan mesin telusur untuk saran. Jika tidak digunakan, mesin tidak mendukung saran.
suggest_url_post_params (string, opsional)
Parameter postingan untuk suggest_url.