Search

Phản hồi một yêu cầu tìm kiếm tuỳ chỉnh.

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "url": {
    "type": string,
    "template": string
  },
  "queries": {
    "previousPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "request": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "nextPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ]
  },
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "context": {
    object
  },
  "searchInformation": {
    "searchTime": number,
    "formattedSearchTime": string,
    "totalResults": string,
    "formattedTotalResults": string
  },
  "spelling": {
    "correctedQuery": string,
    "htmlCorrectedQuery": string
  },
  "items": [
    {
      object (Result)
    }
  ]
}
Trường
kind

string

Giá trị nhận dạng duy nhất cho loại đối tượng hiện tại. Đối với API này, giá trị của API là nhiệm#search.
url

object

Phần tử URL OpenSearch xác định mẫu cho API này.
url.type

string

Loại MIME của mẫu URL OpenSearch cho API JSON Tìm kiếm tuỳ chỉnh.
url.template

string

Mẫu OpenSearch thực tế cho API này.
queries

object

Chứa một hoặc nhiều bộ siêu dữ liệu truy vấn, được khoá theo tên vai trò. Tên vai trò có thể có bao gồm request được xác định theo vai trò truy vấn OpenSearch và hai vai trò tùy chỉnh: nextPage và previousPage.
queries.previousPage[]

object

Siêu dữ liệu trình bày trang kết quả trước đó (nếu có).
queries.previousPage[].title

string

Mô tả truy vấn.
queries.previousPage[].totalResults

string (int64 format)

Tổng số kết quả tìm kiếm ước tính. Có thể không chính xác.
queries.previousPage[].searchTerms

string

Cụm từ tìm kiếm do người dùng nhập.
queries.previousPage[].count

integer

Số kết quả tìm kiếm được trả về trong tập hợp này.
queries.previousPage[].startIndex

integer

Chỉ mục của tập hợp kết quả tìm kiếm hiện tại thành tổng bộ kết quả, trong đó chỉ mục của kết quả đầu tiên là 1.
queries.previousPage[].startPage

integer

Số trang của tập hợp kết quả này, trong đó độ dài trang được đặt bởi thuộc tính count.
queries.previousPage[].language

string

Ngôn ngữ của kết quả tìm kiếm.
queries.previousPage[].inputEncoding

string

Mã hoá ký tự được hỗ trợ cho các yêu cầu tìm kiếm.
queries.previousPage[].outputEncoding

string

Mã hoá ký tự được hỗ trợ cho kết quả tìm kiếm.
queries.previousPage[].safe

string

Chỉ định cấp độ Tìm kiếm an toàn được sử dụng để lọc ra kết quả dành cho người lớn. Đây là thuộc tính tuỳ chỉnh không được xác định trong thông số kỹ thuật OpenSearch. Các giá trị thông số hợp lệ là:

  • "off": Tắt tính năng Tìm kiếm an toàn

  • "active": Bật tính năng Tìm kiếm an toàn
queries.previousPage[].cx

string

Giá trị nhận dạng của công cụ được tạo bằng Bảng điều khiển của Công cụ tìm kiếm có thể lập trình. Đây là thuộc tính tùy chỉnh không được xác định trong thông số kỹ thuật OpenSearch. Tham số này là bắt buộc.
queries.previousPage[].sort

string

Chỉ định rằng kết quả phải được sắp xếp theo biểu thức đã chỉ định. Ví dụ: sắp xếp theo ngày.
queries.previousPage[].filter

string

Kích hoạt hoặc tắt tính năng tự động lọc kết quả tìm kiếm của Google. 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. Các giá trị hợp lệ cho thông số này là:

  • 0: Đã tắt

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

Lưu ý: Theo mặc định, Google áp dụng tính năng lọc cho tất cả kết quả tìm kiếm để cải thiện chất lượng của những kết quả đó.
queries.previousPage[].gl

string

Thăng hạng những kết quả tìm kiếm có quốc gia xuất xứ khớp với giá trị tham số. Xem 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 trong các yêu cầu WebSearch sẽ cải thiện mức độ liên quan của các kết quả. Đ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 ở các quốc gia nói tiếng Anh ngoài Hoa Kỳ.
queries.previousPage[].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 WebSearch xác định quốc gia của một tài liệu bằng cách phân tích những thông tin sau:

  • 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 Giá trị thông số Quốc gia (cr) để biết danh sách các giá trị hợp lệ cho thông số này.
