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 quy cách 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 và xác định hoạt động của công cụ tìm kiếm đó. 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 đã xây dựng được sự tự tin, bạn có thể bắt đầu thử nghiệm với nhiều yếu tố và thuộc tính. Bạn có thể xem xét các chế độ cài đặt trong Bảng điều khiển rồi 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>

Các 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 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 từ khoá (dài tối đa 100 ký tự) được phân tách bằng dấu cách được liên kết với công cụ tìm kiếm. 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 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ẽ tăng cường kết quả bằng ngôn ngữ đó, nhưng sẽ không lọc ra 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ị là rỗng, Công cụ tìm kiếm có thể lập trình sẽ sử dụng ngôn ngữ tại khu vực 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 tự động hoàn thành BẢNG THUẬT NGỮ cho công cụ tìm kiếm của bạn hay không. Giá trị được phép là true hoặc false. Nếu true, xin lưu ý rằng việc tạo nội dung 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ừ thẻ Nhận mã trong Bảng điều khiển. Chỉ những công cụ tìm kiếm dùng để tìm kiếm các trang web — một tập hợp các trang web được xác định trước — mới có thể dùng cụm từ tìm kiếm tự động hoàn thành.
Title Bắt buộc Tên công cụ tìm kiếm của bạn. Nút 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 về công cụ tìm kiếm của bạn.
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 nhãn dùng để quảng bá, bao gồm hoặc loại trừ các trang web và trang. Có 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 đưa vào/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 chỉ hiển thị các trang web ưa thích) hoặc ELIMINATE (loại trừ 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 xem Tìm kiếm hình ảnh có được bật không. Có các thuộc tính sau:

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