Chrome ayarlarını geçersiz kılma

Ayarları geçersiz kılma, uzantıların seçili Chrome ayarlarını geçersiz kılmasına olanak tanıyan bir yöntemdir. API, Windows ve Mac'te Chrome'un tüm güncel sürümlerinde kullanılabilir.

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

Aşağıda, ana sayfanın, arama sağlayıcısının ve başlangıç sayfalarının uzantı manifestinde nasıl değiştirilebileceğine dair bir örnek verilmiştir. Ayarlar API'sinde kullanılan tüm alan adları, uzantıyı yayınlayan aynı geliştirici hesabı tarafından doğrulanmalıdır (Google Search Console üzerinden). Bir alan (örneğin, https://example.com) için sahipliği doğruluyorsanız uzantınızda herhangi bir alt alan adını veya sayfayı (örneğin, https://app.example.com veya https://example.com/page.html) kullanabilirsiniz.

Ayarları geçersiz kılmanın yanı sıra ek özellik veya izin isteğinde de bulunmak tek amaca yönelik politikamıza aykırıdır. Chrome, bir öğenin tek amaç politikamızı ihlal ediyor olabileceğini tespit ettiğinde kullanıcıya onay iletişim kutusu gösterilir. Ek özellik veya izin istemeden yalnızca tek bir ayarı değiştirmekle sınırlayan uzantılara onay iletişim kutusu gösterilmez.

Bu durum 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 chrome.i18n API kullanılarak yerelleştirilebilir.

  • Harici uzantılar için search_provider, homepage ve startup_pages URL değerleri, bir kayıt defteri anahtarı kullanılarak parametre haline getirilebilir. "update_url" anahtarının yanında yeni bir kayıt defteri girişi oluşturun (talimatları burada bulabilirsiniz). Anahtar adı "install_parameter", değer ise rastgele bir dizedir:

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

    Manifest URL'lerindeki "__PARAM__" alt dizesinin tüm tekrarları "install_parameter" değeriyle değiştirilecek. "install_parameter" yoksa "__PARAM__" kaldırılır. "__PARAM__" öğesinin, ana makine adının bir parçası olamayacağını unutmayın. URL'deki ilk "/" karakterinden sonra gelmelidir.

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. dışında kullanılabilecek URL kalıplarının listesi
encoding (dize, isteğe bağlı)
Arama terimleri için kullanılan kodlama. prepopulated_id özelliğini ayarlamazsanız bu gereklidir.
favicon_url (dize, isteğe bağlı)
Arama motoru için bir simge URL'si. prepopulated_id özelliğ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ılmazsa motor görsel 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 ayar olup olmayacağını belirtir.
keyword (dize, isteğe bağlı)
Arama motoru için bir çok amaçlı adres çubuğu anahtar kelimesi. prepopulated_id özelliğini ayarlamazsanız bu gereklidir.
name (dize, isteğe bağlı)
Kullanıcıya gösterilen arama motorunun adı. prepopulated_id özelliğini ayarlamazsanız bu gereklidir.
prepopulated_id (tam sayı, isteğe bağlı)
Chrome'un yerleşik arama motoru için bir 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 uzunluk dizisi.
suggest_url (dize, isteğe bağlı)
Arama motorunun öneriler için kullandığı URL. Bu kullanılmazsa motor, önerileri desteklemez.
suggest_url_post_params (dize, isteğe bağlı)
suggest_url için yayın parametreleri.