ফাইল সার্চ এপিআই গুগলের পরিকাঠামো ব্যবহার করে রিট্রিভাল অগমেন্টেড জেনারেশন (আরএজি) সিস্টেম তৈরির জন্য একটি হোস্টেড প্রশ্ন উত্তর পরিষেবা প্রদান করে।
পদ্ধতি: media.uploadToFileSearchStore
একটি FileSearchStore-এ ডেটা আপলোড করে, FileSearchStore ডকুমেন্টে সংরক্ষণ করার আগে প্রি-প্রসেস এবং খণ্ড করে।
শেষবিন্দু
https: / /generativelanguage.googleapis.com /upload /v1beta /{fileSearchStoreName=fileSearchStores /*}:uploadToFileSearchStorehttps: / /generativelanguage.googleapis.com /v1beta /{fileSearchStoreName=fileSearchStores /*}:uploadToFileSearchStore
পথের পরামিতি
fileSearchStoreNamestring প্রয়োজনীয়। অপরিবর্তনীয়। ফাইল আপলোড করার জন্য FileSearchStore এর নাম। উদাহরণ: fileSearchStores/my-file-search-store-123 এটি fileSearchStores/{filesearchstore} রূপ নেয়।
অনুরোধের মূল অংশ
অনুরোধের মূল অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
displayNamestringঐচ্ছিক। তৈরি নথির নাম প্রদর্শন করুন।
customMetadata[]object ( CustomMetadata )ডেটার সাথে যুক্ত করার জন্য কাস্টম মেটাডেটা।
chunkingConfigobject ( ChunkingConfig )ঐচ্ছিক। পরিষেবাকে ডেটা কীভাবে ভাগ করতে হবে তা বলার জন্য কনফিগারেশন। যদি সরবরাহ না করা হয়, তবে পরিষেবাটি ডিফল্ট প্যারামিটার ব্যবহার করবে।
mimeTypestringঐচ্ছিক। ডেটার MIME ধরণ। যদি সরবরাহ না করা হয়, তাহলে আপলোড করা সামগ্রী থেকে এটি অনুমান করা হবে।
প্রতিক্রিয়া মূল অংশ
যদি সফল হয়, তাহলে রেসপন্স বডিতে নিম্নলিখিত কাঠামো সহ ডেটা থাকবে:
namestring The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should be a resource name ending with operations/{unique_id} .
metadataobjectService-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
একটি অবজেক্টে একটি নির্দিষ্ট ধরণের ফিল্ড রয়েছে। একটি অতিরিক্ত ফিল্ড "@type" এ একটি URI রয়েছে যা টাইপটি সনাক্ত করে। উদাহরণ: { "id": 1234, "@type": "types.example.com/standard/id" } ।
boolean done যদি মানটি false হয়, তাহলে এর অর্থ হল অপারেশনটি এখনও চলছে। যদি true , তাহলে অপারেশনটি সম্পন্ন হয়েছে, এবং error অথবা response পাওয়া যাবে।
resultUnion typeerror or a valid response . If done == false , neither error nor response is set. If done == true , exactly one of error or response can be set. Some services might not provide the result. result can be only one of the following: errorobject ( Status )ব্যর্থতা বা বাতিলকরণের ক্ষেত্রে অপারেশনের ত্রুটির ফলাফল।
responseobject অপারেশনের স্বাভাবিক, সফল প্রতিক্রিয়া। যদি মূল পদ্ধতিটি সাফল্যের উপর কোনও তথ্য প্রদান না করে, যেমন Delete , তাহলে প্রতিক্রিয়াটি হল google.protobuf.Empty । যদি মূল পদ্ধতিটি স্ট্যান্ডার্ড Get / Create / Update হয়, তাহলে প্রতিক্রিয়াটি রিসোর্স হওয়া উচিত। অন্যান্য পদ্ধতির জন্য, প্রতিক্রিয়াটির ধরণ XxxResponse হওয়া উচিত, যেখানে Xxx হল মূল পদ্ধতির নাম। উদাহরণস্বরূপ, যদি মূল পদ্ধতির নাম TakeSnapshot() হয়, তাহলে অনুমানকৃত প্রতিক্রিয়ার ধরণ হল TakeSnapshotResponse ।
একটি অবজেক্টে একটি নির্দিষ্ট ধরণের ফিল্ড রয়েছে। একটি অতিরিক্ত ফিল্ড "@type" এ একটি URI রয়েছে যা টাইপটি সনাক্ত করে। উদাহরণ: { "id": 1234, "@type": "types.example.com/standard/id" } ।
| JSON উপস্থাপনা |
|---|
{
"name": string,
"metadata": {
"@type": string,
field1: ...,
...
},
"done": boolean,
// result
"error": {
object ( |
পদ্ধতি: fileSearchStores.create
একটি খালি FileSearchStore তৈরি করে।
শেষবিন্দু
পোস্টhttps: / /generativelanguage.googleapis.com /v1beta /fileSearchStoresঅনুরোধের মূল অংশ
অনুরোধের বডিতে FileSearchStore এর একটি উদাহরণ রয়েছে।
displayNamestring ঐচ্ছিক। FileSearchStore এর জন্য মানুষের পঠনযোগ্য প্রদর্শন নাম। প্রদর্শন নামটি অবশ্যই ৫১২ অক্ষরের বেশি দৈর্ঘ্যের হতে হবে না, স্পেস সহ। উদাহরণ: "Docs on Semantic Retriever"
প্রতিক্রিয়া মূল অংশ
যদি সফল হয়, তাহলে রেসপন্স বডিতে FileSearchStore এর একটি নতুন তৈরি উদাহরণ থাকবে।
পদ্ধতি: fileSearchStores.delete
একটি FileSearchStore মুছে ফেলে।
শেষবিন্দু
https মুছে ফেলুনhttps: / /generativelanguage.googleapis.com /v1beta /{name=fileSearchStores /*}পথের পরামিতি
namestring প্রয়োজনীয়। FileSearchStore এর রিসোর্স নাম। উদাহরণ: fileSearchStores/my-file-search-store-123 এটি fileSearchStores/{filesearchstore} রূপ নেয়।
কোয়েরি প্যারামিটার
forceboolean ঐচ্ছিক। যদি সত্য হিসেবে সেট করা হয়, তাহলে এই FileSearchStore এর সাথে সম্পর্কিত যেকোনো Document এবং অবজেক্টও মুছে ফেলা হবে।
যদি মিথ্যা (ডিফল্ট) হয়, তাহলে FileSearchStore কোনও Document থাকলে একটি FAILED_PRECONDITION ত্রুটি ফেরত পাঠানো হবে।
অনুরোধের মূল অংশ
অনুরোধের মূল অংশটি অবশ্যই খালি থাকতে হবে।
প্রতিক্রিয়া মূল অংশ
যদি সফল হয়, তাহলে রেসপন্স বডিটি একটি খালি JSON অবজেক্ট হবে।
পদ্ধতি: fileSearchStores.get
একটি নির্দিষ্ট FileSearchStore সম্পর্কে তথ্য পায়।
শেষবিন্দু
https পানhttps: / /generativelanguage.googleapis.com /v1beta /{name=fileSearchStores /*}পথের পরামিতি
namestring প্রয়োজনীয়। FileSearchStore এর নাম। উদাহরণ: fileSearchStores/my-file-search-store-123 এটি fileSearchStores/{filesearchstore} রূপ নেয়।
অনুরোধের মূল অংশ
অনুরোধের মূল অংশটি অবশ্যই খালি থাকতে হবে।
প্রতিক্রিয়া মূল অংশ
যদি সফল হয়, তাহলে রেসপন্স বডিতে FileSearchStore এর একটি উদাহরণ থাকবে।
পদ্ধতি: fileSearchStores.list
ব্যবহারকারীর মালিকানাধীন সমস্ত FileSearchStores তালিকাভুক্ত করে।
শেষবিন্দু
https: / /generativelanguage.googleapis.com /v1beta /fileSearchStores পানকোয়েরি প্যারামিটার
pageSizeinteger ঐচ্ছিক। (প্রতি পৃষ্ঠায়) ফেরত পাঠানোর জন্য সর্বাধিক কতগুলি FileSearchStores আছে। পরিষেবাটি কম FileSearchStores ফেরত দিতে পারে।
যদি নির্দিষ্ট না করা থাকে, তাহলে সর্বাধিক ১০টি FileSearchStores ফেরত পাঠানো হবে। সর্বোচ্চ আকারের সীমা হল প্রতি পৃষ্ঠায় ২০টি FileSearchStores ।
pageTokenstring ঐচ্ছিক। একটি পৃষ্ঠা টোকেন, পূর্ববর্তী fileSearchStores.list কল থেকে প্রাপ্ত।
পরবর্তী পৃষ্ঠাটি পুনরুদ্ধারের জন্য পরবর্তী অনুরোধের যুক্তি হিসেবে প্রতিক্রিয়ায় ফিরে আসা nextPageToken প্রদান করুন।
পৃষ্ঠাকরণের সময়, fileSearchStores.list এ প্রদত্ত অন্যান্য সমস্ত প্যারামিটার অবশ্যই পৃষ্ঠা টোকেন প্রদানকারী কলের সাথে মিলবে।
অনুরোধের মূল অংশ
অনুরোধের মূল অংশটি অবশ্যই খালি থাকতে হবে।
প্রতিক্রিয়া মূল অংশ
fileSearchStores.list থেকে প্রাপ্ত প্রতিক্রিয়া যেখানে FileSearchStores এর একটি পৃষ্ঠাঙ্কিত তালিকা রয়েছে। ফলাফলগুলি fileSearchStore.create_time ঊর্ধ্বমুখী ক্রম অনুসারে সাজানো হয়েছে।
যদি সফল হয়, তাহলে রেসপন্স বডিতে নিম্নলিখিত কাঠামো সহ ডেটা থাকবে:
fileSearchStores[]object ( FileSearchStore )ফেরত আসা র্যাগ_স্টোর।
nextPageTokenstring একটি টোকেন, যা পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করার জন্য pageToken হিসেবে পাঠানো যেতে পারে। যদি এই ক্ষেত্রটি বাদ দেওয়া হয়, তাহলে আর কোনও পৃষ্ঠা থাকবে না।
| JSON উপস্থাপনা |
|---|
{
"fileSearchStores": [
{
object ( |
পদ্ধতি: fileSearchStores.importFile
ফাইল সার্ভিস থেকে একটি File FileSearchStore আমদানি করে।
শেষবিন্দু
পোস্টhttps: / /generativelanguage.googleapis.com /v1beta /{fileSearchStoreName=fileSearchStores /*}:importFileপথের পরামিতি
fileSearchStoreNamestring প্রয়োজনীয়। অপরিবর্তনীয়। ফাইলটি যে FileSearchStore এ আমদানি করতে হবে তার নাম। উদাহরণ: fileSearchStores/my-file-search-store-123 এটি fileSearchStores/{filesearchstore} রূপ নেয়।
অনুরোধের মূল অংশ
অনুরোধের মূল অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
fileNamestring প্রয়োজনীয়। আমদানি করার জন্য File নাম। উদাহরণ: files/abc-123
customMetadata[]object ( CustomMetadata )ফাইলের সাথে যুক্ত করার জন্য কাস্টম মেটাডেটা।
chunkingConfigobject ( ChunkingConfig )ঐচ্ছিক। ফাইলটি কীভাবে চাঙ্ক করতে হবে তা পরিষেবাকে বলার জন্য কনফিগারেশন। যদি সরবরাহ না করা হয়, তবে পরিষেবাটি ডিফল্ট প্যারামিটার ব্যবহার করবে।
প্রতিক্রিয়া মূল অংশ
যদি সফল হয়, তাহলে রেসপন্স বডিতে Operation এর একটি উদাহরণ থাকবে।
REST রিসোর্স: fileSearchStores.operations
রিসোর্স: অপারেশন
এই রিসোর্সটি একটি দীর্ঘমেয়াদী অপারেশনের প্রতিনিধিত্ব করে যা একটি নেটওয়ার্ক API কলের ফলাফল।
namestring The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should be a resource name ending with operations/{unique_id} .
metadataobjectService-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
একটি অবজেক্টে একটি নির্দিষ্ট ধরণের ফিল্ড রয়েছে। একটি অতিরিক্ত ফিল্ড "@type" এ একটি URI রয়েছে যা টাইপটি সনাক্ত করে। উদাহরণ: { "id": 1234, "@type": "types.example.com/standard/id" } ।
boolean done যদি মানটি false হয়, তাহলে এর অর্থ হল অপারেশনটি এখনও চলছে। যদি true , তাহলে অপারেশনটি সম্পন্ন হয়েছে, এবং error অথবা response পাওয়া যাবে।
resultUnion typeerror or a valid response . If done == false , neither error nor response is set. If done == true , exactly one of error or response can be set. Some services might not provide the result. result can be only one of the following:errorobject ( Status )ব্যর্থতা বা বাতিলকরণের ক্ষেত্রে অপারেশনের ত্রুটির ফলাফল।
responseobject অপারেশনের স্বাভাবিক, সফল প্রতিক্রিয়া। যদি মূল পদ্ধতিটি সাফল্যের উপর কোনও তথ্য প্রদান না করে, যেমন Delete , তাহলে প্রতিক্রিয়াটি হল google.protobuf.Empty । যদি মূল পদ্ধতিটি স্ট্যান্ডার্ড Get / Create / Update হয়, তাহলে প্রতিক্রিয়াটি রিসোর্স হওয়া উচিত। অন্যান্য পদ্ধতির জন্য, প্রতিক্রিয়াটির ধরণ XxxResponse হওয়া উচিত, যেখানে Xxx হল মূল পদ্ধতির নাম। উদাহরণস্বরূপ, যদি মূল পদ্ধতির নাম TakeSnapshot() হয়, তাহলে অনুমানকৃত প্রতিক্রিয়ার ধরণ হল TakeSnapshotResponse ।
একটি অবজেক্টে একটি নির্দিষ্ট ধরণের ফিল্ড রয়েছে। একটি অতিরিক্ত ফিল্ড "@type" এ একটি URI রয়েছে যা টাইপটি সনাক্ত করে। উদাহরণ: { "id": 1234, "@type": "types.example.com/standard/id" } ।
| JSON উপস্থাপনা |
|---|
{
"name": string,
"metadata": {
"@type": string,
field1: ...,
...
},
"done": boolean,
// result
"error": {
object ( |
পদ্ধতি: fileSearchStores.operations.get
দীর্ঘমেয়াদী অপারেশনের সর্বশেষ অবস্থা পায়। ক্লায়েন্টরা API পরিষেবা দ্বারা সুপারিশকৃত বিরতিতে অপারেশন ফলাফল পোল করার জন্য এই পদ্ধতিটি ব্যবহার করতে পারেন।
শেষবিন্দু
https পানhttps: / /generativelanguage.googleapis.com /v1beta /{name=fileSearchStores /* /operations /*}পথের পরামিতি
namestring অপারেশন রিসোর্সের নাম। এটি fileSearchStores/{filesearchstore}/operations/{operation} রূপ নেয়।
অনুরোধের মূল অংশ
অনুরোধের মূল অংশটি অবশ্যই খালি থাকতে হবে।
প্রতিক্রিয়া মূল অংশ
যদি সফল হয়, তাহলে রেসপন্স বডিতে Operation এর একটি উদাহরণ থাকবে।
REST রিসোর্স: fileSearchStores.upload.operations
রিসোর্স: অপারেশন
এই রিসোর্সটি একটি দীর্ঘমেয়াদী অপারেশনের প্রতিনিধিত্ব করে যা একটি নেটওয়ার্ক API কলের ফলাফল।
namestring The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should be a resource name ending with operations/{unique_id} .
metadataobjectService-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
একটি অবজেক্টে একটি নির্দিষ্ট ধরণের ফিল্ড রয়েছে। একটি অতিরিক্ত ফিল্ড "@type" এ একটি URI রয়েছে যা টাইপটি সনাক্ত করে। উদাহরণ: { "id": 1234, "@type": "types.example.com/standard/id" } ।
boolean done যদি মানটি false হয়, তাহলে এর অর্থ হল অপারেশনটি এখনও চলছে। যদি true , তাহলে অপারেশনটি সম্পন্ন হয়েছে, এবং error অথবা response পাওয়া যাবে।
resultUnion typeerror or a valid response . If done == false , neither error nor response is set. If done == true , exactly one of error or response can be set. Some services might not provide the result. result can be only one of the following:errorobject ( Status )ব্যর্থতা বা বাতিলকরণের ক্ষেত্রে অপারেশনের ত্রুটির ফলাফল।
responseobject অপারেশনের স্বাভাবিক, সফল প্রতিক্রিয়া। যদি মূল পদ্ধতিটি সাফল্যের উপর কোনও তথ্য প্রদান না করে, যেমন Delete , তাহলে প্রতিক্রিয়াটি হল google.protobuf.Empty । যদি মূল পদ্ধতিটি স্ট্যান্ডার্ড Get / Create / Update হয়, তাহলে প্রতিক্রিয়াটি রিসোর্স হওয়া উচিত। অন্যান্য পদ্ধতির জন্য, প্রতিক্রিয়াটির ধরণ XxxResponse হওয়া উচিত, যেখানে Xxx হল মূল পদ্ধতির নাম। উদাহরণস্বরূপ, যদি মূল পদ্ধতির নাম TakeSnapshot() হয়, তাহলে অনুমানকৃত প্রতিক্রিয়ার ধরণ হল TakeSnapshotResponse ।
একটি অবজেক্টে একটি নির্দিষ্ট ধরণের ফিল্ড রয়েছে। একটি অতিরিক্ত ফিল্ড "@type" এ একটি URI রয়েছে যা টাইপটি সনাক্ত করে। উদাহরণ: { "id": 1234, "@type": "types.example.com/standard/id" } ।
| JSON উপস্থাপনা |
|---|
{
"name": string,
"metadata": {
"@type": string,
field1: ...,
...
},
"done": boolean,
// result
"error": {
object ( |
পদ্ধতি: fileSearchStores.upload.operations.get
দীর্ঘমেয়াদী অপারেশনের সর্বশেষ অবস্থা পায়। ক্লায়েন্টরা API পরিষেবা দ্বারা সুপারিশকৃত বিরতিতে অপারেশন ফলাফল পোল করার জন্য এই পদ্ধতিটি ব্যবহার করতে পারেন।
শেষবিন্দু
https পানhttps: / /generativelanguage.googleapis.com /v1beta /{name=fileSearchStores /* /upload /operations /*}পথের পরামিতি
namestring অপারেশন রিসোর্সের নাম। এটি fileSearchStores/{filesearchstore}/upload/operations/{operation} রূপ নেয়।
অনুরোধের মূল অংশ
অনুরোধের মূল অংশটি অবশ্যই খালি থাকতে হবে।
প্রতিক্রিয়া মূল অংশ
যদি সফল হয়, তাহলে রেসপন্স বডিতে Operation এর একটি উদাহরণ থাকবে।
REST রিসোর্স: ফাইল সার্চস্টোরস
রিসোর্স: ফাইলসার্চস্টোর
একটি FileSearchStore হল Document একটি সংগ্রহ।
namestring শুধুমাত্র আউটপুট। অপরিবর্তনীয়। শনাক্তকারী। FileSearchStore রিসোর্স নাম। এটি একটি আইডি ("fileSearchStores/" উপসর্গ বাদে নাম) যাতে ৪০টি পর্যন্ত অক্ষর থাকতে পারে যা ছোট হাতের বর্ণমালা বা ড্যাশ (-)। এটি শুধুমাত্র আউটপুট। অনন্য নামটি displayName থেকে নেওয়া হবে এবং এর সাথে একটি ১২ অক্ষরের র্যান্ডম প্রত্যয় থাকবে। উদাহরণ: fileSearchStores/my-awesome-file-search-store-123a456b789c যদি displayName প্রদান না করা হয়, তাহলে নামটি এলোমেলোভাবে তৈরি হবে।
displayNamestring ঐচ্ছিক। FileSearchStore এর জন্য মানুষের পঠনযোগ্য প্রদর্শন নাম। প্রদর্শন নামটি অবশ্যই ৫১২ অক্ষরের বেশি দৈর্ঘ্যের হতে হবে না, স্পেস সহ। উদাহরণ: "Docs on Semantic Retriever"
createTimestring ( Timestamp format) শুধুমাত্র আউটপুট। FileSearchStore তৈরির সময়কালের টাইমস্ট্যাম্প।
Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30" .
updateTimestring ( Timestamp format) শুধুমাত্র আউটপুট। FileSearchStore শেষবার কখন আপডেট করা হয়েছিল তার টাইমস্ট্যাম্প।
Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30" .
activeDocumentsCountstring ( int64 format) শুধুমাত্র আউটপুট। FileSearchStore এ সক্রিয় এবং পুনরুদ্ধারের জন্য প্রস্তুত নথির সংখ্যা।
pendingDocumentsCountstring ( int64 format) শুধুমাত্র আউটপুট। FileSearchStore প্রক্রিয়াজাত নথির সংখ্যা।
failedDocumentsCountstring ( int64 format) শুধুমাত্র আউটপুট। FileSearchStore প্রক্রিয়াকরণে ব্যর্থ নথির সংখ্যা।
sizeBytesstring ( int64 format) শুধুমাত্র আউটপুট। FileSearchStore এ প্রবেশ করা raw বাইটের আকার। এটি FileSearchStore এর সমস্ত ডকুমেন্টের মোট আকার।
| JSON উপস্থাপনা |
|---|
{ "name": string, "displayName": string, "createTime": string, "updateTime": string, "activeDocumentsCount": string, "pendingDocumentsCount": string, "failedDocumentsCount": string, "sizeBytes": string } |