Method: corpora.documents.chunks.list

يسرد كل Chunk في Document.

طلب HTTP

GET https://generativelanguage.googleapis.com/v1beta/{parent=corpora/*/documents/*}/chunks

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
parent

string

مطلوبة. اسم Document الذي يتضمّن Chunk. مثال: corpora/my-corpus-123/documents/the-doc-abc

معلمات طلب البحث

المَعلمات
pageSize

integer

اختياريّ. الحدّ الأقصى لعدد Chunk ثانية المطلوب عرضها (لكل صفحة). قد تعرِض الخدمة عدد أقل من Chunk ثوانٍ.

وفي حال عدم تحديد هذا الحقل، سيتم عرض 10 ثوانٍ على الأكثر من Chunk. الحدّ الأقصى للحجم هو 100 Chunk ثانية لكل صفحة.
pageToken

string

اختياريّ. رمز مميّز للصفحة تم تلقّيه من مكالمة سابقة لـ chunks.list.

قدِّم nextPageToken المعروضة في الاستجابة كوسيطة للطلب التالي لاسترداد الصفحة التالية.

عند تقسيم النتائج على عدّة صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى chunks.list مع الطلب الذي قدَّم الرمز المميّز للصفحة.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

ردّ من chunks.list يحتوي على قائمة مقسّمة على صفحات من Chunk. يتم ترتيب Chunk تصاعديًا حسب chunk.create_time.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "chunks": [
    {
      object (Chunk)
    }
  ],
  "nextPageToken": string
}
الحقول
chunks[]

object (Chunk)

تم عرض Chunks.
nextPageToken

string

رمز مميز يمكن إرساله كـ pageToken لاسترداد الصفحة التالية إذا تم حذف هذا الحقل، هذا يعني أنّ الصفحة لا تتضمّن المزيد من الصفحات.

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/generative-language.retriever
  • https://www.googleapis.com/auth/generative-language.retriever.readonly

لمزيد من المعلومات، راجع نظرة عامة على المصادقة.