REST Resource: corpora.documents

Tài nguyên: Tài liệu

Document là một tập hợp các Chunk. Một Corpus có thể có tối đa 10.000 Document.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "displayName": string,
  "customMetadata": [
    {
      object (CustomMetadata)
    }
  ],
  "updateTime": string,
  "createTime": string
}
Các trường
name

string

Không thể thay đổi. Giá trị nhận dạng. Tên tài nguyên Document. Mã nhận dạng (tên không bao gồm tiền tố "corpora/*/documents/") có thể chứa tối đa 40 ký tự là chữ và số viết thường hoặc dấu gạch ngang (-). Mã nhận dạng không được bắt đầu hoặc kết thúc bằng một dấu gạch ngang. Nếu để trống tên khi tạo, tên riêng biệt sẽ được lấy từ displayName cùng với hậu tố ngẫu nhiên gồm 12 ký tự. Ví dụ: corpora/{corpus_id}/documents/my-awesome-doc-123a456b789c

displayName

string

Không bắt buộc. Tên hiển thị mà con người có thể đọc được của Document. Tên hiển thị không được dài quá 512 ký tự, kể cả dấu cách. Ví dụ: "Tài liệu về công cụ truy xuất ngữ nghĩa"

customMetadata[]

object (CustomMetadata)

Không bắt buộc. Người dùng đã cung cấp siêu dữ liệu tuỳ chỉnh được lưu trữ dưới dạng cặp khoá-giá trị dùng để truy vấn. Một Document có thể có tối đa 20 CustomMetadata.

updateTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian về thời điểm cập nhật Document gần đây nhất.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

createTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian về thời điểm tạo Document.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

Phương thức

create

Tạo một Document trống.

delete

Xoá Document.

get

Lấy thông tin về một Document cụ thể.

list

Liệt kê tất cả Document trong một Corpus.

patch

Cập nhật một Document.

query

Thực hiện tìm kiếm ngữ nghĩa trên Document.