설정 재정의는 확장 프로그램이 선택된 Chrome 설정을 재정의하는 방법입니다. 이 API는 모든 최신 버전의 Chrome에서 Windows와 Mac에서 사용할 수 있습니다.
홈페이지, 검색 공급자, 시작 페이지
다음은 확장 프로그램 매니페스트에서 홈페이지, 검색 공급자, 시작 페이지를 수정하는 방법을 보여주는 예입니다. 설정 API에 사용되는 모든 도메인은 확장 프로그램을 게시하는 동일한 개발자 계정으로 Google Search Console을 통해 확인되어야 합니다. 도메인 (예: https://example.com)의 소유권을 확인하면 확장 프로그램 내에서 모든 하위 도메인이나 페이지(예: https://app.example.com 또는 https://example.com/page.html)를 사용할 수 있습니다.
설정 재정의 권한을 사용하는 동시에 추가 기능 또는 권한을 요청하는 것은 Google의 단일 목적 정책에 부합하지 않습니다. Chrome에서 항목이 Google의 단일 목적 정책을 위반할 가능성이 있다고 감지하면 사용자에게 확인 대화상자가 표시됩니다. 추가 기능이나 권한을 요청하지 않고 단일 설정만 수정하도록 제한하는 확장 프로그램은 확인 대화상자가 표시되지 않습니다.
이는 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속성의 모든 값은chrome.i18nAPI를 사용하여 현지화할 수 있습니다.외부 확장 프로그램의 경우 레지스트리 키를 사용하여
search_provider,homepage,startup_pagesURL 값을 매개변수화할 수 있습니다."update_url"키 옆에 새 레지스트리 항목을 만듭니다 (여기에서 안내 참고). 키 이름은"install_parameter"이며 값은 임의의 문자열입니다.{ "update_url": "https://clients2.google.com/service/update2/crx", "install_parameter": "Value" }매니페스트 URL에서 하위 문자열
"__PARAM__"과 일치하는 모든 항목은"install_parameter"값으로 대체됩니다."install_parameter"가 없으면"__PARAM__"이 제거됩니다."__PARAM__"은 호스트 이름의 일부가 될 수 없습니다. URL의 첫 번째 '/' 다음에 와야 합니다.
참조
확장 프로그램은 매니페스트에서 다음 속성 중 하나 이상을 재정의할 수 있습니다.
alternate_urls(문자열 배열, 선택사항)search_url.와 함께 사용할 수 있는 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에 내장된 검색엔진의 ID입니다.
search_provider(객체, 선택사항)- 검색엔진입니다.
search_url(문자열, 필수)- 검색엔진이 사용하는 검색 URL입니다.
search_url_post_params(문자열, 선택사항)search_url의 게시물 매개변수입니다.startup_pages(문자열 배열, 선택사항)- 시작 페이지로 사용할 URL을 포함하는 길이의 배열입니다.
suggest_url(문자열, 선택사항)- 검색엔진이 추천 검색어에 사용하는 URL입니다. 이 API를 사용하지 않으면 엔진에서 추천을 지원하지 않습니다.
suggest_url_post_params(문자열, 선택사항)suggest_url의 게시물 매개변수입니다.