Trang này được dịch bởi Cloud Translation API.

Search

Biểu diễn dưới dạng JSON
Khuyến mãi
- Biểu diễn dưới dạng JSON
Kết quả
- Biểu diễn dưới dạng JSON

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

Biểu diễn dưới dạng JSON

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`) } ] }

{
  "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 của loại đối tượng hiện tại. Giá trị của API này là AAID#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 Tìm kiếm tùy chỉnh JSON.
`url.template`	`string` Mẫu OpenSearch thực tế cho API này.
`queries`	`object` Chứa một hoặc nhiều tập 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 các vai trò trong truy vấn OpenSearch và hai vai trò tuỳ chỉnh: `nextPage` và `previousPage`.
`queries.previousPage[]`	`object` Siêu dữ liệu cho trang kết quả trước, nếu có.
`queries.previousPage[].title`	`string` Nội dung mô tả về 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 trong tổng số tập hợp 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 là do thuộc tính `count` đặt.
`queries.previousPage[].language`	`string` Ngôn ngữ của kết quả tìm kiếm.
`queries.previousPage[].inputEncoding`	`string` Phương thức mã hoá ký tự được hỗ trợ cho yêu cầu tìm kiếm.
`queries.previousPage[].outputEncoding`	`string` Phương thức 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 dùng để lọc ra các kết quả 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 của 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 một 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 tuỳ chỉnh không được xác định trong thông số kỹ thuật của OpenSearch. Đây là thông số bắt buộc.
`queries.previousPage[].sort`	`string` Chỉ định kết quả cần đượ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` Bật hoặc tắt tính năng lọc tự động 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` Cải thiện kết quả tìm kiếm có quốc gia xuất xứ khớp với giá trị thông số. Hãy xem phần 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 kết quả. Điều này đặc biệt đúng đối với khách hàng quốc tế và thậm chí cụ thể hơn đố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ể 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 phần 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 tên miền Google (ví dụ: google.com, google.de hoặc google.fr) mà tìm kiếm bị 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 giản thể và phồn thể. Sau đây là các giá trị được hỗ trợ: `0`: đã bật (mặc định) `1`: đã tắt
`queries.previousPage[].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ử `AND` logic.
`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. Việc đặt rõ ràng tham số này sẽ cải thiện hiệu suất và chất lượng của kết quả tìm kiếm. Hãy xem phần Ngôn ngữ giao diện trong bài viết Quốc tế hoá truy vấn và bản trình bày kết quả để biết thêm thông tin, và xem phần 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ả ở những URL từ 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 một cụm từ mà tất cả tài liệu trong kết quả tìm kiếm 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 một 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 liên quan đến URL đã chỉ định. Giá trị tham số phải là một URL.
`queries.previousPage[].dateRestrict`	`string` Giới hạn kết quả ở URL dựa trên ngày. Sau đây là các giá trị được hỗ trợ: `d[number]`: kết quả yêu cầu từ số ngày đã chỉ định trong quá khứ. `w[number]`: các yêu cầu gửi kết quả từ số tuần được chỉ định trước đó. `m[number]`: kết quả yêu cầu từ số tháng được chỉ định trong quá khứ. `y[number]`: kết quả yêu cầu từ số lượng năm được chỉ định trong quá khứ.
`queries.previousPage[].lowRange`	`string` Chỉ định giá trị bắt đầu cho phạm vi tìm kiếm. Sử dụng `cse:lowRange` và `cse:highrange` để thêm dải ô tìm kiếm bao gồm `lowRange...highRange` vào truy vấn.
`queries.previousPage[].highRange`	`string` Chỉ định giá trị kết thúc cho phạm vi tìm kiếm. Sử dụng `cse:lowRange` và `cse:highrange` để thêm dải ô tìm kiếm bao gồm `lowRange...highRange` vào truy vấn.
`queries.previousPage[].fileType`	`string` Giới hạn kết quả trong các tệp thuộc một tiện ích cụ thể. 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`) Sen 1-2-3 (`wk1`, `wk2`, `wk3`, `wk4`, `wk5`, `wki`, `wks`, `wku`) Hoa Kỳ WordPro (`lwp`) Ghi đè (`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`) Đèn flash dạng sóng xung kích (`swf`) Văn bản (`ans`, `txt`). Sau này, chúng tôi có thể sẽ thêm các loại tệp khác. Bạn luôn có thể xem 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 giấy 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ả sẽ chỉ bao gồm các trang web.
`queries.previousPage[].imgSize`	`string` Giới hạn kết quả cho 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` (cực lớn)
`queries.previousPage[].imgType`	`string` Giới hạn kết quả cho 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) `photo` (Ảnh) `animated` (Ảnh động) `stock` (Chứng khoán)
`queries.previousPage[].imgColorType`	`string` Giới hạn kết quả trong những hình ảnh có một loại màu sắc đượ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ả ở 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 đại diện cho yêu cầu hiện tại.
`queries.request[].title`	`string` Nội dung mô tả về 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 trong tổng số tập hợp 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 là do thuộc tính `count` đặt.
`queries.request[].language`	`string` Ngôn ngữ của kết quả tìm kiếm.
`queries.request[].inputEncoding`	`string` Phương thức mã hoá ký tự được hỗ trợ cho yêu cầu tìm kiếm.
`queries.request[].outputEncoding`	`string` Phương thức 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 dùng để lọc ra các kết quả 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 của 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 một 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 tuỳ chỉnh không được xác định trong thông số kỹ thuật của OpenSearch. Đây là thông số bắt buộc.
`queries.request[].sort`	`string` Chỉ định kết quả cần đượ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` Bật hoặc tắt tính năng lọc tự động 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` Cải thiện kết quả tìm kiếm có quốc gia xuất xứ khớp với giá trị thông số. Hãy xem phần 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 kết quả. Điều này đặc biệt đúng đối với khách hàng quốc tế và thậm chí cụ thể hơn đố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ể 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 phần 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 tên miền Google (ví dụ: google.com, google.de hoặc google.fr) mà tìm kiếm bị 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 giản thể và phồn thể. Sau đây là các giá trị được hỗ trợ: `0`: đã bật (mặc định) `1`: đã tắt
`queries.request[].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ử `AND` logic.
`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. Việc đặt rõ ràng tham số này sẽ cải thiện hiệu suất và chất lượng của kết quả tìm kiếm. Hãy xem phần Ngôn ngữ giao diện trong bài viết Quốc tế hoá truy vấn và bản trình bày kết quả để biết thêm thông tin, và xem phần 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ả ở những URL từ 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 một cụm từ mà tất cả tài liệu trong kết quả tìm kiếm 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 một 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 liên quan đến URL đã chỉ định. Giá trị tham số phải là một URL.
`queries.request[].dateRestrict`	`string` Giới hạn kết quả ở URL dựa trên ngày. Sau đây là các giá trị được hỗ trợ: `d[number]`: kết quả yêu cầu từ số ngày đã chỉ định trong quá khứ. `w[number]`: các yêu cầu gửi kết quả từ số tuần được chỉ định trước đó. `m[number]`: kết quả yêu cầu từ số tháng được chỉ định trong quá khứ. `y[number]`: kết quả yêu cầu từ số lượng năm được chỉ định trong quá khứ.
`queries.request[].lowRange`	`string` Chỉ định giá trị bắt đầu cho phạm vi tìm kiếm. Sử dụng `cse:lowRange` và `cse:highrange` để thêm dải ô tìm kiếm bao gồm `lowRange...highRange` vào truy vấn.
`queries.request[].highRange`	`string` Chỉ định giá trị kết thúc cho phạm vi tìm kiếm. Sử dụng `cse:lowRange` và `cse:highrange` để thêm dải ô tìm kiếm bao gồm `lowRange...highRange` vào truy vấn.
`queries.request[].fileType`	`string` Giới hạn kết quả trong các tệp thuộc một tiện ích cụ thể. 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`) Sen 1-2-3 (`wk1`, `wk2`, `wk3`, `wk4`, `wk5`, `wki`, `wks`, `wku`) Hoa Kỳ WordPro (`lwp`) Ghi đè (`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`) Đèn flash dạng sóng xung kích (`swf`) Văn bản (`ans`, `txt`). Sau này, chúng tôi có thể sẽ thêm các loại tệp khác. Bạn luôn có thể xem 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 giấy 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ả sẽ chỉ bao gồm các trang web.
`queries.request[].imgSize`	`string` Giới hạn kết quả cho 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` (cực lớn)
`queries.request[].imgType`	`string` Giới hạn kết quả cho 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) `photo` (Ảnh) `animated` (Ảnh động) `stock` (Chứng khoán)
`queries.request[].imgColorType`	`string` Giới hạn kết quả trong những hình ảnh có một loại màu sắc đượ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ả ở 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 cho trang tiếp theo của kết quả, nếu có.
`queries.nextPage[].title`	`string` Nội dung mô tả về 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 trong tổng số tập hợp 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 là do thuộc tính `count` đặt.
`queries.nextPage[].language`	`string` Ngôn ngữ của kết quả tìm kiếm.
`queries.nextPage[].inputEncoding`	`string` Phương thức mã hoá ký tự được hỗ trợ cho yêu cầu tìm kiếm.
`queries.nextPage[].outputEncoding`	`string` Phương thức 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 dùng để lọc ra các kết quả 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 của 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 một 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 tuỳ chỉnh không được xác định trong thông số kỹ thuật của OpenSearch. Đây là thông số bắt buộc.
`queries.nextPage[].sort`	`string` Chỉ định kết quả cần đượ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` Bật hoặc tắt tính năng lọc tự động 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` Cải thiện kết quả tìm kiếm có quốc gia xuất xứ khớp với giá trị thông số. Hãy xem phần 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 kết quả. Điều này đặc biệt đúng đối với khách hàng quốc tế và thậm chí cụ thể hơn đố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ể 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 phần 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 tên miền Google (ví dụ: google.com, google.de hoặc google.fr) mà tìm kiếm bị 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 giản thể và phồn thể. Sau đây là các giá trị được hỗ trợ: `0`: đã bật (mặc định) `1`: đã tắt
`queries.nextPage[].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ử `AND` logic.
`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. Việc đặt rõ ràng tham số này sẽ cải thiện hiệu suất và chất lượng của kết quả tìm kiếm. Hãy xem phần Ngôn ngữ giao diện trong bài viết Quốc tế hoá truy vấn và bản trình bày kết quả để biết thêm thông tin, và xem phần 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ả ở những URL từ 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 một cụm từ mà tất cả tài liệu trong kết quả tìm kiếm 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 một 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 liên quan đến URL đã chỉ định. Giá trị tham số phải là một URL.
`queries.nextPage[].dateRestrict`	`string` Giới hạn kết quả ở URL dựa trên ngày. Sau đây là các giá trị được hỗ trợ: `d[number]`: kết quả yêu cầu từ số ngày đã chỉ định trong quá khứ. `w[number]`: các yêu cầu gửi kết quả từ số tuần được chỉ định trước đó. `m[number]`: kết quả yêu cầu từ số tháng được chỉ định trong quá khứ. `y[number]`: kết quả yêu cầu từ số lượng năm được chỉ định trong quá khứ.
`queries.nextPage[].lowRange`	`string` Chỉ định giá trị bắt đầu cho phạm vi tìm kiếm. Sử dụng `cse:lowRange` và `cse:highrange` để thêm dải ô tìm kiếm bao gồm `lowRange...highRange` vào truy vấn.
`queries.nextPage[].highRange`	`string` Chỉ định giá trị kết thúc cho phạm vi tìm kiếm. Sử dụng `cse:lowRange` và `cse:highrange` để thêm dải ô tìm kiếm bao gồm `lowRange...highRange` vào truy vấn.
`queries.nextPage[].fileType`	`string` Giới hạn kết quả trong các tệp thuộc một tiện ích cụ thể. 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`) Sen 1-2-3 (`wk1`, `wk2`, `wk3`, `wk4`, `wk5`, `wki`, `wks`, `wku`) Hoa Kỳ WordPro (`lwp`) Ghi đè (`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`) Đèn flash dạng sóng xung kích (`swf`) Văn bản (`ans`, `txt`). Sau này, chúng tôi có thể sẽ thêm các loại tệp khác. Bạn luôn có thể xem 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 giấy 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ả sẽ chỉ bao gồm các trang web.
`queries.nextPage[].imgSize`	`string` Giới hạn kết quả cho 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` (cực lớn)
`queries.nextPage[].imgType`	`string` Giới hạn kết quả cho 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) `photo` (Ảnh) `animated` (Ảnh động) `stock` (Chứng khoán)
`queries.nextPage[].imgColorType`	`string` Giới hạn kết quả trong những hình ảnh có một loại màu sắc đượ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ả ở 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ỉ hiển thị khi tệp cấu hình của công cụ tìm kiếm tuỳ chỉnh xác định bất kỳ chương trình khuyến mãi nào cho truy vấn đã cho.
`context`	`object (Struct format)` Siêu dữ liệu và nhãn tinh lọc liên quan đến công cụ tìm kiếm cụ thể, bao gồm: Tên của công cụ tìm kiếm được sử dụng cho truy vấn. Một tập hợp đối tượng thuộc tính (tinh chỉnh) mà bạn có thể sử dụng để tinh chỉnh 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 máy chủ cần để trả về kết quả tìm kiếm.
`searchInformation.formattedSearchTime`	`string` Thời gian máy chủ cần để 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 được 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 đã sửa.
`spelling.correctedQuery`	`string` Truy vấn đã sửa.
`spelling.htmlCorrectedQuery`	`string` Truy vấn đã sửa, được định dạng bằng HTML.
`items[]`	`object (Result)` Nhóm kết quả tìm kiếm tuỳ chỉnh hiện tại.

Khuyến mãi

Kết quả khuyến mãi.

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 } }

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.
`link`	`string` URL của chương trình khuyến mãi.
`displayLink`	`string` Phiên bản tóm lược của URL kết quả của lượt tìm kiếm này, ví dụ: www.example.com.
`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 văn bản đó có văn bản.
`bodyLines[].url`	`string` URL đường liên kết của đối tượng khối, 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 được 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 của chương trình khuyến mãi này.
`image.width`	`integer` Chiều rộng của 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 } ] }

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 của loại đối tượng hiện tại. Đối với API này, đó là `customsearch#result.`
`title`	`string` Tiêu đề của kết quả tìm kiếm, bằng văn bản thuần tuý.
`htmlTitle`	`string` Tiêu đề của kết quả tìm kiếm, trong HTML.
`link`	`string` URL đầy đủ mà kết quả tìm kiếm trỏ đến, ví dụ: http://www.example.com/foo/bar.
`displayLink`	`string` Phiên bản tóm lược của URL của kết quả tìm kiếm này, ví dụ: www.example.com.
`snippet`	`string` Đoạn trích của kết quả tìm kiếm, trong văn bản thuần tuý.
`htmlSnippet`	`string` Đoạn trích của kết quả tìm kiếm, trong HTML.
`cacheId`	`string` Cho biết mã nhận dạng 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 hiển thị sau đoạn trích cho mỗi kết quả tìm kiếm.
`htmlFormattedUrl`	`string` URL được định dạng HTML hiển thị sau đoạn trích cho mỗi 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` Đóng gói 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 ả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` Đóng gói tất cả thông tin về nhãn tinh lọc.
`labels[].name`	`string` Tên của một nhãn tinh lọc mà bạn có thể sử dụng để tinh chỉnh nội dung tìm kiếm. Không hiển thị thông tin này trong giao diện người dùng của bạn; thay vào đó, hãy sử dụng displayName.
`labels[].displayName`	`string` Tên hiển thị của một nhãn tinh lọc. Đây là tên bạn phải hiển thị trong giao diện người dùng của mình.
`labels[].label_with_op`	`string` Nhãn tinh chỉnh và thao tác tinh chỉnh có liên quan.