Chrome 설정 재정의

설정 재정의는 확장 프로그램이 선택한 Chrome 설정을 재정의하는 방법입니다. 이 API는 Windows의 모든 현재 Chrome 버전에서 사용할 수 있으며 Mac에서는 Chrome 56 이상에서 사용할 수 있습니다.

홈페이지, 검색 공급자, 시작 페이지

다음은 홈페이지, 검색 공급자, 시작 페이지를 수정하는 방법에 대한 예입니다. 확장 프로그램 매니페스트를 사용합니다. 설정 API에서 사용되는 웹사이트는 웹마스터를 통해 인증되어야 합니다. 도구)를 Chrome 웹 스토어의 해당 항목과 연결된 것으로 간주해야 합니다. 참고: 소유권을 확인하면 도메인 (예: http://example.com)에 대해 모든 하위 도메인 또는 페이지 (예: http://app.example.com 또는 http://example.com/page.html)이 될 수 있습니다.

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

값 맞춤설정

매니페스트의 값은 다음과 같은 방법으로 맞춤설정할 수 있습니다.

  • search_provider, homepage, startup_pages 속성의 모든 값을 현지화할 수 있음 chrome.i18n API를 사용합니다.
  • 외부 확장 프로그램의 경우 search_provider, homepage, startup_pages URL 값은 매개변수화될 수 있습니다. 'update_url' 키 옆에 새 레지스트리 항목이 생성됩니다(여기의 안내 참고). 값 이름은 'install_parameter'이고 값 데이터는 임의의 문자열입니다.

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

    하위 문자열 '__PARAM__'이(가) 나오는 모든 항목 는 'install_parameter' 값으로 사용됩니다. 'install_parameter'가 없음, '__PARAM__' 발생 입니다 삭제되었습니다. '__PARAM__'은 호스트 이름의 일부가 될 수 없습니다. URL의 첫 번째 '/' 뒤에 있어야 합니다.

참조

확장 프로그램은 매니페스트에서 다음 속성 중 하나 이상을 재정의할 수 있습니다.

  • homepage(문자열) - 선택사항

    홈페이지의 새 값입니다.

  • search_provider(객체) - 선택사항

    검색엔진

    유형 속성 설명
    문자열 (선택사항) 이름

    사용자에게 표시되는 검색엔진의 이름입니다. 생략할 수 있습니다. prepopulated_id가 설정됩니다.

    문자열 (선택사항) 키워드

    검색엔진의 검색주소창 키워드입니다. prepopulated_id가 설정된 경우에만 생략할 수 있습니다.

    문자열 (선택사항) favicon_url

    검색엔진의 아이콘 URL입니다. prepopulated_id가 있는 경우에만 생략할 수 있습니다. 설정됩니다.

    문자열 search_url

    검색엔진에서 사용하는 검색 URL입니다.

    문자열 (선택사항) 인코딩

    검색어의 인코딩입니다. prepopulated_id가 설정된 경우에만 생략할 수 있습니다.

    문자열 (선택사항) suggest_url

    생략하면 이 엔진에서 추천을 지원하지 않습니다.

    문자열 (선택사항) image_url

    생략하면 이 엔진은 이미지 검색을 지원하지 않습니다.

    문자열 (선택사항) search_url_post_params

    search_url의 게시 매개변수 문자열

    문자열 (선택사항) suggest_url_post_params

    suggest_url에 대한 post 매개변수의 문자열입니다.

    문자열 (선택사항) image_url_post_params

    image_url의 post 매개변수 문자열입니다.

    문자열 배열 (선택사항) alternate_urls

    |search_url| 외에 사용할 수 있는 URL 패턴 목록입니다.

    정수 (선택사항) prepopulated_id

    Chrome에 내장된 검색엔진의 ID입니다.

    부울 is_default

    검색 공급자가 기본값이 되어야 하는지 지정합니다.

  • startup_pages (문자열 배열) - 선택사항

    시작 페이지로 사용될 URL을 포함하는 길이 1의 배열입니다.