queries.previousPage[].googleHost

string

Chỉ định miền Google (ví dụ: google.com, google.de hoặc google.fr) mà tìm kiếm sẽ được giới hạn.
queries.previousPage[].disableCnTwTranslation

string

Bật hoặc tắt tính năng Tìm kiếm bằng tiếng Trung phồn thể và tìm kiếm bằng tiếng Trung giản thể.

Sau đây là các giá trị được hỗ trợ:

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

  • 1: đã vô hiệu hoá
queries.previousPage[].hq

string

Thêm các cụm từ truy vấn được chỉ định vào truy vấn, như thể các cụm từ này được kết hợp với một toán tử logic AND.
queries.previousPage[].hl

string

Chỉ định ngôn ngữ giao diện (ngôn ngữ máy chủ) của giao diện người dùng. Nếu bạn đặt rõ ràng tham số này, hiệu suất và chất lượng của kết quả tìm kiếm sẽ được cải thiện.

Xem phần Ngôn ngữ giao diện trong Quốc tế hoá truy vấn và trình bày kết quả để biết thêm thông tin và xem Ngôn ngữ giao diện được hỗ trợ để biết danh sách các ngôn ngữ được hỗ trợ.
queries.previousPage[].siteSearch

string

Giới hạn kết quả trong những URL thuộc một trang web cụ thể.
queries.previousPage[].siteSearchFilter

string

Chỉ định bao gồm hay loại trừ kết quả từ trang web có tên trong tham số sitesearch. Sau đây là các giá trị được hỗ trợ:

  • i: bao gồm nội dung từ trang web

  • e: loại trừ nội dung khỏi trang web
queries.previousPage[].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ó.
queries.previousPage[].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.
queries.previousPage[].linkSite

string

Chỉ định rằng tất cả kết quả phải chứa đường liên kết đến một URL cụ thể.
queries.previousPage[].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. Bạn cũng có thể sử dụng cụm từ truy vấn Boolean OR cho loại truy vấn này.
queries.previousPage[].relatedSite

string

Chỉ định rằng tất cả kết quả tìm kiếm phải là các trang có liên quan đến URL được chỉ định. Giá trị tham số phải là một URL.
queries.previousPage[].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ứ.
queries.previousPage[].lowRange

string

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

string

Chỉ định giá trị kết thúc cho một dải ô tìm kiếm. Sử dụng cse:lowRange và cse:highrange để nối một phạm vi tìm kiếm toàn diện là lowRange...highRange vào truy vấn.
queries.previousPage[].fileType

string

Giới hạn kết quả trong những tệp của một tiện ích đã chỉ định. Các loại tệp được Google hỗ trợ bao gồm:

  • Định dạng tài liệu di động Adobe (pdf)

  • Adobe PostScript (ps)

  • Hoa sen 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Hoa sen WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Định dạng văn bản đa dạng thức (rtf)

  • Logcat Flash (swf)

  • Văn bản (ans, txt).

Các loại tệp khác có thể được thêm trong tương lai. Bạn luôn có thể tìm thấy danh sách mới nhất trong phần Câu hỏi thường gặp về loại tệp của Google.
queries.previousPage[].rights

string

Bộ lọc dựa trên việc cấp phép. Sau đây là các giá trị được hỗ trợ:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived
queries.previousPage[].searchType

string

Giá trị được phép là web hoặc image. Nếu bạn không chỉ định, kết quả chỉ giới hạn ở các trang web.
queries.previousPage[].imgSize

string

Giới hạn kết quả trong những hình ảnh có kích thước được chỉ định. Sau đây là các giá trị được hỗ trợ:

  • icon (nhỏ)

  • small | medium | large | xlarge (trung bình)

  • xxlarge (lớn)

  • huge (rất lớn)
queries.previousPage[].imgType

string

Giới hạn kết quả trong những hình ảnh thuộc một loại đã chỉ định. Sau đây là các giá trị được hỗ trợ:

  • clipart (Hình mẫu)

  • face (Khuôn mặt)

  • lineart (Vẽ đường kẻ)

  • photo (Ảnh)

  • animated (Hoạt ảnh)

  • stock (Cổ phiếu)
queries.previousPage[].imgColorType

string

