Documents

File Search API, ham kaynak dosyalarınıza veya dokümanlarınıza geçici Dosya nesneleri olarak referans verir.

Yöntem: fileSearchStores.documents.delete

Document öğesini siler.

Uç nokta

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

Yol parametreleri

name string

Zorunlu. Silinecek Document öğesinin kaynak adı. Örnek: fileSearchStores/my-file-search-store-123/documents/the-doc-abc fileSearchStores/{filesearchstore}/documents/{document} biçimini alır.

Sorgu parametreleri

force boolean

İsteğe bağlıdır. Doğru olarak ayarlanırsa bu Document ile ilgili tüm Chunk'ler ve nesneler de silinir.

Yanlış ise (varsayılan) Document, Chunk içeriyorsa FAILED_PRECONDITION hatası döndürülür.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

Başarılı olursa yanıt metni boş bir JSON nesnesi olur.

Yöntem: fileSearchStores.documents.get

Belirli bir Document hakkında bilgi alır.

Uç nokta

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

Yol parametreleri

name string

Zorunlu. Alınacak Document öğesinin adı. Örnek: fileSearchStores/my-file-search-store-123/documents/the-doc-abc fileSearchStores/{filesearchstore}/documents/{document} biçimini alır.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

Başarılıysa yanıt metni, Document öğesinin bir örneğini içerir.

Yöntem: fileSearchStores.documents.list

Bir Corpus içindeki tüm Document'ları listeler.

Uç nokta

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

Yol parametreleri

parent string

Zorunlu. FileSearchStore içeren Document adıdır. Örnek: fileSearchStores/my-file-search-store-123 fileSearchStores/{filesearchstore} biçimini alır.

Sorgu parametreleri

pageSize integer

İsteğe bağlıdır. Döndürülecek maksimum Document sayısı (sayfa başına). Hizmet daha az Document döndürebilir.

Belirtilmemişse en fazla 10 Document döndürülür. Maksimum boyut sınırı, sayfa başına 20 Document'dir.

pageToken string

İsteğe bağlıdır. Önceki bir documents.list çağrısından alınan sayfa jetonu.

Sonraki sayfayı almak için bir sonraki isteğe bağımsız değişken olarak yanıtta döndürülen nextPageToken değerini sağlayın.

Sayfalara ayırma işlemi yapılırken documents.list öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

documents.list öğesinden, Document öğelerinin sayfalandırılmış listesini içeren yanıt. Document, artan document.create_time değerine göre sıralanır.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

Alanlar
documents[] object (Document)

Döndürülen Document'ler.

nextPageToken string

Sonraki sayfayı almak için pageToken olarak gönderilebilen bir jeton. Bu alan atlanırsa başka sayfa yoktur.

JSON gösterimi 
{
  "documents": [
    {
      object (Document)
    }
  ],
  "nextPageToken": string
}

REST Kaynağı: fileSearchStores.documents

Kaynak: Doküman

Document, Chunk koleksiyonudur.

Alanlar
name string

Değişmez. Tanımlayıcı. Document kaynak adı. Kimlik ("fileSearchStores/*/documents/" öneki hariç ad) küçük harfli alfanümerik karakterler veya kısa çizgiler (-) içeren en fazla 40 karakterden oluşabilir. Kimlik kısa çizgiyle başlayamaz veya bitemez. Oluşturma sırasında ad boşsa displayName öğesinden 12 karakterlik rastgele bir sonek ile birlikte benzersiz bir ad türetilir. Örnek: fileSearchStores/{file_search_store_id}/documents/my-awesome-doc-123a456b789c

displayName string

İsteğe bağlıdır. Document için kullanıcılar tarafından okunabilir görünen ad. Görünen ad, boşluklar dahil olmak üzere en fazla 512 karakter uzunluğunda olmalıdır. Örnek: "Semantic Retriever Documentation" (Anlamsal Alıcı Dokümanları)

customMetadata[] object (CustomMetadata)

İsteğe bağlıdır. Kullanıcı tarafından sağlanan özel meta veriler, sorgulama için kullanılan anahtar/değer çiftleri olarak depolanır. Bir Document en fazla 20 CustomMetadata içerebilir.

updateTime string (Timestamp format)

Yalnızca çıkış. Document öğesinin en son güncellendiği zamanın zaman damgası.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

createTime string (Timestamp format)

Yalnızca çıkış. Document oluşturulduğu zamanın zaman damgası.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

state enum (State)

Yalnızca çıkış. Document'nın mevcut durumu.

sizeBytes string (int64 format)

Yalnızca çıkış. Belgeye alınan ham baytların boyutu.

mimeType string

Yalnızca çıkış. Belgenin MIME türü.

JSON gösterimi 
{
  "name": string,
  "displayName": string,
  "customMetadata": [
    {
      object (CustomMetadata)
    }
  ],
  "updateTime": string,
  "createTime": string,
  "state": enum (State),
  "sizeBytes": string,
  "mimeType": string
}

CustomMetadata

Kullanıcı tarafından sağlanan meta veriler, anahtar/değer çiftleri olarak depolanır.

Alanlar
key string

Zorunlu. Depolanacak meta verilerin anahtarı.

value Union type
value aşağıdakilerden yalnızca biri olabilir:
stringValue string

Depolanacak meta verilerin dize değeri.

stringListValue object (StringList)

Depolanacak meta verilerin StringList değeri.

numericValue number

Depolanacak meta verilerin sayısal değeri.

JSON gösterimi 
{
  "key": string,

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

StringList

Tek bir meta veri anahtarına atanan, kullanıcı tarafından sağlanan dize değerleri.

Alanlar
values[] string

Depolanacak meta verilerin dize değerleri.

JSON gösterimi 
{
  "values": [
    string
  ]
}

Eyalet

Document yaşam döngüsündeki durumlar.

Sıralamalar
STATE_UNSPECIFIED Varsayılan değer. Eyalet belirtilmemişse bu değer kullanılır.
STATE_PENDING Document Chunks bazıları işleniyor (yerleştirme ve vektör depolama).
STATE_ACTIVE Document alanının tamamı Chunks işlenir ve sorgulanabilir.
STATE_FAILED Document öğelerinin bazıları Chunks işlenemedi.