Method: documents.searchDocumentChunks

Tìm kiếm kiến thức dành cho nhà phát triển trong tài liệu dành cho nhà phát triển của Google. Trả về DocumentChunk dựa trên cụm từ tìm kiếm của người dùng. Có thể có nhiều đoạn từ cùng một Document. Để truy xuất toàn bộ tài liệu, hãy sử dụng DeveloperKnowledge.GetDocument hoặc DeveloperKnowledge.BatchGetDocuments với DocumentChunk.parent được trả về trong SearchDocumentChunksResponse.results.

Yêu cầu HTTP

GET https://developerknowledge.googleapis.com/v1/documents:searchDocumentChunks

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số truy vấn

Tham số
query

string

Bắt buộc. Cung cấp chuỗi truy vấn thô do người dùng cung cấp, chẳng hạn như "Cách tạo một vùng lưu trữ Cloud Storage". Cụm từ tìm kiếm không được vượt quá 500 ký tự; các giá trị dài hơn 500 ký tự sẽ dẫn đến lỗi INVALID_ARGUMENT.
pageSize

integer

Không bắt buộc. Chỉ định số lượng kết quả tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này.

Nếu không chỉ định, tối đa 5 kết quả sẽ được trả về.

Giá trị tối đa là 100; các giá trị trên 100 sẽ được chuyển đổi thành 100.
pageToken

string

Không bắt buộc. Chứa mã thông báo trang, nhận được từ lệnh gọi documents.searchDocumentChunks trước đó. Cung cấp thông tin này để truy xuất trang tiếp theo.
filter

string

Không bắt buộc. Áp dụng bộ lọc nghiêm ngặt cho kết quả tìm kiếm. Biểu thức này hỗ trợ một tập hợp con của cú pháp được mô tả tại https://google.aip.dev/160.

Mặc dù documents.searchDocumentChunks trả về DocumentChunk, nhưng bộ lọc được áp dụng cho các trường DocumentChunk.document.

Các trường được hỗ trợ để lọc:

  • contentLengthBytes (INTEGER): Độ dài của trường Document.content tính bằng byte.
  • dataSource (STRING): Nguồn của tài liệu, ví dụ: docs.cloud.google.com. Hãy xem https://developers.google.com/knowledge/reference/corpus-reference để xem danh sách đầy đủ các nguồn dữ liệu trong kho ngữ liệu.
  • updateTime (DẤU THỜI GIAN): Dấu thời gian cho biết lần cập nhật có ý nghĩa gần đây nhất của tài liệu. Bản cập nhật có ý nghĩa là bản cập nhật làm thay đổi nội dung markdown hoặc siêu dữ liệu của tài liệu.
  • uri (STRING): URI của tài liệu, ví dụ: https://docs.cloud.google.com/bigquery/docs/tables.

Các trường INTEGER hỗ trợ toán tử =, <, <=, > và >=.

Các trường STRING hỗ trợ toán tử = (bằng) và != (không bằng) để khớp chính xác trên toàn bộ chuỗi. Chúng tôi không hỗ trợ các tiêu chí khớp một phần, khớp tiền tố và khớp với biểu thức chính quy.

Các trường DẤU THỜI GIAN hỗ trợ toán tử =, <, <=, > và >=. Dấu thời gian phải ở định dạng RFC-3339, ví dụ: "2025-01-01T00:00:00Z".

Bạn có thể kết hợp các biểu thức bằng cách sử dụng toán tử logic AND, OR và NOT (hoặc -). OR có mức độ ưu tiên cao hơn AND. Sử dụng dấu ngoặc đơn để nhóm theo mức độ ưu tiên rõ ràng.

Ví dụ:

  • Lọc theo Document.content_length_bytes: contentLengthBytes < 50000
  • dataSource = "docs.cloud.google.com" OR dataSource = "firebase.google.com"
  • dataSource != "firebase.google.com"
  • updateTime < "2024-01-01T00:00:00Z"
  • updateTime >= "2025-01-22T00:00:00Z" AND (dataSource = "developer.chrome.com" OR dataSource = "web.dev")
  • uri = "https://docs.cloud.google.com/release-notes"

Chuỗi filter không được vượt quá 500 ký tự; các giá trị dài hơn 500 ký tự sẽ dẫn đến lỗi INVALID_ARGUMENT.

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

Thông báo phản hồi cho DeveloperKnowledge.SearchDocumentChunks.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "results": [
    {
      object (DocumentChunk)
    }
  ],
  "nextPageToken": string
}
Trường
results[]

object (DocumentChunk)

Chứa kết quả tìm kiếm cho truy vấn đã cho. Mỗi DocumentChunk trong danh sách này đều chứa một đoạn nội dung liên quan đến cụm từ tìm kiếm. Sử dụng trường DocumentChunk.parent của mỗi kết quả với DeveloperKnowledge.GetDocument hoặc DeveloperKnowledge.BatchGetDocuments để truy xuất toàn bộ nội dung tài liệu.
nextPageToken

string

Cung cấp một mã thông báo có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo. Nếu bạn bỏ qua trường này, thì sẽ không có các trang tiếp theo.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/devprofiles.full_control
  • https://www.googleapis.com/auth/developerprofiles.readonly
  • https://www.googleapis.com/auth/cloud-platform

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.