Giới hạn kết quả trong những hình ảnh có loại màu được chỉ định. Sau đây là các giá trị được hỗ trợ:

  • mono (đen và trắng)

  • gray (thang màu xám)

  • color (màu)
queries.previousPage[].imgDominantColor

string

Giới hạn kết quả trong những hình ảnh có màu chủ đạo cụ thể. Sau đây là các giá trị được hỗ trợ:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown
queries.request[]

object

Siêu dữ liệu thể hiện yêu cầu hiện tại.
queries.request[].title

string

Mô tả truy vấn.
queries.request[].totalResults

string (int64 format)

Tổng số kết quả tìm kiếm ước tính. Có thể không chính xác.
queries.request[].searchTerms

string

Cụm từ tìm kiếm do người dùng nhập.
queries.request[].count

integer

Số kết quả tìm kiếm được trả về trong tập hợp này.
queries.request[].startIndex

integer

Chỉ mục của tập hợp kết quả tìm kiếm hiện tại thành tổng bộ kết quả, trong đó chỉ mục của kết quả đầu tiên là 1.
queries.request[].startPage

integer

Số trang của tập hợp kết quả này, trong đó độ dài trang được đặt bởi thuộc tính count.
queries.request[].language

string

Ngôn ngữ của kết quả tìm kiếm.
queries.request[].inputEncoding

string

Mã hoá ký tự được hỗ trợ cho các yêu cầu tìm kiếm.
queries.request[].outputEncoding

string

Mã hoá ký tự được hỗ trợ cho kết quả tìm kiếm.
queries.request[].safe

string

Chỉ định cấp độ Tìm kiếm an toàn được sử dụng để lọc ra kết quả dành cho người lớn. Đây là thuộc tính tuỳ chỉnh không được xác định trong thông số kỹ thuật OpenSearch. Các giá trị thông số hợp lệ là:

  • "off": Tắt tính năng Tìm kiếm an toàn

  • "active": Bật tính năng Tìm kiếm an toàn
queries.request[].cx

string

Giá trị nhận dạng của công cụ được tạo bằng Bảng điều khiển của Công cụ tìm kiếm có thể lập trình. Đây là thuộc tính tùy chỉnh không được xác định trong thông số kỹ thuật OpenSearch. Tham số này là bắt buộc.
queries.request[].sort

string

Chỉ định rằng kết quả phải được sắp xếp theo biểu thức đã chỉ định. Ví dụ: sắp xếp theo ngày.
queries.request[].filter

string

Kích hoạt hoặc tắt tính năng tự động lọc kết quả tìm kiếm của Google. 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. Các giá trị hợp lệ cho thông số này là:

  • 0: Đã tắt

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

Lưu ý: Theo mặc định, Google áp dụng tính năng lọc cho tất cả kết quả tìm kiếm để cải thiện chất lượng của những kết quả đó.
queries.request[].gl

string

Thăng hạng những kết quả tìm kiếm có quốc gia xuất xứ khớp với giá trị tham số. Xem 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 trong các yêu cầu WebSearch sẽ cải thiện mức độ liên quan của các kết quả. Đ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 ở các quốc gia nói tiếng Anh ngoài Hoa Kỳ.
queries.request[].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 WebSearch xác định quốc gia của một tài liệu bằng cách phân tích những thông tin sau:

  • 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 Giá trị thông số Quốc gia (cr) để biết danh sách các giá trị hợp lệ cho thông số này.
queries.request[].googleHost

string

Chỉ định miền Google (ví dụ: google.com, google.de hoặc google.fr) mà tìm kiếm sẽ được giới hạn.
queries.request[].disableCnTwTranslation

string

Bật hoặc tắt tính năng Tìm kiếm bằng tiếng Trung phồn thể và tìm kiếm bằng tiếng Trung giản thể.

Sau đây là các giá trị được hỗ trợ:

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

  • 1: đã vô hiệu hoá
queries.request[].hq

string

Thêm các cụm từ truy vấn được chỉ định vào truy vấn, như thể các cụm từ này được kết hợp với một toán tử logic AND.
queries.request[].hl

string

Chỉ định ngôn ngữ giao diện (ngôn ngữ máy chủ) của giao diện người dùng. Nếu bạn đặt rõ ràng tham số này, hiệu suất và chất lượng của kết quả tìm kiếm sẽ được cải thiện.

