이 페이지는 Cloud Translation API를 통해 번역되었습니다.

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"
}
```
매니페스트 URL에서 나타나는 모든 하위 문자열 '__PARAM__'은 'install_parameter' 값으로 대체됩니다. 'install_매개변수'가 누락되면 '__PARAM__'이(가) 삭제됩니다. '__PARAM__'은(는) 호스트 이름의 일부가 될 수 없습니다. URL의 첫 번째 '/' 다음에 와야 합니다.

참조

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

homepage (문자열) - 선택사항

홈페이지의 새로운 값입니다.

search_provider (객체) - 선택사항

검색엔진

유형	속성	설명
string	(선택사항) 이름	사용자에게 표시되는 검색엔진의 이름입니다. prepopulated_id가 설정된 경우에만 생략할 수 있습니다.
string	(선택사항) 키워드	검색엔진의 검색주소창 키워드입니다. prepopulated_id가 설정된 경우에만 생략할 수 있습니다.
string	(선택사항) favicon_url	검색엔진의 아이콘 URL입니다. prepopulated_id가 설정된 경우에만 생략할 수 있습니다.
string	search_url	검색엔진에서 사용하는 검색 URL입니다.
string	(선택사항) 인코딩	검색어의 인코딩입니다. prepopulated_id가 설정된 경우에만 생략할 수 있습니다.
string	(선택사항)suggest_url	생략하면 이 엔진은 추천을 지원하지 않습니다.
string	(선택사항) image_url	생략하면 이 엔진은 이미지 검색을 지원하지 않습니다.
string	(선택사항) search_url_post_params	search_url에 대한 게시물 매개변수의 문자열입니다.
string	(선택사항)suggest_url_post_params	suggest_url의 게시물 매개변수 문자열입니다.
string	(선택사항) image_url_post_params	image_url에 대한 게시물 매개변수 문자열입니다.
문자열 배열	(선택사항) alternate_urls	\|search_url\|과 함께 사용할 수 있는 URL 패턴 목록입니다.
정수	(선택사항) prefilled_id	Chrome에 내장된 검색엔진의 ID입니다.
boolean	is_default	검색 공급자를 기본값이어야 하는지 지정합니다.

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

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