Documents

File Search API tham chiếu các tệp nguồn thô hoặc tài liệu của bạn dưới dạng các đối tượng Tệp tạm thời.

Phương thức: fileSearchStores.documents.delete

Xoá một Document.

Điểm cuối

xoá https://generativelanguage.googleapis.com/v1beta/{name=fileSearchStores/*/documents/*}

Tham số đường dẫn

name string

Bắt buộc. Tên tài nguyên của Document cần xoá. Ví dụ: fileSearchStores/my-file-search-store-123/documents/the-doc-abc Tên này có dạng fileSearchStores/{filesearchstore}/documents/{document}.

Tham số truy vấn

force boolean

Không bắt buộc. Nếu bạn đặt thành true, mọi Chunk và đối tượng liên quan đến Document này cũng sẽ bị xoá.

Nếu là false (mặc định), lỗi FAILED_PRECONDITION sẽ được trả về nếu Document chứa bất kỳ Chunk nào.

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, phần nội dung phản hồi sẽ là một đối tượng JSON trống.

Phương thức: fileSearchStores.documents.get

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

Điểm cuối

get https://generativelanguage.googleapis.com/v1beta/{name=fileSearchStores/*/documents/*}

Tham số đường dẫn

name string

Bắt buộc. Tên của Document cần truy xuất. Ví dụ: fileSearchStores/my-file-search-store-123/documents/the-doc-abc Tên này có dạng fileSearchStores/{filesearchstore}/documents/{document}.

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 thực thể của Document.

Phương thức: fileSearchStores.documents.list

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

Điểm cuối

get https://generativelanguage.googleapis.com/v1beta/{parent=fileSearchStores/*}/documents

Tham số đường dẫn

parent string

Bắt buộc. Tên của FileSearchStore chứa các Document. Ví dụ: fileSearchStores/my-file-search-store-123 Tên này có dạng fileSearchStores/{filesearchstore}.

Tham số truy vấn

pageSize integer

Không bắt buộc. Số lượng Document tối đa cần trả về (trên mỗi trang). Dịch vụ có thể trả về ít Document hơn.

Nếu không chỉ định, tối đa 10 Document sẽ được trả về. Giới hạn kích thước tối đa là 20 Document cho mỗi trang.

pageToken string

Không bắt buộc. Mã thông báo trang nhận được từ một lệnh gọi documents.list trước đó.

Cung cấp nextPageToken được trả về trong phản hồi dưới dạng một đối số cho yêu cầu tiếp theo để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho documents.list phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

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

Phản hồi từ documents.list chứa danh sách được phân trang của Document. Các Document được sắp xếp theo document.create_time tăng dần.

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:

Trường
documents[] object (Document)

Document được trả về.

nextPageToken string

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òn trang nào nữa.

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

Tài nguyên REST: fileSearchStores.documents

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

Document là một tập hợp các Chunk.

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ố "fileSearchStores/*/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 dấu gạch ngang. Nếu tên bị trống khi tạo, thì một tên duy nhất sẽ được lấy từ displayName cùng với một hậu tố ngẫu nhiên gồm 12 ký tự. Ví dụ: fileSearchStores/{file_search_store_id}/documents/my-awesome-doc-123a456b789c

displayName string

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

customMetadata[] object (CustomMetadata)

Không bắt buộc. Siêu dữ liệu tuỳ chỉnh do người dùng cung cấp được lưu trữ dưới dạng các 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 cho biết thời điểm Document được cập nhật lần gần đây nhất.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

createTime string (Timestamp format)

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

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

state enum (State)

Chỉ có đầu ra. Trạng thái hiện tại của Document.

sizeBytes string (int64 format)

Chỉ có đầu ra. Kích thước của các byte thô được nhập vào Tài liệu.

mimeType string

Chỉ có đầu ra. Loại MIME của Tài liệu.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "displayName": string,
  "customMetadata": [
    {
      object (CustomMetadata)
    }
  ],
  "updateTime": string,
  "createTime": string,
  "state": enum (State),
  "sizeBytes": string,
  "mimeType": string
}

CustomMetadata

Siêu dữ liệu do người dùng cung cấp được lưu trữ dưới dạng các cặp khoá-giá trị.

Trường
key string

Bắt buộc. Khoá của siêu dữ liệu cần lưu trữ.

value Union type
value chỉ có thể là một trong những trạng thái sau:
stringValue string

Giá trị kiểu chuỗi của siêu dữ liệu cần lưu trữ.

stringListValue object (StringList)

Giá trị StringList của siêu dữ liệu cần lưu trữ.

numericValue number

Giá trị số của siêu dữ liệu cần lưu trữ.

Biểu diễn dưới dạng JSON 
{
  "key": string,

  // value
  "stringValue": string,
  "stringListValue": {
    object (StringList)
  },
  "numericValue": number
  // Union type
}

StringList

Giá trị chuỗi do người dùng cung cấp được chỉ định cho một khoá siêu dữ liệu duy nhất.

Trường
values[] string

Giá trị chuỗi của siêu dữ liệu cần lưu trữ.

Biểu diễn dưới dạng JSON 
{
  "values": [
    string
  ]
}

Bang

Các trạng thái cho vòng đời của một Document.

Enum
STATE_UNSPECIFIED Giá trị mặc định. Giá trị này được dùng nếu bạn bỏ qua trạng thái.
STATE_PENDING Một số Chunks trong số Document đang được xử lý (nhúng và lưu trữ vectơ).
STATE_ACTIVE Tất cả Chunks của Document đều được xử lý và có thể truy vấn.
STATE_FAILED Không xử lý được một số Chunks của Document.