Xem phần Ngôn ngữ giao diện trong Quốc tế hoá truy vấn và trình bày kết quả để biết thêm thông tin và xem Ngôn ngữ giao diện được hỗ trợ để biết danh sách các ngôn ngữ được hỗ trợ.
queries.request[].siteSearch

string

Giới hạn kết quả trong những URL thuộc một trang web cụ thể.
queries.request[].siteSearchFilter

string

Chỉ định bao gồm hay loại trừ kết quả từ trang web có tên trong tham số sitesearch. Sau đây là các giá trị được hỗ trợ:

  • i: bao gồm nội dung từ trang web

  • e: loại trừ nội dung khỏi trang web
queries.request[].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ó.
queries.request[].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.
queries.request[].linkSite

string

Chỉ định rằng tất cả kết quả phải chứa đường liên kết đến một URL cụ thể.
queries.request[].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. Bạn cũng có thể sử dụng cụm từ truy vấn Boolean OR cho loại truy vấn này.
queries.request[].relatedSite

string

Chỉ định rằng tất cả kết quả tìm kiếm phải là các trang có liên quan đến URL được chỉ định. Giá trị tham số phải là một URL.
queries.request[].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ứ.
queries.request[].lowRange

string

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

string

Chỉ định giá trị kết thúc cho một dải ô tìm kiếm. Sử dụng cse:lowRange và cse:highrange để nối một phạm vi tìm kiếm toàn diện là lowRange...highRange vào truy vấn.
queries.request[].fileType

string

Giới hạn kết quả trong những tệp của một tiện ích đã chỉ định. Các loại tệp được Google hỗ trợ bao gồm:

  • Định dạng tài liệu di động Adobe (pdf)

  • Adobe PostScript (ps)

  • Hoa sen 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Hoa sen WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Định dạng văn bản đa dạng thức (rtf)

  • Logcat Flash (swf)

  • Văn bản (ans, txt).

Các loại tệp khác có thể được thêm trong tương lai. Bạn luôn có thể tìm thấy danh sách mới nhất trong phần Câu hỏi thường gặp về loại tệp của Google.
queries.request[].rights

string

Bộ lọc dựa trên việc cấp phép. Sau đây là các giá trị được hỗ trợ:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived
queries.request[].searchType

string

Giá trị được phép là web hoặc image. Nếu bạn không chỉ định, kết quả chỉ giới hạn ở các trang web.
queries.request[].imgSize

string

Giới hạn kết quả trong những hình ảnh có kích thước được chỉ định. Sau đây là các giá trị được hỗ trợ:

  • icon (nhỏ)

  • small | medium | large | xlarge (trung bình)

  • xxlarge (lớn)

  • huge (rất lớn)
queries.request[].imgType

string

Giới hạn kết quả trong những hình ảnh thuộc một loại đã chỉ định. Sau đây là các giá trị được hỗ trợ:

  • clipart (Hình mẫu)

  • face (Khuôn mặt)

  • lineart (Vẽ đường kẻ)

  • photo (Ảnh)

  • animated (Hoạt ảnh)

  • stock (Cổ phiếu)
queries.request[].imgColorType

string

Giới hạn kết quả trong những hình ảnh có loại màu được chỉ định. Sau đây là các giá trị được hỗ trợ:

  • mono (đen và trắng)

  • gray (thang màu xám)

  • color (màu)
queries.request[].imgDominantColor

string

Giới hạn kết quả trong những hình ảnh có màu chủ đạo cụ thể. Sau đây là các giá trị được hỗ trợ:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown
queries.nextPage[]

object

Siêu dữ liệu biểu thị trang kết quả tiếp theo, nếu có.
queries.nextPage[].title

string

Mô tả truy vấn.
queries.nextPage[].totalResults

string (int64 format)

Tổng số kết quả tìm kiếm ước tính. Có thể không chính xác.
queries.nextPage[].searchTerms

string

Cụm từ tìm kiếm do người dùng nhập.
queries.nextPage[].count

integer

Số kết quả tìm kiếm được trả về trong tập hợp này.
queries.nextPage[].startIndex

integer

Chỉ mục của tập hợp kết quả tìm kiếm hiện tại thành tổng bộ kết quả, trong đó chỉ mục của kết quả đầu tiên là 1.
queries.nextPage[].startPage

integer

Số trang của tập hợp kết quả này, trong đó độ dài trang được đặt bởi thuộc tính count.
queries.nextPage[].language

string

