Zastępowanie ustawień Chrome

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

Strona główna, dostawca wyszukiwania i strony startowe

Oto przykład zmian: strona główna, dostawca wyszukiwania i strony startowe w pliku manifestu rozszerzenia. Każda domena używana w interfejsie Settings API musi zostać zweryfikowana (za pomocą Google Search Console) tym samym kontem dewelopera, na którym publikowane jest rozszerzenie. Pamiętaj, że jeśli zweryfikować własność domeny (na przykład https://example.com), możesz użyć dowolnej subdomeny lub strony (np. https://app.example.com lub https://example.com/strona.html) w ramach rozszerzenia.

Użycie tych uprawnień powoduje zastąpienie uprawnień, a jednocześnie żądanie dodatkowych funkcji lub uprawnień jest niezgodne z naszymi zasadami dotyczącymi jednego celu. Gdy Chrome wykryje, że dany produkt może naruszać nasze zasady dotyczące jednego celu, wyświetla się okno z potwierdzeniem. Rozszerzenia, które ograniczają się do modyfikowania tylko jednego ustawienia bez potrzeby korzystania z dodatkowych możliwości lub uprawnień, nie widzą 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 API chrome.i18n.

  • W przypadku rozszerzeń zewnętrznych wartości search_provider, homepage i startup_pages adresu URL mogą być sparametryzowane za pomocą klucza rejestru. Utwórz nowy wpis rejestru obok "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 ciągiem Wartość: "install_parameter". Jeśli argument "install_parameter" nie występuje, wystąpienia "__PARAM__" są następujące: usunięto. Pamiętaj, że "__PARAM__" nie może być częścią nazwy hosta. Musi wystąpić po pierwszy znak „/” w adresie URL.

Dokumentacja

Rozszerzenie może zastąpić jedną lub kilka z tych właściwości w pliku manifestu:

alternate_urls (tablica ciągów znaków, opcjonalnie)
Lista wzorców adresów URL, których można używać oprócz tagu search_url.
encoding (ciąg znaków, opcjonalnie)
Kodowanie używane do wyszukiwania haseł. Jest to wymagane, jeśli nie ustawisz prepopulated_id.
favicon_url (ciąg znaków, opcjonalnie)
Adres URL ikony wyszukiwarki. Jest to wymagane, jeśli nie ustawisz prepopulated_id.
homepage (ciąg znaków, opcjonalnie)
Nowa wartość strony głównej.
image_url (ciąg znaków, opcjonalnie)
Adres URL używany przez wyszukiwarkę do wyszukiwania grafiki. Jeśli ta opcja nie jest używana, wyszukiwarka nie obsługuje wyszukiwania grafiki.
image_url_post_params (ciąg znaków, opcjonalnie)
Parametry posta dla zapytania image_url.
is_default (wartość logiczna, wymagana)
Określa, czy dostawca wyszukiwania powinien być domyślny.
keyword (ciąg znaków, opcjonalnie)
Słowo kluczowe w omniboksie używane do wyszukiwarki. Jest to wymagane, jeśli nie ustawisz prepopulated_id.
name (ciąg znaków, opcjonalnie)
Nazwa wyszukiwarki wyświetlana użytkownikowi. Jest to wymagane, jeśli nie ustawisz prepopulated_id.
prepopulated_id (liczba całkowita, opcjonalnie)
Identyfikator wbudowanej wyszukiwarki w Chrome.
search_provider (obiekt, opcjonalnie)
Wyszukiwarka.
search_url (ciąg znaków, wymagany)
Adres URL wyszukiwania używany przez wyszukiwarkę.
search_url_post_params (ciąg znaków, opcjonalnie)
Parametry posta dla zapytania search_url.
startup_pages (tablica ciągów znaków, opcjonalnie)
Tablica o długości 1 zawierająca adres URL, który ma być używany jako strona startowa.
suggest_url (ciąg znaków, opcjonalnie)
Adres URL używany przez wyszukiwarkę do wyświetlania sugestii. Jeśli ta opcja nie jest używana, wyszukiwarka nie obsługuje sugestii.
suggest_url_post_params (ciąg znaków, opcjonalnie)
Parametry posta dla zapytania suggest_url.