Trang này được dịch bởi Cloud Translation API.

Ghi đè cài đặt Chrome

Ghi đè chế độ cài đặt là một cách để tiện ích ghi đè các chế độ cài đặt đã chọn của Chrome. API này là có sẵn trên Windows và Mac ở tất cả các phiên bản hiện tại của Chrome.

Trang chủ, nhà cung cấp dịch vụ tìm kiếm và trang khởi động

Sau đây là một ví dụ về cách sửa đổi trang chủ, nhà cung cấp dịch vụ tìm kiếm và trang khởi động trong tệp kê khai tiện ích. Mọi miền được sử dụng trong API cài đặt đều phải được xác minh (thông qua Google Search Console) thông qua cùng một tài khoản nhà phát triển đang xuất bản tiện ích. Lưu ý rằng nếu bạn xác minh quyền sở hữu đối với một miền (ví dụ: https://example.com). Bạn có thể sử dụng bất kỳ miền con hoặc trang nào (ví dụ: https://app.example.com hoặc https://example.com/page.html) trong tiện ích của bạn.

Việc sử dụng quyền ghi đè chế độ cài đặt đồng thời yêu cầu các quyền hoặc khả năng khác là trái với chính sách mục đích duy nhất của chúng tôi. Khi Chrome phát hiện thấy một mục có thể vi phạm chính sách mục đích duy nhất của chúng tôi, hộp thoại xác nhận sẽ hiển thị cho người dùng. Những tiện ích tự giới hạn chỉ sửa đổi một chế độ cài đặt mà không cần thêm tính năng hoặc quyền sẽ không nhận được hộp thoại xác nhận.

Chính sách này áp dụng cho Chrome 107 trở lên.

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

Tuỳ chỉnh giá trị

Bạn có thể tuỳ chỉnh giá trị trong tệp kê khai theo những cách sau:

Tất cả giá trị của thuộc tính search_provider, homepage và startup_pages đều có thể được bản địa hoá bằng API chrome.i18n.
Đối với các tiện ích bên ngoài, các giá trị URL search_provider, homepage và startup_pages có thể được tham số bằng cách sử dụng khoá đăng ký. Tạo một mục đăng ký mới bên cạnh Khoá "update_url" (xem hướng dẫn tại đây). Tên khoá là "install_parameter", giá trị là một chuỗi tuỳ ý:
```
{
  "update_url": "https://clients2.google.com/service/update2/crx",
  "install_parameter": "Value"
}
```
Mọi lần xuất hiện của chuỗi con "__PARAM__" trong các URL tệp kê khai sẽ được thay thế bằng ký tự thay thế Giá trị "install_parameter". Nếu không có "install_parameter", các lần xuất hiện của "__PARAM__" sẽ đã bị xóa. Lưu ý rằng "__PARAM__" không thể là một phần của tên máy chủ. Việc này cần xảy ra sau khi '/' đầu tiên trong URL.

Tài liệu tham khảo

Một tiện ích có thể ghi đè một hoặc nhiều thuộc tính sau trong tệp kê khai:

alternate_urls (mảng chuỗi, không bắt buộc): Danh sách các mẫu URL có thể dùng ngoài search_url.
encoding (chuỗi, không bắt buộc): Mã hoá dùng cho cụm từ tìm kiếm. Đây là yêu cầu bắt buộc nếu bạn không thiết lập prepopulated_id.
favicon_url (chuỗi, không bắt buộc): URL biểu tượng cho công cụ tìm kiếm. Đây là yêu cầu bắt buộc nếu bạn không thiết lập prepopulated_id.
homepage (chuỗi, không bắt buộc): Giá trị mới cho trang chủ.
image_url (chuỗi, không bắt buộc): URL mà công cụ tìm kiếm dùng để tìm kiếm hình ảnh. Nếu bạn không sử dụng tính năng này, thì công cụ sẽ không hỗ trợ tính năng tìm kiếm hình ảnh.
image_url_post_params (chuỗi, không bắt buộc): Tham số bài đăng cho image_url.
is_default (boolean, bắt buộc): Chỉ định xem có nên đặt nhà cung cấp dịch vụ tìm kiếm làm nhà cung cấp dịch vụ mặc định hay không.
keyword (chuỗi, không bắt buộc): Từ khoá trên thanh địa chỉ cho công cụ tìm kiếm. Đây là yêu cầu bắt buộc nếu bạn không thiết lập prepopulated_id.
name (chuỗi, không bắt buộc): Tên của công cụ tìm kiếm mà người dùng nhìn thấy. Đây là yêu cầu bắt buộc nếu bạn không thiết lập prepopulated_id.
prepopulated_id (số nguyên, không bắt buộc): Mã nhận dạng cho công cụ tìm kiếm tích hợp trong Chrome.
search_provider (đối tượng, không bắt buộc): Công cụ tìm kiếm.
search_url (chuỗi, bắt buộc): URL tìm kiếm mà công cụ tìm kiếm sử dụng.
search_url_post_params (chuỗi, không bắt buộc): Tham số bài đăng cho search_url.
startup_pages (mảng chuỗi, không bắt buộc): Một mảng có độ dài 1 chứa URL được dùng làm trang khởi động.
suggest_url (chuỗi, không bắt buộc): URL mà công cụ tìm kiếm dùng để đưa ra nội dung đề xuất. Nếu giá trị này không được sử dụng, thì công cụ sẽ không hỗ trợ tính năng đề xuất.
suggest_url_post_params (chuỗi, không bắt buộc): Tham số bài đăng cho suggest_url.