Ngôn ngữ của kết quả tìm kiếm.
queries.nextPage[].inputEncoding

string

Mã hoá ký tự được hỗ trợ cho các yêu cầu tìm kiếm.
queries.nextPage[].outputEncoding

string

Mã hoá ký tự được hỗ trợ cho kết quả tìm kiếm.
queries.nextPage[].safe

string

Chỉ định cấp độ Tìm kiếm an toàn được sử dụng để lọc ra kết quả dành cho người lớn. Đây là thuộc tính tuỳ chỉnh không được xác định trong thông số kỹ thuật OpenSearch. Các giá trị thông số hợp lệ là:

  • "off": Tắt tính năng Tìm kiếm an toàn

  • "active": Bật tính năng Tìm kiếm an toàn
queries.nextPage[].cx

string

Giá trị nhận dạng của công cụ được tạo bằng Bảng điều khiển của Công cụ tìm kiếm có thể lập trình. Đây là thuộc tính tùy chỉnh không được xác định trong thông số kỹ thuật OpenSearch. Tham số này là bắt buộc.
queries.nextPage[].sort

string

Chỉ định rằng kết quả phải được sắp xếp theo biểu thức đã chỉ định. Ví dụ: sắp xếp theo ngày.
queries.nextPage[].filter

string

Kích hoạt hoặc tắt tính năng tự động lọc kết quả tìm kiếm của Google. 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. Các giá trị hợp lệ cho thông số này là:

  • 0: Đã tắt

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

Lưu ý: Theo mặc định, Google áp dụng tính năng lọc cho tất cả kết quả tìm kiếm để cải thiện chất lượng của những kết quả đó.
queries.nextPage[].gl

string

Thăng hạng những kết quả tìm kiếm có quốc gia xuất xứ khớp với giá trị tham số. Xem 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 trong các yêu cầu WebSearch sẽ cải thiện mức độ liên quan của các kết quả. Đ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 ở các quốc gia nói tiếng Anh ngoài Hoa Kỳ.
queries.nextPage[].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 WebSearch xác định quốc gia của một tài liệu bằng cách phân tích những thông tin sau:

  • 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 Giá trị thông số Quốc gia (cr) để biết danh sách các giá trị hợp lệ cho thông số này.
queries.nextPage[].googleHost

string

Chỉ định miền Google (ví dụ: google.com, google.de hoặc google.fr) mà tìm kiếm sẽ được giới hạn.
queries.nextPage[].disableCnTwTranslation

string

Bật hoặc tắt tính năng Tìm kiếm bằng tiếng Trung phồn thể và tìm kiếm bằng tiếng Trung giản thể.

Sau đây là các giá trị được hỗ trợ:

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

  • 1: đã vô hiệu hoá
queries.nextPage[].hq

string

Thêm các cụm từ truy vấn được chỉ định vào truy vấn, như thể các cụm từ này được kết hợp với một toán tử logic AND.
queries.nextPage[].hl

string

Chỉ định ngôn ngữ giao diện (ngôn ngữ máy chủ) của giao diện người dùng. Nếu bạn đặt rõ ràng tham số này, hiệu suất và chất lượng của kết quả tìm kiếm sẽ được cải thiện.

Xem phần Ngôn ngữ giao diện trong Quốc tế hoá truy vấn và trình bày kết quả để biết thêm thông tin và xem Ngôn ngữ giao diện được hỗ trợ để biết danh sách các ngôn ngữ được hỗ trợ.
queries.nextPage[].siteSearch

string

Giới hạn kết quả trong những URL thuộc một trang web cụ thể.
queries.nextPage[].siteSearchFilter

string

Chỉ định bao gồm hay loại trừ kết quả từ trang web có tên trong tham số sitesearch. Sau đây là các giá trị được hỗ trợ:

  • i: bao gồm nội dung từ trang web

  • e: loại trừ nội dung khỏi trang web
queries.nextPage[].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ó.
queries.nextPage[].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.
queries.nextPage[].linkSite

string

Chỉ định rằng tất cả kết quả phải chứa đường liên kết đến một URL cụ thể.
queries.nextPage[].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. Bạn cũng có thể sử dụng cụm từ truy vấn Boolean OR cho loại truy vấn này.
queries.nextPage[].relatedSite

string

