Chrome ayarlarını geçersiz kılma

Ayarları geçersiz kılma, uzantıların seçili Chrome ayarlarını geçersiz kılmasının bir yoludur. API ve Mac'te Chrome'un tüm güncel sürümlerinde kullanılabilir.

Ana sayfa, arama sağlayıcı ve başlangıç sayfaları

Burada, ana sayfa, arama sağlayıcı ve başlangıç sayfalarının nasıl değiştirilebileceğine ilişkin bir örnek verilmiştir. uzantı manifest'inde bulabilirsiniz. Ayarlar API'sinde kullanılan tüm alanlar doğrulanmalıdır. Bunun için Google Search Console) tarafından uzantıyı yayınlayan aynı geliştirici hesabı tarafından yürütülür. bir alan adı (örneğin, https://example.com) için sahipliği doğrulayın. Herhangi bir alt alan adı veya sayfayı kullanabilirsiniz (örneğin, https://app.example.com veya https://example.com/page.html).

Ayarları geçersiz kılma izninin yanı sıra herhangi bir ek özellik veya izin istemenin kullanılması tek amaç politikamıza aykırıdır. Chrome, bir öğenin tek amaç politikamızı ihlal etme potansiyeli taşıdığını algılarsa kullanıcıya onay iletişim kutusu gösterilir. Ek özellikler veya izinler istemeden yalnızca tek bir ayarı değiştirmeyle sınırlayan uzantılarda onay iletişim kutusu gösterilmez.

Bu, Chrome 107 ve sonraki sürümler için geçerlidir.

{
  "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",
   ...
}

Değerleri özelleştirme

Manifest'teki değerler aşağıdaki şekillerde özelleştirilebilir:

  • search_provider, homepage ve startup_pages özelliklerinin tüm değerleri yerelleştirilebilir (chrome.i18n API kullanılarak)

  • Harici uzantılar için search_provider, homepage ve startup_pages URL değerleri: bir kayıt defteri anahtarı kullanarak parametrize edilmesi gerekir. Yeni bir kayıt defteri girişi oluşturun: "update_url" anahtarı (buradaki talimatları inceleyin). Anahtar adı: "install_parameter". rastgele bir dizedir:

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

    Manifest URL'lerinde "__PARAM__" alt dizesinin tüm tekrarları "install_parameter" değeri. "install_parameter" yoksa "__PARAM__" tekrarları emin olun. "__PARAM__" öğesinin ana makine adının bir parçası olamayacağını unutmayın. Bu, ilk '/' gelir.

Referans

Bir uzantı, manifest dosyasında aşağıdaki özelliklerden birini veya daha fazlasını geçersiz kılabilir:

alternate_urls (dize dizisi, isteğe bağlı)
search_url. adresine ek olarak kullanılabilecek URL kalıplarının listesi
encoding (dize, isteğe bağlı)
Arama terimleri için kullanılan kodlama. prepopulated_id seçeneğini ayarlamazsanız bu gereklidir.
favicon_url (dize, isteğe bağlı)
Arama motoru için bir simge URL'si. prepopulated_id seçeneğini ayarlamazsanız bu gereklidir.
homepage (dize, isteğe bağlı)
Ana sayfanın yeni değeri.
image_url (dize, isteğe bağlı)
Arama motorunun görsel arama için kullandığı URL. Bu kullanılmıyorsa motor, resim aramayı desteklemez.
image_url_post_params (dize, isteğe bağlı)
image_url için yayın parametreleri.
is_default (boole, gerekli)
Arama sağlayıcısının varsayılan olup olmayacağını belirtir.
keyword (dize, isteğe bağlı)
Arama motoru için çok amaçlı adres çubuğu anahtar kelimesi. prepopulated_id seçeneğini ayarlamazsanız bu gereklidir.
name (dize, isteğe bağlı)
Kullanıcıya gösterilen arama motorunun adı. prepopulated_id seçeneğini ayarlamazsanız bu gereklidir.
prepopulated_id (tam sayı, isteğe bağlı)
Chrome'un yerleşik arama motoru için kimlik.
search_provider (nesne, isteğe bağlı)
Arama motoru.
search_url (dize, gerekli)
Arama motorunun kullandığı arama URL'si.
search_url_post_params (dize, isteğe bağlı)
search_url için yayın parametreleri.
startup_pages (dize dizisi, isteğe bağlı)
Başlangıç sayfası olarak kullanılacak URL'yi içeren bir uzunluk dizisi.
suggest_url (dize, isteğe bağlı)
Arama motorunun öneriler için kullandığı URL. Bu kullanılmıyorsa motor, önerileri desteklemez.
suggest_url_post_params (dize, isteğe bağlı)
suggest_url için yayın parametreleri.