Method: indexing.datasources.items.push

পরবর্তী পোলিং এবং আপডেট করার জন্য একটি আইটেমকে একটি সারিতে ঠেলে দেয়।

এই API কার্যকর করার জন্য একটি প্রশাসক বা পরিষেবা অ্যাকাউন্ট প্রয়োজন৷ ব্যবহৃত পরিষেবা অ্যাকাউন্টটি সংশ্লিষ্ট ডেটা উৎসে সাদা তালিকাভুক্ত।

HTTP অনুরোধ

POST https://cloudsearch.googleapis.com/v1/indexing/{item.name=datasources/*/items/*}:push

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
item.name

string

ইনডেক্সিং সারিতে পুশ করার জন্য item নাম।

ফর্ম্যাট: ডেটাসোর্স/{sourceId}/items/{ID}

এটি একটি প্রয়োজনীয় ক্ষেত্র। সর্বাধিক দৈর্ঘ্য 1536 অক্ষর।

শরীরের অনুরোধ

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

JSON প্রতিনিধিত্ব
{
  "item": {
    "name": string,
    "type": enum (PushItem.Type),
    "metadataHash": string,
    "structuredDataHash": string,
    "contentHash": string,
    "payload": string,
    "queue": string,
    "repositoryError": {
      "type": enum (RepositoryError.Type),
      "httpStatusCode": integer,
      "errorMessage": string
    }
  },
  "connectorName": string,
  "debugOptions": {
    object (DebugOptions)
  }
}
ক্ষেত্র
item.type

enum ( PushItem.Type )

পুশ অপারেশনের ধরন যা পুশ আচরণকে সংজ্ঞায়িত করে।

item.metadataHash

string

রিপোজিটরি অনুযায়ী আইটেমের মেটাডেটা হ্যাশ। যদি নির্দিষ্ট করা থাকে, তাহলে এই আইটেমটির স্থিতি কীভাবে পরিবর্তন করা যায় তা নির্ধারণ করতে এটি ব্যবহার করা হয়। এই ক্ষেত্র এবং type ফিল্ড সেট করার ফলে আর্গুমেন্ট ত্রুটি দেখা দেয়। সর্বাধিক দৈর্ঘ্য 2048 অক্ষর।

item.structuredDataHash

string

রিপোজিটরি অনুযায়ী আইটেমের স্ট্রাকচার্ড ডাটা হ্যাশ। যদি নির্দিষ্ট করা থাকে, তাহলে এই আইটেমটির স্থিতি কীভাবে পরিবর্তন করা যায় তা নির্ধারণ করতে এটি ব্যবহার করা হয়। এই ক্ষেত্র এবং type ফিল্ড সেট করার ফলে আর্গুমেন্ট ত্রুটি দেখা দেয়। সর্বাধিক দৈর্ঘ্য 2048 অক্ষর।

item.contentHash

string

রিপোজিটরি অনুযায়ী আইটেমের কন্টেন্ট হ্যাশ। যদি নির্দিষ্ট করা থাকে, তাহলে এই আইটেমটির স্থিতি কীভাবে পরিবর্তন করা যায় তা নির্ধারণ করতে এটি ব্যবহার করা হয়। এই ক্ষেত্র এবং type ফিল্ড সেট করার ফলে আর্গুমেন্ট ত্রুটি দেখা দেয়। সর্বাধিক দৈর্ঘ্য 2048 অক্ষর।

item.payload

string ( bytes format)

সংযোগকারীর জন্য অতিরিক্ত নথির অবস্থার তথ্য প্রদান করে, যেমন একটি বিকল্প সংগ্রহস্থল আইডি এবং অন্যান্য মেটাডেটা। সর্বাধিক দৈর্ঘ্য 8192 বাইট।

একটি base64-এনকোডেড স্ট্রিং।

item.queue

string

এই আইটেমটি যার সারি। এই ক্ষেত্রটি নির্দিষ্ট না থাকলে default সারি বেছে নেওয়া হয়। সর্বাধিক দৈর্ঘ্য 512 অক্ষর।

item.repositoryError

object ( RepositoryError )

সংযোগকারী বা সংগ্রহস্থল ত্রুটির বিবরণ সংরক্ষণ করতে এই ক্ষেত্রটি পূরণ করুন৷ এই তথ্য অ্যাডমিন কনসোলে প্রদর্শিত হয়। REPOSITORY_ERROR type হলেই এই ক্ষেত্রটি পপুলেট হতে পারে।

connectorName

string

এই কল করার সংযোগকারীর নাম।

বিন্যাস: datasources/{sourceId}/connectors/{ID}

debugOptions

object ( DebugOptions )

সাধারণ ডিবাগ বিকল্প।

প্রতিক্রিয়া শরীর

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

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/cloud_search.indexing
  • https://www.googleapis.com/auth/cloud_search

আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।

পুশ আইটেম

ইনডেক্সিং সারিতে ঠেলে দেওয়ার জন্য একটি আইটেম উপস্থাপন করে।

JSON প্রতিনিধিত্ব
{
  "name": string,
  "type": enum (PushItem.Type),
  "metadataHash": string,
  "structuredDataHash": string,
  "contentHash": string,
  "payload": string,
  "queue": string,
  "repositoryError": {
    object (RepositoryError)
  }
}
ক্ষেত্র
name