Chỉ định rằng tất cả kết quả tìm kiếm phải là các trang có liên quan đến URL được chỉ định. Giá trị tham số phải là một URL.
queries.nextPage[].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ứ.
queries.nextPage[].lowRange

string

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

string

Chỉ định giá trị kết thúc cho một dải ô tìm kiếm. Sử dụng cse:lowRange và cse:highrange để nối một phạm vi tìm kiếm toàn diện là lowRange...highRange vào truy vấn.
queries.nextPage[].fileType

string

Giới hạn kết quả trong những tệp của một tiện ích đã chỉ định. Các loại tệp được Google hỗ trợ bao gồm:

  • Định dạng tài liệu di động Adobe (pdf)

  • Adobe PostScript (ps)

  • Hoa sen 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Hoa sen WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Định dạng văn bản đa dạng thức (rtf)

  • Logcat Flash (swf)

  • Văn bản (ans, txt).

Các loại tệp khác có thể được thêm trong tương lai. Bạn luôn có thể tìm thấy danh sách mới nhất trong phần Câu hỏi thường gặp về loại tệp của Google.
queries.nextPage[].rights

string

Bộ lọc dựa trên việc cấp phép. Sau đây là các giá trị được hỗ trợ:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived
queries.nextPage[].searchType

string

Giá trị được phép là web hoặc image. Nếu bạn không chỉ định, kết quả chỉ giới hạn ở các trang web.
queries.nextPage[].imgSize

string

Giới hạn kết quả trong những hình ảnh có kích thước được chỉ định. Sau đây là các giá trị được hỗ trợ:

  • icon (nhỏ)

  • small | medium | large | xlarge (trung bình)

  • xxlarge (lớn)

  • huge (rất lớn)
queries.nextPage[].imgType

string

Giới hạn kết quả trong những hình ảnh thuộc một loại đã chỉ định. Sau đây là các giá trị được hỗ trợ:

  • clipart (Hình mẫu)

  • face (Khuôn mặt)

  • lineart (Vẽ đường kẻ)

  • photo (Ảnh)

  • animated (Hoạt ảnh)

  • stock (Cổ phiếu)
queries.nextPage[].imgColorType

string

Giới hạn kết quả trong những hình ảnh có loại màu được chỉ định. Sau đây là các giá trị được hỗ trợ:

  • mono (đen và trắng)

  • gray (thang màu xám)

  • color (màu)
queries.nextPage[].imgDominantColor

string

Giới hạn kết quả trong những hình ảnh có màu chủ đạo cụ thể. Sau đây là các giá trị được hỗ trợ:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown
promotions[]

object (Promotion)

Nhóm chương trình khuyến mãi. Chỉ trình bày nếu tệp cấu hình của công cụ tìm kiếm tuỳ chỉnh xác định kết quả được thăng hạng cho truy vấn đã cho.
context

object (Struct format)

Siêu dữ liệu và nhãn tinh lọc có liên quan đến công cụ tìm kiếm đó, bao gồm:

  • Tên của công cụ tìm kiếm được dùng cho cụm từ tìm kiếm.

  • Một tập hợp các đối tượng thuộc tính (tinh chỉnh) mà bạn có thể sử dụng để tinh chỉnh một nội dung tìm kiếm.
searchInformation

object

Siêu dữ liệu về nội dung tìm kiếm này, bao gồm cả thời gian tìm kiếm và tổng số kết quả.
searchInformation.searchTime

number

Thời gian cần thiết để máy chủ trả về kết quả tìm kiếm.
searchInformation.formattedSearchTime

string

Thời gian cần thiết để máy chủ trả về kết quả tìm kiếm, được định dạng theo kiểu ngôn ngữ.
searchInformation.totalResults

string

Tổng số kết quả tìm kiếm mà truy vấn trả về.
searchInformation.formattedTotalResults

string

Tổng số kết quả tìm kiếm, được định dạng theo kiểu ngôn ngữ.
spelling

object

Đóng gói một truy vấn đã được sửa.
spelling.correctedQuery

string

Cụm từ tìm kiếm đã được sửa.
spelling.htmlCorrectedQuery

string

Truy vấn đã chỉnh sửa, được định dạng bằng HTML.
items[]

object (Result)

Nhóm các kết quả tìm kiếm tuỳ chỉnh hiện tại.

Khuyến mãi

Kết quả thăng hạng.

