설정 재정의는 확장 프로그램이 선택된 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을 포함하는 길이의 배열입니다.