Method: corpora.list

تمام Corpora متعلق به کاربر را فهرست می کند.

درخواست HTTP

GET https://generativelanguage.googleapis.com/v1beta/corpora

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای پرس و جو

مولفه های
pageSize

integer

اختیاری. حداکثر تعداد Corpora برای بازگشت (در هر صفحه). ممکن است این سرویس Corpora کمتری را برگرداند.

اگر نامشخص باشد، حداکثر 10 Corpora برگردانده می شود. حداکثر اندازه مجاز 20 Corpora در هر صفحه است.

pageToken

string

اختیاری. یک نشانه صفحه، دریافت شده از تماس قبلی corpora.list .

nextPageToken بازگشتی در پاسخ را به عنوان آرگومان درخواست بعدی برای بازیابی صفحه بعدی ارائه دهید.

هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به corpora.list باید با فراخوانی که توکن صفحه را ارائه می کند مطابقت داشته باشد.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

پاسخ از corpora.list حاوی فهرست صفحه بندی شده Corpora . نتایج بر اساس صعودی corpus.create_time مرتب شده اند.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "corpora": [
    {
      object (Corpus)
    }
  ],
  "nextPageToken": string
}
زمینه های
corpora[]

object ( Corpus )

مجموعه های برگشتی

nextPageToken

string

یک نشانه، که می تواند به عنوان pageToken برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، صفحه دیگری وجود ندارد.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی احراز هویت مراجعه کنید.