File Search Stores

ফাইল সার্চ এপিআই গুগলের পরিকাঠামো ব্যবহার করে রিট্রিভাল অগমেন্টেড জেনারেশন (আরএজি) সিস্টেম তৈরির জন্য একটি হোস্টেড প্রশ্ন উত্তর পরিষেবা প্রদান করে।

পদ্ধতি: media.uploadToFileSearchStore

একটি FileSearchStore-এ ডেটা আপলোড করে, FileSearchStore ডকুমেন্টে সংরক্ষণ করার আগে প্রি-প্রসেস এবং খণ্ড করে।

শেষবিন্দু

  • মিডিয়া আপলোড অনুরোধের জন্য URI আপলোড করুন:
  • পোস্ট https: / /generativelanguage.googleapis.com /upload /v1beta /{fileSearchStoreName=fileSearchStores /*}:uploadToFileSearchStore
  • মেটাডেটা-শুধুমাত্র অনুরোধের জন্য মেটাডেটা URI:
  • পোস্ট https: / /generativelanguage.googleapis.com /v1beta /{fileSearchStoreName=fileSearchStores /*}:uploadToFileSearchStore

    পথের পরামিতি

    fileSearchStoreName string

    প্রয়োজনীয়। অপরিবর্তনীয়। ফাইল আপলোড করার জন্য FileSearchStore এর নাম। উদাহরণ: fileSearchStores/my-file-search-store-123 এটি fileSearchStores/{filesearchstore} রূপ নেয়।

    অনুরোধের মূল অংশ

    অনুরোধের মূল অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

    ক্ষেত্র
    displayName string

    ঐচ্ছিক। তৈরি নথির নাম প্রদর্শন করুন।

    customMetadata[] object ( CustomMetadata )

    ডেটার সাথে যুক্ত করার জন্য কাস্টম মেটাডেটা।

    chunkingConfig object ( ChunkingConfig )

    ঐচ্ছিক। পরিষেবাকে ডেটা কীভাবে ভাগ করতে হবে তা বলার জন্য কনফিগারেশন। যদি সরবরাহ না করা হয়, তবে পরিষেবাটি ডিফল্ট প্যারামিটার ব্যবহার করবে।

    mimeType string

    ঐচ্ছিক। ডেটার MIME ধরণ। যদি সরবরাহ না করা হয়, তাহলে আপলোড করা সামগ্রী থেকে এটি অনুমান করা হবে।

    প্রতিক্রিয়া মূল অংশ

    যদি সফল হয়, তাহলে রেসপন্স বডিতে নিম্নলিখিত কাঠামো সহ ডেটা থাকবে:

    ক্ষেত্র
    name string

    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} .

    metadata object

    Service-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 পাওয়া যাবে।

    result Union type
    The operation result, which can be either an error 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:
    error object ( Status )

    ব্যর্থতা বা বাতিলকরণের ক্ষেত্রে অপারেশনের ত্রুটির ফলাফল।

    response object

    অপারেশনের স্বাভাবিক, সফল প্রতিক্রিয়া। যদি মূল পদ্ধতিটি সাফল্যের উপর কোনও তথ্য প্রদান না করে, যেমন 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 (Status)
      },
      "response": {
        "@type": string,
        field1: ...,
        ...
      }
      // Union type
    }

    পদ্ধতি: fileSearchStores.create

    একটি খালি FileSearchStore তৈরি করে।

    শেষবিন্দু

    পোস্ট https: / /generativelanguage.googleapis.com /v1beta /fileSearchStores

    অনুরোধের মূল অংশ

    অনুরোধের বডিতে FileSearchStore এর একটি উদাহরণ রয়েছে।

    ক্ষেত্র
    displayName string

    ঐচ্ছিক। FileSearchStore এর জন্য মানুষের পঠনযোগ্য প্রদর্শন নাম। প্রদর্শন নামটি অবশ্যই ৫১২ অক্ষরের বেশি দৈর্ঘ্যের হতে হবে না, স্পেস সহ। উদাহরণ: "Docs on Semantic Retriever"

    প্রতিক্রিয়া মূল অংশ

    যদি সফল হয়, তাহলে রেসপন্স বডিতে FileSearchStore এর একটি নতুন তৈরি উদাহরণ থাকবে।

    পদ্ধতি: fileSearchStores.delete

    একটি FileSearchStore মুছে ফেলে।

    শেষবিন্দু

    https মুছে ফেলুন https: / /generativelanguage.googleapis.com /v1beta /{name=fileSearchStores /*}

    পথের পরামিতি

    name string

    প্রয়োজনীয়। FileSearchStore এর রিসোর্স নাম। উদাহরণ: fileSearchStores/my-file-search-store-123 এটি fileSearchStores/{filesearchstore} রূপ নেয়।

    কোয়েরি প্যারামিটার

    force boolean

    ঐচ্ছিক। যদি সত্য হিসেবে সেট করা হয়, তাহলে এই FileSearchStore এর সাথে সম্পর্কিত যেকোনো Document এবং অবজেক্টও মুছে ফেলা হবে।

    যদি মিথ্যা (ডিফল্ট) হয়, তাহলে FileSearchStore কোনও Document থাকলে একটি FAILED_PRECONDITION ত্রুটি ফেরত পাঠানো হবে।

    অনুরোধের মূল অংশ

    অনুরোধের মূল অংশটি অবশ্যই খালি থাকতে হবে।

    প্রতিক্রিয়া মূল অংশ

    যদি সফল হয়, তাহলে রেসপন্স বডিটি একটি খালি JSON অবজেক্ট হবে।

    পদ্ধতি: fileSearchStores.get

    একটি নির্দিষ্ট FileSearchStore সম্পর্কে তথ্য পায়।

    শেষবিন্দু

    https পান https: / /generativelanguage.googleapis.com /v1beta /{name=fileSearchStores /*}

    পথের পরামিতি

    name string

    প্রয়োজনীয়। FileSearchStore এর নাম। উদাহরণ: fileSearchStores/my-file-search-store-123 এটি fileSearchStores/{filesearchstore} রূপ নেয়।

    অনুরোধের মূল অংশ

    অনুরোধের মূল অংশটি অবশ্যই খালি থাকতে হবে।

    প্রতিক্রিয়া মূল অংশ

    যদি সফল হয়, তাহলে রেসপন্স বডিতে FileSearchStore এর একটি উদাহরণ থাকবে।

    পদ্ধতি: fileSearchStores.list

    ব্যবহারকারীর মালিকানাধীন সমস্ত FileSearchStores তালিকাভুক্ত করে।

    শেষবিন্দু

    https: / /generativelanguage.googleapis.com /v1beta /fileSearchStores পান

    কোয়েরি প্যারামিটার

    pageSize integer

    ঐচ্ছিক। (প্রতি পৃষ্ঠায়) ফেরত পাঠানোর জন্য সর্বাধিক কতগুলি FileSearchStores আছে। পরিষেবাটি কম FileSearchStores ফেরত দিতে পারে।

    যদি নির্দিষ্ট না করা থাকে, তাহলে সর্বাধিক ১০টি FileSearchStores ফেরত পাঠানো হবে। সর্বোচ্চ আকারের সীমা হল প্রতি পৃষ্ঠায় ২০টি FileSearchStores

    pageToken string

    ঐচ্ছিক। একটি পৃষ্ঠা টোকেন, পূর্ববর্তী fileSearchStores.list কল থেকে প্রাপ্ত।

    পরবর্তী পৃষ্ঠাটি পুনরুদ্ধারের জন্য পরবর্তী অনুরোধের যুক্তি হিসেবে প্রতিক্রিয়ায় ফিরে আসা nextPageToken প্রদান করুন।

    পৃষ্ঠাকরণের সময়, fileSearchStores.list এ প্রদত্ত অন্যান্য সমস্ত প্যারামিটার অবশ্যই পৃষ্ঠা টোকেন প্রদানকারী কলের সাথে মিলবে।

    অনুরোধের মূল অংশ

    অনুরোধের মূল অংশটি অবশ্যই খালি থাকতে হবে।

    প্রতিক্রিয়া মূল অংশ

    fileSearchStores.list থেকে প্রাপ্ত প্রতিক্রিয়া যেখানে FileSearchStores এর একটি পৃষ্ঠাঙ্কিত তালিকা রয়েছে। ফলাফলগুলি fileSearchStore.create_time ঊর্ধ্বমুখী ক্রম অনুসারে সাজানো হয়েছে।

    যদি সফল হয়, তাহলে রেসপন্স বডিতে নিম্নলিখিত কাঠামো সহ ডেটা থাকবে:

    ক্ষেত্র
    fileSearchStores[] object ( FileSearchStore )

    ফেরত আসা র‍্যাগ_স্টোর।

    nextPageToken string

    একটি টোকেন, যা পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করার জন্য pageToken হিসেবে পাঠানো যেতে পারে। যদি এই ক্ষেত্রটি বাদ দেওয়া হয়, তাহলে আর কোনও পৃষ্ঠা থাকবে না।

    JSON উপস্থাপনা
    {
      "fileSearchStores": [
        {
          object (FileSearchStore)
        }
      ],
      "nextPageToken": string
    }

    পদ্ধতি: fileSearchStores.importFile

    ফাইল সার্ভিস থেকে একটি File FileSearchStore আমদানি করে।

    শেষবিন্দু

    পোস্ট https: / /generativelanguage.googleapis.com /v1beta /{fileSearchStoreName=fileSearchStores /*}:importFile

    পথের পরামিতি

    fileSearchStoreName string

    প্রয়োজনীয়। অপরিবর্তনীয়। ফাইলটি যে FileSearchStore এ আমদানি করতে হবে তার নাম। উদাহরণ: fileSearchStores/my-file-search-store-123 এটি fileSearchStores/{filesearchstore} রূপ নেয়।

    অনুরোধের মূল অংশ

    অনুরোধের মূল অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

    ক্ষেত্র
    fileName string

    প্রয়োজনীয়। আমদানি করার জন্য File নাম। উদাহরণ: files/abc-123

    customMetadata[] object ( CustomMetadata )

    ফাইলের সাথে যুক্ত করার জন্য কাস্টম মেটাডেটা।

    chunkingConfig object ( ChunkingConfig )

    ঐচ্ছিক। ফাইলটি কীভাবে চাঙ্ক করতে হবে তা পরিষেবাকে বলার জন্য কনফিগারেশন। যদি সরবরাহ না করা হয়, তবে পরিষেবাটি ডিফল্ট প্যারামিটার ব্যবহার করবে।

    প্রতিক্রিয়া মূল অংশ

    যদি সফল হয়, তাহলে রেসপন্স বডিতে Operation এর একটি উদাহরণ থাকবে।

    REST রিসোর্স: fileSearchStores.operations

    রিসোর্স: অপারেশন

    এই রিসোর্সটি একটি দীর্ঘমেয়াদী অপারেশনের প্রতিনিধিত্ব করে যা একটি নেটওয়ার্ক API কলের ফলাফল।

    ক্ষেত্র
    name string

    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} .

    metadata object

    Service-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 পাওয়া যাবে।

    result Union type
    The operation result, which can be either an error 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:
    error object ( Status )

    ব্যর্থতা বা বাতিলকরণের ক্ষেত্রে অপারেশনের ত্রুটির ফলাফল।

    response object

    অপারেশনের স্বাভাবিক, সফল প্রতিক্রিয়া। যদি মূল পদ্ধতিটি সাফল্যের উপর কোনও তথ্য প্রদান না করে, যেমন 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 (Status)
      },
      "response": {
        "@type": string,
        field1: ...,
        ...
      }
      // Union type
    }

    পদ্ধতি: fileSearchStores.operations.get

    দীর্ঘমেয়াদী অপারেশনের সর্বশেষ অবস্থা পায়। ক্লায়েন্টরা API পরিষেবা দ্বারা সুপারিশকৃত বিরতিতে অপারেশন ফলাফল পোল করার জন্য এই পদ্ধতিটি ব্যবহার করতে পারেন।

    শেষবিন্দু

    https পান https: / /generativelanguage.googleapis.com /v1beta /{name=fileSearchStores /* /operations /*}

    পথের পরামিতি

    name string

    অপারেশন রিসোর্সের নাম। এটি fileSearchStores/{filesearchstore}/operations/{operation} রূপ নেয়।

    অনুরোধের মূল অংশ

    অনুরোধের মূল অংশটি অবশ্যই খালি থাকতে হবে।

    প্রতিক্রিয়া মূল অংশ

    যদি সফল হয়, তাহলে রেসপন্স বডিতে Operation এর একটি উদাহরণ থাকবে।

    REST রিসোর্স: fileSearchStores.upload.operations

    রিসোর্স: অপারেশন

    এই রিসোর্সটি একটি দীর্ঘমেয়াদী অপারেশনের প্রতিনিধিত্ব করে যা একটি নেটওয়ার্ক API কলের ফলাফল।

    ক্ষেত্র
    name string

    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} .

    metadata object

    Service-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 পাওয়া যাবে।

    result Union type
    The operation result, which can be either an error 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:
    error object ( Status )

    ব্যর্থতা বা বাতিলকরণের ক্ষেত্রে অপারেশনের ত্রুটির ফলাফল।

    response object

    অপারেশনের স্বাভাবিক, সফল প্রতিক্রিয়া। যদি মূল পদ্ধতিটি সাফল্যের উপর কোনও তথ্য প্রদান না করে, যেমন 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 (Status)
      },
      "response": {
        "@type": string,
        field1: ...,
        ...
      }
      // Union type
    }

    পদ্ধতি: fileSearchStores.upload.operations.get

    দীর্ঘমেয়াদী অপারেশনের সর্বশেষ অবস্থা পায়। ক্লায়েন্টরা API পরিষেবা দ্বারা সুপারিশকৃত বিরতিতে অপারেশন ফলাফল পোল করার জন্য এই পদ্ধতিটি ব্যবহার করতে পারেন।

    শেষবিন্দু

    https পান https: / /generativelanguage.googleapis.com /v1beta /{name=fileSearchStores /* /upload /operations /*}

    পথের পরামিতি

    name string

    অপারেশন রিসোর্সের নাম। এটি fileSearchStores/{filesearchstore}/upload/operations/{operation} রূপ নেয়।

    অনুরোধের মূল অংশ

    অনুরোধের মূল অংশটি অবশ্যই খালি থাকতে হবে।

    প্রতিক্রিয়া মূল অংশ

    যদি সফল হয়, তাহলে রেসপন্স বডিতে Operation এর একটি উদাহরণ থাকবে।

    REST রিসোর্স: ফাইল সার্চস্টোরস

    রিসোর্স: ফাইলসার্চস্টোর

    একটি FileSearchStore হল Document একটি সংগ্রহ।

    ক্ষেত্র
    name string

    শুধুমাত্র আউটপুট। অপরিবর্তনীয়। শনাক্তকারী। FileSearchStore রিসোর্স নাম। এটি একটি আইডি ("fileSearchStores/" উপসর্গ বাদে নাম) যাতে ৪০টি পর্যন্ত অক্ষর থাকতে পারে যা ছোট হাতের বর্ণমালা বা ড্যাশ (-)। এটি শুধুমাত্র আউটপুট। অনন্য নামটি displayName থেকে নেওয়া হবে এবং এর সাথে একটি ১২ অক্ষরের র‍্যান্ডম প্রত্যয় থাকবে। উদাহরণ: fileSearchStores/my-awesome-file-search-store-123a456b789c যদি displayName প্রদান না করা হয়, তাহলে নামটি এলোমেলোভাবে তৈরি হবে।

    displayName string

    ঐচ্ছিক। FileSearchStore এর জন্য মানুষের পঠনযোগ্য প্রদর্শন নাম। প্রদর্শন নামটি অবশ্যই ৫১২ অক্ষরের বেশি দৈর্ঘ্যের হতে হবে না, স্পেস সহ। উদাহরণ: "Docs on Semantic Retriever"

    createTime string ( 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" .

    updateTime string ( 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" .

    activeDocumentsCount string ( int64 format)

    শুধুমাত্র আউটপুট। FileSearchStore এ সক্রিয় এবং পুনরুদ্ধারের জন্য প্রস্তুত নথির সংখ্যা।

    pendingDocumentsCount string ( int64 format)

    শুধুমাত্র আউটপুট। FileSearchStore প্রক্রিয়াজাত নথির সংখ্যা।

    failedDocumentsCount string ( int64 format)

    শুধুমাত্র আউটপুট। FileSearchStore প্রক্রিয়াকরণে ব্যর্থ নথির সংখ্যা।

    sizeBytes string ( int64 format)

    শুধুমাত্র আউটপুট। FileSearchStore এ প্রবেশ করা raw বাইটের আকার। এটি FileSearchStore এর সমস্ত ডকুমেন্টের মোট আকার।

    JSON উপস্থাপনা
    {
      "name": string,
      "displayName": string,
      "createTime": string,
      "updateTime": string,
      "activeDocumentsCount": string,
      "pendingDocumentsCount": string,
      "failedDocumentsCount": string,
      "sizeBytes": string
    }