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

Chrome 설정 재정의

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

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

다음은 홈페이지, 검색 공급자, 시작 페이지를 수정하는 방법의 예입니다. 를 확장 프로그램 매니페스트에 입력합니다. 설정 API에서 사용되는 모든 도메인은 도메인 이름 지정을 통해 Google Search Console)로 제출해야 합니다. 참고: 도메인 (예: 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 속성의 모든 값을 현지화할 수 있음 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_parameter"가 없으면 "__PARAM__"이(가) 발생합니다. 삭제되었습니다. "__PARAM__"은(는) 호스트 이름에 포함할 수 없습니다. 이 포드는 첫 번째 '/' 을 입력합니다.

참조

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

alternate_urls (문자열 배열, 선택사항): search_url. 외에 사용할 수 있는 URL 패턴 목록입니다.
encoding (문자열, 선택사항): 검색어에 사용되는 인코딩입니다. prepopulated_id를 설정하지 않은 경우 필수입니다.
favicon_url (문자열, 선택사항): 검색엔진의 아이콘 URL입니다. prepopulated_id를 설정하지 않은 경우 필수입니다.
homepage (문자열, 선택사항): 홈페이지의 새 값입니다.
image_url (문자열, 선택사항): 검색엔진이 이미지 검색에 사용하는 URL입니다. 이 속성을 사용하지 않으면 엔진이 이미지 검색을 지원하지 않습니다.
image_url_post_params (문자열, 선택사항): image_url의 post 매개변수입니다.
is_default (불리언, 필수): 검색 공급자가 기본 공급자여야 하는지 지정합니다.
keyword (문자열, 선택사항): 검색엔진의 검색주소창 키워드입니다. prepopulated_id를 설정하지 않은 경우 필수입니다.
name (문자열, 선택사항): 사용자에게 표시되는 검색엔진의 이름입니다. prepopulated_id를 설정하지 않은 경우 필수입니다.
prepopulated_id (정수, 선택사항): Chrome에 내장된 검색엔진의 ID입니다.
search_provider (객체, 선택사항): 검색엔진
search_url (문자열, 필수): 검색엔진이 사용하는 검색 URL입니다.
search_url_post_params (문자열, 선택사항): search_url의 post 매개변수입니다.
startup_pages (문자열 배열, 선택사항): 시작 페이지로 사용할 URL을 포함하는 길이 1의 배열입니다.
suggest_url (문자열, 선택사항): 검색엔진이 추천에 사용하는 URL입니다. 이 속성을 사용하지 않으면 엔진에서 추천을 지원하지 않습니다.
suggest_url_post_params (문자열, 선택사항): suggest_url의 post 매개변수입니다.