Bối cảnh: Xác định một Công cụ tìm kiếm có thể lập trình

Trang này mô tả cách xác định thông số kỹ thuật của công cụ tìm kiếm bằng tệp ngữ cảnh.

  1. Tổng quan
  2. Phần tử CustomSearchEngine

Tổng quan

Tệp ngữ cảnh mô tả cấu trúc của công cụ tìm kiếm của bạn và xác định hành vi của công cụ. Cách tốt nhất để bắt đầu tìm hiểu về tệp ngữ cảnh là xem một ví dụ đơn giản. Khi đã tự tin hơn, bạn có thể bắt đầu thử nghiệm với nhiều phần tử và thuộc tính. Bạn có thể xem các chế độ cài đặt trong Bảng điều khiển, sau đó xem phiên bản XML đã tạo được tải xuống từ trang Tổng quan.

Mã sau đây mô tả một công cụ tìm kiếm về biến đổi khí hậu. Xin lưu ý rằng công cụ tìm kiếm này đã bật tính năng tìm kiếm hình ảnh.

<CustomSearchEngine keywords="climate &quot;global warming&quot; &quot;greenhouse gases&quot;"
                    language="en">
  <Title>RealClimate</Title>
  <Description>Science behind global warming and climate change.</Description>
  <Context>
    <BackgroundLabels>
      <Label name="_include_" mode="FILTER"/>
      <Label name="_exclude_" mode="ELIMINATE"/>
    </BackgroundLabels>
  </Context>
  <LookAndFeel/>
  <ImageSearchSettings enable="true"/>
</CustomSearchEngine>

Phần tử CustomSearchEngine

Tệp ngữ cảnh cơ bản bao gồm các phần tử chính và phần tử con sau đây.

Phần tử Bắt buộc Nội dung mô tả
CustomSearchEngine Bắt buộc Chứa tất cả thông tin về công cụ tìm kiếm. Có các thuộc tính sau:
  • keywords. Chỉ định danh sách (dài tối đa 100 ký tự) gồm các từ khoá được phân tách bằng dấu cách liên kết với công cụ tìm kiếm. Nếu bạn không chỉ định thì Công cụ tìm kiếm có thể lập trình sẽ sử dụng một giá trị trống.
  • language. Chỉ định một trong các ngôn ngữ được hỗ trợ để hiển thị trong giao diện người dùng. Việc chỉ định một ngôn ngữ sẽ giúp cải thiện kết quả bằng ngôn ngữ đó, nhưng sẽ không lọc ra các kết quả bằng ngôn ngữ khác. Nếu bạn không chỉ định, Công cụ tìm kiếm có thể lập trình sẽ sử dụng en (tiếng Anh). Nếu giá trị này là rỗng, Công cụ tìm kiếm có thể lập trình sẽ sử dụng ngôn ngữ theo ngôn ngữ của người dùng.
  • autocompletions. Cho biết liệu Công cụ tìm kiếm có thể lập trình có tạo ra cụm từ tự động hoàn thành cho công cụ tìm kiếm của bạn hay không. Giá trị được cho phép là true hoặc false. Nếu true, xin lưu ý rằng việc tạo cụm từ tự động hoàn thành có thể mất vài giờ. Sau khi đặt giá trị này, bạn phải sửa đổi mã hộp tìm kiếm để yêu cầu tự động hoàn thành. Bạn có thể lấy mã đã cập nhật từ tab Nhận mã trong Bảng điều khiển. Chỉ những công cụ tìm kiếm tìm kiếm các trang web có chứa các trang web (một tập hợp các trang web được xác định trước) mới có thể có các truy vấn tự động hoàn thành.
Title Bắt buộc Tên công cụ tìm kiếm của bạn. Công cụ này xuất hiện trên trang chủ của Công cụ tìm kiếm có thể lập trình và các trang kết quả.
Description Bắt buộc Văn bản mô tả xuất hiện trong trang tổng quan của công cụ tìm kiếm.
Context Bắt buộc Lưu giữ thông tin về nhãn. Bao gồm các phần tử con BackgroundLabels và Facet.
BackgroundLabels Không bắt buộc Vùng chứa các nhãn dùng để quảng bá, bao gồm hoặc loại trừ trang web và trang. Bao gồm một hoặc nhiều phần tử con Label.
Label Không bắt buộc Nhãn dùng để quảng bá các trang web hoặc xác định việc bao gồm/loại trừ các trang web. Có các thuộc tính sau:
  • name. Tên nhãn.
  • mode. FILTER (quảng bá hoặc hiển thị độc quyền các trang web được ưu tiên) hoặc ELIMINATE (không bao gồm trang web). Bạn có thể tuỳ chỉnh các nhãn này theo ý muốn.
LookAndFeel Bắt buộc Kiểm soát giao diện của công cụ tìm kiếm. Giao diện này có nhiều thuộc tính và các phần tử con được mô tả chi tiết trên trang Giao diện.

ImageSearchSettings Không bắt buộc

Chỉ định nếu bạn bật tính năng Tìm kiếm hình ảnh. Có các thuộc tính sau:

  • enable. Chỉ định xem có bật tính năng Tìm kiếm hình ảnh cho công cụ tìm kiếm này hay không. Giá trị được cho phép là true hoặc false.