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, Windows'ta Chrome'un mevcut tüm sürümlerinde ve Mac'te Chrome 56 ve sonraki sürümlerde kullanılabilir.

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

Ana sayfa, arama sağlayıcı ve başlangıç sayfalarının uzantı manifestinde nasıl değiştirilebileceğine dair bir örnek verilmiştir. Ayarlar API'sinde kullanılan web siteleri doğrulanmalıdır (Web Yöneticisi aracılığıyla) Araçlar) inceleyebilirsiniz. Bir alanın (ör. http://example.com) sahipliğini doğrularsanız uzantınızda herhangi bir alt alan adını veya sayfayı (ör. http://app.example.com veya http://example.com/page.html) kullanabileceğinizi unutmayın.

{
  "name": "My extension",
  ...
  "chrome_settings_overrides": {
    "homepage": "http://www.homepage.com",
    "search_provider": {
        "name": "name.__MSG_url_domain__",
        "keyword": "keyword.__MSG_url_domain__",
        "search_url": "http://www.foo.__MSG_url_domain__/s?q={searchTerms}",
        "favicon_url": "http://www.foo.__MSG_url_domain__/favicon.ico",
        "suggest_url": "http://www.foo.__MSG_url_domain__/suggest?q={searchTerms}",
        "instant_url": "http://www.foo.__MSG_url_domain__/instant?q={searchTerms}",
        "image_url": "http://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": [
          "http://www.moo.__MSG_url_domain__/s?q={searchTerms}",
          "http://www.noo.__MSG_url_domain__/s?q={searchTerms}"
        ],
        "encoding": "UTF-8",
        "is_default": true
    },
    "startup_pages": ["http://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 mülklerinin 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ı kullanarak parametrize edilmesi gerekir. "update_url" anahtarının yanında yeni bir kayıt defteri girişi oluşturulmalıdır (buradaki talimatları inceleyin). Değer adı "install_parameter", değer verileri ise rastgele bir dizedir:

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

    Manifest URL'lerinde "__PARAM__" alt dizeninin tüm oluşumları "install_parameter" değeriyle değiştirilir. "install_parameter" yoksa "__PARAM__" yer paylaşımları kaldırılır. "__PARAM__"ın ana makine adının bir parçası olamayacağını unutmayın. Bu, ilk '/' girin.

Referans

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

  • homepage (dize) - isteğe bağlı

    Ana sayfanın yeni değeri.

  • search_provider (nesne): isteğe bağlı

    Arama motoru

    Tür Özellik Açıklama
    dize (isteğe bağlı) ad

    Kullanıcıya gösterilen arama motorunun adı. Bu yalnızca prepopulated_id ayarlanmışsa atlanabilir.
    dize (isteğe bağlı) anahtar kelime

    Arama motoru için çok amaçlı adres çubuğu anahtar kelimesi. Bu yalnızca aşağıdaki durumlarda atlanabilir: prepopulated_id ayarlanmış olmalıdır.
    dize (isteğe bağlı) favicon_url

    Arama motorunun simge URL'si. Bu yalnızca prepopulated_id ayarlanmışsa atlanabilir.
    dize search_url

    Arama motoru tarafından kullanılan arama URL'si.
    dize (isteğe bağlı) kodlama

    Arama terimini kodlama. Bu yalnızca prepopulated_id ayarlanmışsa atlanabilir.
    dize (isteğe bağlı)suggest_url

    Atlanırsa bu motor önerileri desteklemez.
    dize (isteğe bağlı) image_url

    Atlanırsa bu motor resim aramayı desteklemez.
    dize (isteğe bağlı) search_url_post_params

    search_url için yayın parametreleri dizesi
    dize (isteğe bağlı) suggest_url_post_params

    Offer_url için yayın parametreleri dizesi
    dize (isteğe bağlı) image_url_post_params

    image_url öğesine yayın parametreleri dizesi
    dize dizisi (isteğe bağlı) alternate_urls

    |search_url|'ye ek olarak kullanılabilecek URL kalıplarının listesi.
    tam sayı (isteğe bağlı) preFILL_id

    Chrome'daki yerleşik arama motorunun kimliği.
    boolean is_default

    Arama sağlayıcısının varsayılan olup olmayacağını belirtir.

  • startup_pages (dize dizisi) - isteğe bağlı

    Başlangıç sayfası olarak kullanılacak bir URL içeren bir uzunluk bir dizisi.