Method: cse.list

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

string

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ợ:

  • 1: Đã tắt

  • 0: Bật (mặc định)

cr

string

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:

  • miền cấp cao nhất (TLD) trong URL của tài liệu

  • vị trí địa lý của địa chỉ IP của máy chủ Web

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

string

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

string

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ợ:

  • d[number]: yêu cầu kết quả từ số ngày được chỉ định trong quá khứ.

  • w[number]: yêu cầu kết quả từ số tuần được chỉ định trước.

  • m[number]: yêu cầu nhận kết quả từ số tháng được chỉ định của tháng qua.

  • y[number]: yêu cầu kết quả từ số năm được chỉ định trong quá khứ.

exactTerms

string

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

string

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

string

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

string

Kiểm soát việc bật hoặc tắt bộ lọc nội dung trùng lặp.

  • Xem phần Lọc tự động để biết thêm thông tin về các bộ lọc kết quả tìm kiếm của Google. Xin lưu ý rằng tính năng lọc quá nhiều máy chủ chỉ áp dụng cho các lượt tìm kiếm trên nhiều trang web.

  • Theo mặc định, Google áp dụng tính năng lọc đối với mọi kết quả tìm kiếm để cải thiện chất lượng của những kết quả đó.

Các giá trị được chấp nhận là:

  • 0: Tắt bộ lọc nội dung trùng lặp.

  • 1: Bật bộ lọc nội dung trùng lặp.

gl

string

Vị trí địa lý của người dùng cuối.

  • Giá trị tham số gl là mã quốc gia gồm hai chữ cái. Tham số gl giúp tăng cường các kết quả tìm kiếm có quốc gia xuất xứ khớp với giá trị của tham số. Xem trang Mã quốc gia để biết danh sách các giá trị hợp lệ.

  • Việc chỉ định giá trị tham số gl sẽ dẫn đến các kết quả có liên quan hơn. Điều này đặc biệt đúng với khách hàng quốc tế và thậm chí cụ thể hơn là đối với khách hàng ở những quốc gia nói tiếng Anh không phải Hoa Kỳ.

googlehost

string

Không dùng nữa. Dùng tham số gl để có hiệu ứng tương tự.

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

string

Chỉ định giá trị kết thúc cho một dải ô tìm kiếm.

  • Sử dụng lowRangehighRange để nối một phạm vi tìm kiếm toàn diện là lowRange...highRange vào truy vấn.
hl

string

Đặt ngôn ngữ giao diện người dùng.

hq

string

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

enum (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à:

  • "color"

  • "gray"

  • "mono": đen trắng

  • "trans": nền trong suốt

imgDominantColor

enum (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à:

  • "black"

  • "blue"

  • "brown"

  • "gray"

  • "green"

  • "orange"

  • "pink"

  • "purple"

  • "red"

  • "teal"

  • "white"

  • "yellow"

imgSize

enum (ImgSize)

Trả về hình ảnh có kích thước được chỉ định. Các giá trị được chấp nhận là:

  • "huge"

  • "icon"

  • "large"

  • "medium"

  • "small"

  • "xlarge"

  • "xxlarge"

imgType

enum (ImgType)

Trả về hình ảnh của một loại. Các giá trị được chấp nhận là:

  • "clipart"

  • "face"

  • "lineart"

  • "stock"

  • "photo"

  • "animated"

lowRange

string

Chỉ định giá trị bắt đầu cho một phạm vi tìm kiếm. Sử dụng lowRangehighRange để nối một phạm vi tìm kiếm toàn diện là lowRange...highRange vào truy vấn.

lr

string

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ụ: lr=lang_ja).

Các giá trị được chấp nhận là:

  • "lang_ar": Tiếng Ả Rập

  • "lang_bg": Tiếng Bulgaria

  • "lang_ca": Tiếng Catalan

  • "lang_cs": Tiếng Séc

  • "lang_da": Tiếng Đan Mạch

  • "lang_de": Tiếng Đức

  • "lang_el": Tiếng Hy Lạp

  • "lang_en": Tiếng Anh

  • "lang_es": Tiếng Tây Ban Nha

  • "lang_et": Tiếng Estonia

  • "lang_fi": Tiếng Phần Lan

  • "lang_fr": Tiếng Pháp

  • "lang_hr": Tiếng Croatia

  • "lang_hu": Tiếng Hungary

  • "lang_id": Tiếng Indonesia

  • "lang_is": Tiếng Iceland

  • "lang_it": Tiếng Ý

  • "lang_iw": Tiếng Do Thái

  • "lang_ja": Tiếng Nhật

  • "lang_ko": Tiếng Hàn

  • "lang_lt": Tiếng Lithuania

  • "lang_lv": Tiếng Latvia

  • "lang_nl": Tiếng Hà Lan

  • "lang_no": Tiếng Na Uy

  • "lang_pl": Tiếng Ba Lan

  • "lang_pt": Tiếng Bồ Đào Nha

  • "lang_ro": Tiếng Romania

  • "lang_ru": Tiếng Nga

  • "lang_sk": Tiếng Slovak

  • "lang_sl": Tiếng Slovenia

  • "lang_sr": Tiếng Serbia

  • "lang_sv": Tiếng Thuỵ Điển

  • "lang_tr": Tiếng Thổ Nhĩ Kỳ

  • "lang_zh-CN": Tiếng Trung (giản thể)

  • "lang_zh-TW": Tiếng Trung (phồn thể)

num

integer

Số kết quả tìm kiếm trả về.

  • Giá trị hợp lệ là các số nguyên từ 1 đến 10.
orTerms

string

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

string

Truy vấn

relatedSite
(deprecated)

string

Không dùng nữa.

rights

string

Bộ lọc dựa trên việc cấp phép. Các giá trị được hỗ trợ bao gồm: cc_publicdomain, cc_attribute, cc_sharealike, cc_noncommercial, cc_nonderived và tổ hợp các giá trị này. Hãy xem các kiểu kết hợp thông thường.

safe

enum (Safe)

Mức độ an toàn khi tìm kiếm. Các giá trị được chấp nhận là:

  • "active": Bật tính năng lọc Tìm kiếm an toàn.

  • "off": Tắt chế độ lọc Tìm kiếm an toàn. (mặc định)

searchType

enum (SearchType)

Chỉ định loại tìm kiếm: image. Nếu bạn không chỉ định, kết quả chỉ giới hạn ở các trang web.

Các giá trị được chấp nhận là:

  • "image": tìm kiếm hình ảnh tuỳ chỉnh.
siteSearchFilter

enum (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ố siteSearch.

Các giá trị được chấp nhận là:

  • "e": loại trừ

  • "i": bao gồm

sort

string

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

integer (uint32 format)

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 đó &start=11 sẽ bắt đầu ở đầu trang kết quả thứ hai. Lưu ý: API JSON sẽ không bao giờ trả về hơn 100 kết quả, ngay cả khi hơn 100 tài liệu khớp với truy vấn. Vì vậy, việc đặt tổng start + num thành số lớn hơn 100 sẽ gây ra lỗi. Ngoài ra, xin lưu ý rằng giá trị tối đa của num là 10.

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.