string

ইনডেক্সিং সারিতে পুশ করার জন্য item নাম।

ফর্ম্যাট: ডেটাসোর্স/{sourceId}/items/{ID}

এটি একটি প্রয়োজনীয় ক্ষেত্র। সর্বাধিক দৈর্ঘ্য 1536 অক্ষর।

type

enum ( PushItem.Type )

পুশ অপারেশনের ধরন যা পুশ আচরণকে সংজ্ঞায়িত করে।

metadataHash

string

রিপোজিটরি অনুযায়ী আইটেমের মেটাডেটা হ্যাশ। যদি নির্দিষ্ট করা থাকে, তাহলে এই আইটেমটির স্থিতি কীভাবে পরিবর্তন করা যায় তা নির্ধারণ করতে এটি ব্যবহার করা হয়। এই ক্ষেত্র এবং type ফিল্ড সেট করার ফলে আর্গুমেন্ট ত্রুটি দেখা দেয়। সর্বাধিক দৈর্ঘ্য 2048 অক্ষর।

structuredDataHash

string

রিপোজিটরি অনুযায়ী আইটেমের স্ট্রাকচার্ড ডাটা হ্যাশ। যদি নির্দিষ্ট করা থাকে, তাহলে এই আইটেমটির স্থিতি কীভাবে পরিবর্তন করা যায় তা নির্ধারণ করতে এটি ব্যবহার করা হয়। এই ক্ষেত্র এবং type ফিল্ড সেট করার ফলে আর্গুমেন্ট ত্রুটি দেখা দেয়। সর্বাধিক দৈর্ঘ্য 2048 অক্ষর।

contentHash

string

রিপোজিটরি অনুযায়ী আইটেমের কন্টেন্ট হ্যাশ। যদি নির্দিষ্ট করা থাকে, তাহলে এই আইটেমটির স্থিতি কীভাবে পরিবর্তন করা যায় তা নির্ধারণ করতে এটি ব্যবহার করা হয়। এই ক্ষেত্র এবং type ফিল্ড সেট করার ফলে আর্গুমেন্ট ত্রুটি দেখা দেয়। সর্বাধিক দৈর্ঘ্য 2048 অক্ষর।

payload

string ( bytes format)

সংযোগকারীর জন্য অতিরিক্ত নথির অবস্থার তথ্য প্রদান করে, যেমন একটি বিকল্প সংগ্রহস্থল আইডি এবং অন্যান্য মেটাডেটা। সর্বাধিক দৈর্ঘ্য 8192 বাইট।

একটি base64-এনকোডেড স্ট্রিং।

queue

string

এই আইটেমটি যার সারি। এই ক্ষেত্রটি নির্দিষ্ট না থাকলে default সারি বেছে নেওয়া হয়। সর্বাধিক দৈর্ঘ্য 512 অক্ষর।

repositoryError

object ( RepositoryError )

সংযোগকারী বা সংগ্রহস্থল ত্রুটির বিবরণ সংরক্ষণ করতে এই ক্ষেত্রটি পূরণ করুন৷ এই তথ্য অ্যাডমিন কনসোলে প্রদর্শিত হয়। REPOSITORY_ERROR type হলেই এই ক্ষেত্রটি পপুলেট হতে পারে।

PushItem.Type

পুশ অপারেশনের ধরন যা পুশ আচরণকে সংজ্ঞায়িত করে।

এনামস
UNSPECIFIED ডিফল্ট অনির্দিষ্ট. সুনির্দিষ্ট করে যে পুশ অপারেশন ItemStatus পরিবর্তন করবে না
MODIFIED ইঙ্গিত করে যে পূর্ববর্তী update কল থেকে সংগ্রহস্থল নথিটি সংশোধন বা আপডেট করা হয়েছে। এটি একটি বিদ্যমান আইটেমের জন্য স্থিতি পরিবর্তন করে MODIFIED অবস্থায়। যদি এটি একটি অ বিদ্যমান আইটেমে কল করা হয়, তাহলে স্থিতি NEW_ITEM এ পরিবর্তিত হয়।
NOT_MODIFIED শেষ আপডেট কলের পর থেকে সংগ্রহস্থলের আইটেমটি পরিবর্তন করা হয়নি। এই পুশ অপারেশন ACCEPTED অবস্থায় স্থিতি সেট করবে।
REPOSITORY_ERROR সংযোগকারী এই আইটেম সম্পর্কিত একটি সংগ্রহস্থল ত্রুটি সম্মুখীন হয়েছে. REPOSITORY_ERROR অবস্থায় স্থিতি পরিবর্তন করুন। সূচকীয় ব্যাকঅফ দ্বারা নির্ধারিত ভবিষ্যতের সময়ে আইটেম অসংরক্ষিত এবং পুনঃনির্ধারিত।
REQUEUE শুধুমাত্র সংরক্ষিত আইটেমগুলির জন্য REQUEUE দিয়ে কল পুশ করুন৷ এই ক্রিয়াটি আইটেমটিকে অসংরক্ষিত করে এবং প্রাচীর ঘড়ির সময়ে এর উপলব্ধ সময় পুনরায় সেট করে।