Zastępowanie ustawień Chrome

Zastąpienia ustawień umożliwiają rozszerzeniom zastąpienie wybranych ustawień Chrome. Interfejs API jest dostępny w systemach Windows i Mac we wszystkich aktualnych wersjach Chrome.

Strona główna, dostawca wyszukiwania i strony startowe

Oto przykład zmiany strony głównej, dostawcy wyszukiwania i stron startowych w pliku manifestu rozszerzenia. Każda domena używana w interfejsie API ustawień musi zostać zweryfikowana (w Google Search Console) przez to samo konto dewelopera, na którym jest publikowane rozszerzenie. Pamiętaj, że jeśli potwierdzasz własność domeny (np. https://example.com), możesz w rozszerzeniu użyć dowolnej subdomeny lub strony (na przykład https://aplikacja.example.com lub https://example.com/strona.html).

Korzystanie z zastępowania ustawień przy jednoczesnym żądaniu dodatkowych możliwości lub uprawnień jest niezgodne z naszymi zasadami dotyczącymi jednego celu. Gdy Chrome wykryje, że produkt potencjalnie narusza zasady dotyczące jednego celu, użytkownikowi wyświetla się okno z potwierdzeniem. Rozszerzenia, które ograniczają się do zmiany tylko jednego ustawienia i nie szukają dodatkowych możliwości ani uprawnień, nie wyświetlają okna z potwierdzeniem.

Dotyczy to Chrome 107 i nowszych wersji.

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

Dostosowywanie wartości

Wartości w pliku manifestu można dostosowywać na te sposoby:

  • Wszystkie wartości właściwości search_provider, homepage i startup_pages można zlokalizować za pomocą interfejsu chrome.i18n API.

  • W przypadku rozszerzeń zewnętrznych wartości adresów URL search_provider, homepage i startup_pages można sparametryzować za pomocą klucza rejestru. Utwórz nowy wpis rejestru obok klucza "update_url" (instrukcje znajdziesz tutaj). Nazwa klucza to "install_parameter", a wartość jest dowolnym ciągiem znaków:

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

    Wszystkie wystąpienia podłańcucha "__PARAM__" w adresach URL pliku manifestu zostaną zastąpione wartością "install_parameter". Jeśli brakuje "install_parameter", wystąpienia "__PARAM__" są usuwane. Pamiętaj, że "__PARAM__" nie może być częścią nazwy hosta. Musi on występować w adresie URL po pierwszym znaku „/”.

Dokumentacja

Rozszerzenie może zastąpić co najmniej 1 z tych właściwości w pliku manifestu:

alternate_urls (tablica ciągów tekstowych, opcjonalnie)
Lista wzorców adresów URL, których można używać poza search_url.
encoding (ciąg znaków, opcjonalnie)
Kodowanie używane w wyszukiwanych hasłach. Jest to wymagane, jeśli nie skonfigurujesz prepopulated_id.
favicon_url (ciąg znaków, opcjonalnie)
Adres URL ikony wyszukiwarki. Jest to wymagane, jeśli nie skonfigurujesz prepopulated_id.
homepage (ciąg znaków, opcjonalnie)
Nowa wartość strony głównej.
image_url (ciąg znaków, opcjonalnie)
Adres URL, którego wyszukiwarka używa do wyszukiwania obrazów. Jeśli nie jest on używany, wyszukiwarka nie obsługuje wyszukiwania grafiki.
image_url_post_params (ciąg znaków, opcjonalnie)
Parametry posta dla konta image_url.
is_default (wartość logiczna, wymagana)
Określa, czy dostawca wyszukiwania powinien być domyślnym.
keyword (ciąg znaków, opcjonalnie)
Słowo kluczowe w omniboksie wyszukiwarki. Jest to wymagane, jeśli nie skonfigurujesz prepopulated_id.
name (ciąg znaków, opcjonalnie)
Nazwa wyszukiwarki wyświetlana użytkownikowi. Jest to wymagane, jeśli nie skonfigurujesz prepopulated_id.
prepopulated_id (liczba całkowita, opcjonalna)
Identyfikator wbudowanej wyszukiwarki w Chrome.
search_provider (obiekt, opcjonalnie)
Wyszukiwarka.
search_url (ciąg znaków, wymagany)
Adres URL wyszukiwarki używany przez wyszukiwarkę.
search_url_post_params (ciąg znaków, opcjonalnie)
Parametry posta dla konta search_url.
startup_pages (tablica ciągów tekstowych, opcjonalnie)
Tablica o długości 1 z adresem URL, który ma służyć jako strona startowa.
suggest_url (ciąg znaków, opcjonalnie)
Adres URL, którego wyszukiwarka używa w sugestiach. Jeśli nie będzie on używany, wyszukiwarka nie będzie obsługiwać sugestii.
suggest_url_post_params (ciąg znaków, opcjonalnie)
Parametry posta dla konta suggest_url.