Biểu diễn dưới dạng JSON 
{
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "bodyLines": [
    {
      "title": string,
      "htmlTitle": string,
      "url": string,
      "link": string
    }
  ],
  "image": {
    "source": string,
    "width": integer,
    "height": integer
  }
}
Trường
title

string

Tiêu đề của chương trình khuyến mãi.
htmlTitle

string

Tiêu đề của chương trình khuyến mãi, ở dạng HTML.
bodyLines[]

object

Một mảng các đối tượng chặn cho chương trình khuyến mãi này.
bodyLines[].title

string

Văn bản của đối tượng khối, nếu có văn bản.
bodyLines[].htmlTitle

string

Văn bản của đối tượng khối trong HTML, nếu đối tượng đó có văn bản.
bodyLines[].url

string

URL của đường liên kết đến đối tượng chặn (nếu có).
bodyLines[].link

string

Văn bản liên kết của đường liên kết của đối tượng khối, nếu có đường liên kết.
image

object

Hình ảnh liên kết với chương trình khuyến mãi này (nếu có).
image.source

string

URL của hình ảnh cho đường liên kết đến chương trình khuyến mãi này.
image.width

integer

Chiều rộng hình ảnh tính bằng pixel.
image.height

integer

Chiều cao của hình ảnh tính bằng pixel.

Kết quả

Kết quả tìm kiếm tuỳ chỉnh.

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "snippet": string,
  "htmlSnippet": string,
  "cacheId": string,
  "formattedUrl": string,
  "htmlFormattedUrl": string,
  "pagemap": {
    object
  },
  "mime": string,
  "fileFormat": string,
  "image": {
    "contextLink": string,
    "height": integer,
    "width": integer,
    "byteSize": integer,
    "thumbnailLink": string,
    "thumbnailHeight": integer,
    "thumbnailWidth": integer
  },
  "labels": [
    {
      "name": string,
      "displayName": string,
      "label_with_op": string
    }
  ]
}
Trường
kind

string

Giá trị nhận dạng duy nhất cho loại đối tượng hiện tại. Đối với API này, nó là customsearch#result.
title

string

Tiêu đề của kết quả tìm kiếm, ở dạng văn bản thuần tuý.
htmlTitle

string

Tiêu đề của kết quả tìm kiếm, trong HTML.
snippet

string

Đoạn trích của kết quả tìm kiếm, ở dạng văn bản thuần tuý.
htmlSnippet

string

Đoạn mã của kết quả tìm kiếm, trong HTML.
cacheId

string

Cho biết mã của phiên bản kết quả tìm kiếm được lưu trong bộ nhớ đệm của Google.
formattedUrl

string

URL xuất hiện sau đoạn mã của từng kết quả tìm kiếm.
htmlFormattedUrl

string

URL ở định dạng HTML xuất hiện sau đoạn mã cho từng kết quả tìm kiếm.
pagemap

object (Struct format)

Chứa thông tin PageMap cho kết quả tìm kiếm này.
mime

string

Loại MIME của kết quả tìm kiếm.
fileFormat

string

Định dạng tệp của kết quả tìm kiếm.
image

object

Bao gồm tất cả thông tin về một hình ảnh được trả về trong kết quả tìm kiếm.
image.contextLink

string

URL trỏ đến trang web lưu trữ hình ảnh.
image.height

integer

Chiều cao của hình ảnh, tính bằng pixel.
image.width

integer

Chiều rộng của hình ảnh, tính bằng pixel.
image.byteSize

integer

Kích thước của hình ảnh, tính bằng byte.
image.thumbnailLink

string

URL đến hình thu nhỏ.
image.thumbnailHeight

integer

Chiều cao của hình thu nhỏ, tính bằng pixel.
image.thumbnailWidth

integer

Chiều rộng của hình thu nhỏ, tính bằng pixel.
labels[]

object

Bao gồm tất cả thông tin về các nhãn tinh lọc.
labels[].name

string

Tên của nhãn sàng lọc mà bạn có thể sử dụng để tinh chỉnh nội dung tìm kiếm. Đừng hiển thị thuộc tính này trong giao diện người dùng; thay vào đó, hãy sử dụng displayName.
labels[].displayName

string

Tên hiển thị của nhãn tinh lọc. Đây là tên bạn cần hiển thị trong giao diện người dùng.
labels[].label_with_op

string

Nhãn tinh lọc và thao tác tinh chỉnh có liên quan.