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
istartup_pages
można zlokalizować za pomocą interfejsuchrome.i18n
API. W przypadku rozszerzeń zewnętrznych wartości adresów URL
search_provider
,homepage
istartup_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
.