Эта страница переведена с помощью Cloud Translation API.

Переопределение настроек Chrome

Переопределение настроек – это способ расширений переопределить выбранные настройки Chrome. API доступен на Windows и Mac во всех текущих версиях Chrome.

Домашняя страница, поисковая система и стартовые страницы

Вот пример того, как домашнюю страницу , поисковую систему и стартовые страницы можно изменить в манифесте расширения . Любой домен, используемый в API настроек, должен быть подтвержден (через консоль поиска Google) той же учетной записью разработчика, которая публикует расширение. Обратите внимание: если вы подтвердите право собственности на домен (например, https://example.com), вы сможете использовать любой поддомен или страницу (например, https://app.example.com или https://example.com/). page.html) внутри вашего расширения.

Использование разрешения на переопределение настроек при одновременном запросе каких-либо дополнительных возможностей или разрешений не соответствует нашей единой политике. Когда Chrome обнаруживает, что элемент потенциально нарушает нашу единую политику, пользователю отображается диалоговое окно подтверждения. Расширения, которые ограничиваются изменением только одного параметра без запроса дополнительных возможностей или разрешений, не получают диалогового окна подтверждения.

Это относится к Chrome 107 и более поздним версиям.

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

Настройка значений

Значения в манифесте можно настроить следующими способами:

Все значения свойств search_provider , homepage и startup_pages можно локализовать с помощью API chrome.i18n .
Для внешних расширений значения URL-адресов search_provider , homepage и startup_pages можно параметризовать с помощью ключа реестра. Создайте новую запись реестра рядом с ключом "update_url" (инструкции см. здесь ). Имя ключа — "install_parameter" , значение — произвольная строка:
```
{
  "update_url": "https://clients2.google.com/service/update2/crx",
  "install_parameter": "Value"
}
```
Все вхождения подстроки "__PARAM__" в URL-адресах манифеста будут заменены значением "install_parameter" . Если "install_parameter" отсутствует, вхождения "__PARAM__" удаляются. Обратите внимание, что "__PARAM__" не может быть частью имени хоста. Это должно произойти после первого символа «/» в URL-адресе.

Ссылка

Расширение может переопределить одно или несколько из следующих свойств в манифесте:

alternate_urls (массив строк, необязательно): Список шаблонов URL-адресов, которые можно использовать в дополнение к search_url.
encoding (строка, необязательно): Кодировка, используемая для условий поиска. Это необходимо, если вы не установили prepopulated_id .
favicon_url (строка, необязательно): URL-адрес значка для поисковой системы. Это необходимо, если вы не установили prepopulated_id .
homepage (строка, необязательно): Новое значение для главной страницы.
image_url (строка, необязательно): URL-адрес, который поисковая система использует для поиска изображений. Если это не используется, движок не поддерживает поиск изображений.
image_url_post_params (строка, необязательно): Параметры публикации для image_url .
is_default (логическое значение, обязательно): Указывает, должен ли поставщик поиска использоваться по умолчанию.
keyword (строка, необязательно): Ключевое слово омнибокса для поисковой системы. Это необходимо, если вы не установили prepopulated_id .
name (строка, необязательно): Название поисковой системы, отображаемое пользователю. Это необходимо, если вы не установили prepopulated_id .
prepopulated_id (целое, необязательно): Идентификатор встроенной поисковой системы Chrome.
search_provider (объект, необязательно): Поисковая система.
search_url (строка, обязательная): URL-адрес поиска, который использует поисковая система.
search_url_post_params (строка, необязательно): Параметры публикации для search_url .
startup_pages (массив строк, необязательно): Массив длиной один, содержащий URL-адрес, который будет использоваться в качестве стартовой страницы.
suggest_url (строка, необязательно): URL-адрес, который поисковая система использует для предложений. Если это не используется, движок не поддерживает предложения.
suggest_url_post_params (строка, необязательно): Параметры публикации для suggest_url .