Trả về siêu dữ liệu về lượt tìm kiếm đã thực hiện, siêu dữ liệu về công cụ dùng cho lượt tìm kiếm và các kết quả tìm kiếm.
Yêu cầu HTTP
GET https://customsearch.googleapis.com/customsearch/v1
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số truy vấn
Tham số | |
---|---|
c2coff |
Bật hoặc tắt Tìm kiếm bằng tiếng Trung giản thể và phồn thể. Giá trị mặc định cho tham số này là 0 (không), có nghĩa là tính năng này đang bật. Sau đây là các giá trị được hỗ trợ:
|
cr |
Hạn chế kết quả tìm kiếm trong các tài liệu bắt nguồn từ một quốc gia cụ thể. Bạn có thể sử dụng toán tử Boolean trong giá trị của thông số cr. Google Tìm kiếm xác định quốc gia của một tài liệu bằng cách phân tích:
Xem trang Giá trị thông số quốc gia để biết danh sách các giá trị hợp lệ cho thông số này. |
cx |
Mã công cụ tìm kiếm có thể lập trình để sử dụng cho yêu cầu này. |
dateRestrict |
Giới hạn kết quả trong các URL dựa trên ngày. Sau đây là các giá trị được hỗ trợ:
|
exactTerms |
Xác định cụm từ mà tất cả tài liệu trong kết quả tìm kiếm đều phải có. |
excludeTerms |
Xác định một từ hoặc cụm từ không được xuất hiện trong bất kỳ tài liệu nào trong kết quả tìm kiếm. |
fileType |
Giới hạn kết quả trong những tệp của một tiện ích đã chỉ định. Bạn có thể xem danh sách các loại tệp mà Google có thể lập chỉ mục trong Trung tâm trợ giúp của Search Console. |
filter |
Kiểm soát việc bật hoặc tắt bộ lọc nội dung trùng lặp.
Các giá trị được chấp nhận là:
|
gl |
Vị trí địa lý của người dùng cuối.
|
googlehost |
Không dùng nữa. Dùng tham số Miền địa phương của Google (ví dụ: google.com, google.de hoặc google.fr) để thực hiện tìm kiếm. |
highRange |
Chỉ định giá trị kết thúc cho một dải ô tìm kiếm.
|
hl |
Đặt ngôn ngữ giao diện người dùng.
|
hq |
Thêm các cụm từ truy vấn được chỉ định vào truy vấn, như thể chúng được kết hợp với toán tử logic AND. |
imgColorType |
Trả về hình ảnh đen trắng, thang màu xám, trong suốt hoặc màu. Các giá trị được chấp nhận là:
|
imgDominantColor |
Trả về hình ảnh của một màu chủ đạo cụ thể. Các giá trị được chấp nhận là:
|
imgSize |
Trả về hình ảnh có kích thước được chỉ định. Các giá trị được chấp nhận là:
|
imgType |
Trả về hình ảnh của một loại. Các giá trị được chấp nhận là:
|
linkSite |
Chỉ định rằng tất cả kết quả tìm kiếm phải chứa đường liên kết đến một URL cụ thể. |
lowRange |
Chỉ định giá trị bắt đầu cho một phạm vi tìm kiếm. Sử dụng |
lr |
Giới hạn tìm kiếm trong các tài liệu viết bằng một ngôn ngữ cụ thể (ví dụ: Các giá trị được chấp nhận là:
|
num |
Số kết quả tìm kiếm trả về.
|
orTerms |
Cung cấp các cụm từ tìm kiếm bổ sung để kiểm tra trong tài liệu, trong đó mỗi tài liệu trong kết quả tìm kiếm phải chứa ít nhất một trong các cụm từ tìm kiếm bổ sung. |
q |
Truy vấn |
relatedSite |
Không dùng nữa. |
rights |
Bộ lọc dựa trên việc cấp phép. Các giá trị được hỗ trợ bao gồm: |
safe |
Mức độ an toàn khi tìm kiếm. Các giá trị được chấp nhận là:
|
searchType |
Chỉ định loại tìm kiếm: Các giá trị được chấp nhận là:
|
siteSearch |
Chỉ định một trang web nhất định cần luôn được đưa vào hoặc bị loại trừ khỏi kết quả (xem tham số |
siteSearchFilter |
Kiểm soát việc bao gồm hay loại trừ kết quả từ trang web có tên trong tham số Các giá trị được chấp nhận là:
|
sort |
Biểu thức sắp xếp để áp dụng cho các kết quả. Tham số sắp xếp chỉ định rằng kết quả được sắp xếp theo biểu thức đã chỉ định, tức là sắp xếp theo ngày. Ví dụ: sort=date. |
start |
Chỉ mục của kết quả đầu tiên cần trả về. Số lượng kết quả mặc định trên mỗi trang là 10, do đó |
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Search
.
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/cse
Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.