প্রোগ্রামেবল অনুসন্ধান উপাদান নিয়ন্ত্রণ API

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

সমস্ত জাভাস্ক্রিপ্ট অ্যাসিঙ্ক্রোনাসভাবে লোড করা হয়, যা ব্রাউজার প্রোগ্রামেবল সার্চ ইঞ্জিন জাভাস্ক্রিপ্ট আনার সময় আপনার ওয়েবপৃষ্ঠাটিকে লোড করা চালিয়ে যেতে দেয়।

ভূমিকা

এই নথিটি আপনার ওয়েব পৃষ্ঠায় প্রোগ্রামেবল সার্চ ইঞ্জিন উপাদান যোগ করার জন্য একটি মৌলিক মডেল প্রদান করে, সাথে উপাদানটির কনফিগারযোগ্য উপাদান এবং নমনীয় জাভাস্ক্রিপ্ট এপিআইয়ের ব্যাখ্যা।

ব্যাপ্তি

এই নথিটি বর্ণনা করে কিভাবে প্রোগ্রামেবল সার্চ ইঞ্জিন কন্ট্রোল API-এর জন্য নির্দিষ্ট ফাংশন এবং বৈশিষ্ট্যগুলি ব্যবহার করতে হয়৷

ব্রাউজার সামঞ্জস্য

প্রোগ্রামেবল সার্চ ইঞ্জিন দ্বারা সমর্থিত ব্রাউজারগুলির তালিকা এখানে পাওয়া যাবে।

শ্রোতা

এই ডকুমেন্টেশনটি তাদের পৃষ্ঠাগুলিতে Google প্রোগ্রামেবল অনুসন্ধান কার্যকারিতা যুক্ত করতে চান এমন ডেভেলপারদের জন্য উদ্দিষ্ট৷

প্রোগ্রামেবল অনুসন্ধান উপাদান

আপনি আপনার পৃষ্ঠায় একটি প্রোগ্রামযোগ্য অনুসন্ধান উপাদান যোগ করতে HTML মার্কআপ ব্যবহার করতে পারেন। প্রতিটি উপাদান অন্তত একটি উপাদান নিয়ে গঠিত: একটি অনুসন্ধান বাক্স, অনুসন্ধান ফলাফলের একটি ব্লক, বা উভয়। অনুসন্ধান বাক্স নিম্নলিখিত উপায়ে ব্যবহারকারীর ইনপুট গ্রহণ করে:

  • টেক্সট ইনপুট ক্ষেত্রে টাইপ করা একটি অনুসন্ধান ক্যোয়ারী
  • একটি URL এ এমবেড করা একটি ক্যোয়ারী স্ট্রিং৷
  • প্রোগ্রাম্যাটিক এক্সিকিউশন

উপরন্তু, অনুসন্ধান ফলাফলের ব্লক নিম্নলিখিত উপায়ে ইনপুট গ্রহণ করে:

  • একটি URL এ এমবেড করা একটি ক্যোয়ারী স্ট্রিং৷
  • প্রোগ্রাম্যাটিক এক্সিকিউশন

নিম্নলিখিত ধরনের প্রোগ্রামেবল অনুসন্ধান উপাদান উপলব্ধ:

উপাদান প্রকার উপাদান(গুলি) বর্ণনা
মান <div class="gcse-search"> একটি অনুসন্ধান বাক্স এবং অনুসন্ধান ফলাফল, একই <div> এ প্রদর্শিত হয়।
দুই কলাম <div class="gcse-searchbox"> এবং <div class="gcse-searchresults"> একদিকে অনুসন্ধান ফলাফল সহ একটি দুই-কলাম বিন্যাস এবং অন্য দিকে একটি অনুসন্ধান বাক্স৷ আপনি যদি আপনার ওয়েবপৃষ্ঠায় দুই-কলাম মোডে একাধিক উপাদান সন্নিবেশ করার পরিকল্পনা করেন, আপনি অনুসন্ধান ফলাফলের ব্লকের সাথে একটি অনুসন্ধান বাক্স যুক্ত করতে gname বৈশিষ্ট্য ব্যবহার করতে পারেন।
সার্চবক্স শুধুমাত্র <div class="gcse-searchbox-only"> একটি স্বতন্ত্র অনুসন্ধান বাক্স।
শুধুমাত্র অনুসন্ধানের ফলাফল <div class="gcse-searchresults-only"> অনুসন্ধান ফলাফলের একটি স্বতন্ত্র ব্লক।

আপনি আপনার ওয়েবপৃষ্ঠায় বৈধ অনুসন্ধান উপাদানগুলির যেকোনো সংখ্যা যোগ করতে পারেন। দুই-কলাম মোডের জন্য, সমস্ত প্রয়োজনীয় উপাদান (একটি অনুসন্ধান বাক্স এবং অনুসন্ধান ফলাফল ব্লক) উপস্থিত থাকতে হবে।

এখানে একটি সাধারণ অনুসন্ধান উপাদানের একটি উদাহরণ রয়েছে:

<!-- Put the following javascript before the closing </head> tag
and replace 123456 with your own Programmable Search Engine ID. -->
<script async src="https://cse.google.com/cse.js?cx=123456"></script>

<!-- Place this tag where you want both of the search box and the search results to render -->
<div class="gcse-search"></div>

প্রোগ্রামেবল অনুসন্ধান উপাদান ব্যবহার করে বিভিন্ন লেআউট বিকল্প রচনা করুন

নিম্নলিখিত লেআউট বিকল্পগুলি প্রোগ্রামেবল সার্চ ইঞ্জিন কন্ট্রোল প্যানেলের লুক অ্যান্ড ফিল পৃষ্ঠায় উপলব্ধ। প্রোগ্রামেবল অনুসন্ধান উপাদান ব্যবহার করে লেআউট বিকল্পগুলি রচনা করার বিষয়ে এখানে কিছু সাধারণ নির্দেশিকা রয়েছে। এই বিকল্পগুলির যে কোনও একটি ডেমো দেখতে, লিঙ্কটিতে ক্লিক করুন।

অপশন উপাদান(গুলি)
পুরো প্রস্থ <div class="gcse-search">
কমপ্যাক্ট <div class="gcse-search">
দুই-কলাম <div class="gcse-searchbox"> , <div class="gcse-searchresults">
দুই পাতা প্রথম পৃষ্ঠায় <div class="gcse-searchbox-only"> , দ্বিতীয় পৃষ্ঠায় <div class="gcse-searchresults-only"> (বা অন্যান্য উপাদান)।
শুধুমাত্র ফলাফল <div class="gcse-searchresults-only">
Google-হোস্টেড <div class="gcse-searchbox-only">

লেআউট বিকল্প সম্পর্কে আরও তথ্য।

প্রোগ্রামেবল অনুসন্ধান উপাদান কাস্টমাইজ করা

রঙ, ফন্ট বা লিঙ্ক শৈলী কাস্টমাইজ করতে, আপনার প্রোগ্রামেবল সার্চ ইঞ্জিনের চেহারা এবং অনুভূতি পৃষ্ঠাতে যান।

আপনি প্রোগ্রামেবল সার্চ ইঞ্জিন কন্ট্রোল প্যানেলে তৈরি কনফিগারেশন ওভাররাইট করতে ঐচ্ছিক বৈশিষ্ট্য ব্যবহার করতে পারেন। এটি আপনাকে একটি পৃষ্ঠা-নির্দিষ্ট অনুসন্ধান অভিজ্ঞতা তৈরি করতে সক্ষম করে। উদাহরণস্বরূপ, নিম্নলিখিত কোডটি একটি অনুসন্ধান বাক্স তৈরি করে যা একটি নতুন উইন্ডোতে একটি ফলাফল পৃষ্ঠা (http://www.example.com?search=lady+gaga) খোলে। ব্যবহারকারীর ক্যোয়ারী স্ট্রিং সহ queryParameterName অ্যাট্রিবিউটের মান ফলাফলের URL তৈরি করতে ব্যবহৃত হয়।

মনে রাখবেন যে queryParameterName অ্যাট্রিবিউটটি data- এর সাথে উপসর্গযুক্ত। এই উপসর্গ সমস্ত বৈশিষ্ট্যের জন্য প্রয়োজন.

<div class="gcse-searchbox-only" data-resultsUrl="http://www.example.com" data-newWindow="true" data-queryParameterName="search">

আপনি যদি স্বয়ংসম্পূর্ণ বা পরিমার্জনার মতো বৈশিষ্ট্যগুলি সক্ষম করতে প্রোগ্রামেবল সার্চ ইঞ্জিন নিয়ন্ত্রণ প্যানেল ব্যবহার করে থাকেন তবে আপনি সেই বৈশিষ্ট্যগুলি কাস্টমাইজ করতে বৈশিষ্ট্যগুলি ব্যবহার করতে পারেন৷ এই বৈশিষ্ট্যগুলি ব্যবহার করে আপনি যে কোনও কাস্টমাইজেশন নির্দিষ্ট করেছেন তা নিয়ন্ত্রণ প্যানেলে তৈরি সেটিংসকে ওভাররাইড করবে৷ নিম্নলিখিত উদাহরণটি নিম্নলিখিত বৈশিষ্ট্যগুলির সাথে একটি দুই-কলাম অনুসন্ধান উপাদান তৈরি করে:

  • ইতিহাস ব্যবস্থাপনা সক্ষম করা হয়েছে
  • প্রদর্শিত স্বয়ংসম্পূর্ণতার সর্বাধিক সংখ্যা 5 এ সেট করা হয়েছে৷
  • পরিশোধন লিঙ্ক হিসাবে প্রদর্শিত হয়.

<div class="gcse-searchbox" data-enableHistory="true" data-autoCompleteMaxCompletions="5">
<div class="gcse-searchresults" data-refinementStyle="link">

সমর্থিত বৈশিষ্ট্য

বৈশিষ্ট্য টাইপ বর্ণনা উপাদান
সাধারণ
gname স্ট্রিং (ঐচ্ছিক) অনুসন্ধান উপাদান বস্তুর একটি নাম। একটি নাম নাম দ্বারা একটি সম্পর্কিত উপাদান পুনরুদ্ধার করতে বা searchresults উপাদানের সাথে একটি searchbox উপাদান যুক্ত করতে ব্যবহৃত হয়। যদি সরবরাহ না করা হয়, প্রোগ্রামেবল সার্চ ইঞ্জিন স্বয়ংক্রিয়ভাবে ওয়েবপৃষ্ঠার উপাদানগুলির ক্রম অনুসারে একটি gname তৈরি করবে। উদাহরণ স্বরূপ, প্রথম নামবিহীন searchbox-only অনলির gname আছে "searchbox-only0" এবং দ্বিতীয়টির gname আছে "seachbox-only1", ইত্যাদি। মনে রাখবেন যে দুই-কলাম বিন্যাসে একটি উপাদানের জন্য স্বয়ংক্রিয়ভাবে উৎপন্ন gname হবে two-column । নিচের উদাহরণটি একটি searchbox কম্পোনেন্টকে searchresults কম্পোনেন্টের সাথে লিঙ্ক করতে gname storesearch ব্যবহার করে: 
<div class="gcse-searchbox" data-gname="storesearch"></div>
<div class="gcse-searchresults" data-gname="storesearch"></div>

একটি বস্তু পুনরুদ্ধার করার সময়, যদি একাধিক উপাদানের একই gname থাকে, প্রোগ্রামেবল সার্চ ইঞ্জিন পৃষ্ঠার শেষ উপাদানটি ব্যবহার করবে।

 যে কোন
autoSearchOnLoad বুলিয়ান লোড হচ্ছে এমন পৃষ্ঠার URL-এ এমবেড করা কোয়েরি দ্বারা একটি অনুসন্ধান চালানো হবে কিনা তা নির্দিষ্ট করে৷ মনে রাখবেন যে স্বয়ংক্রিয় অনুসন্ধান চালানোর জন্য একটি ক্যোয়ারী স্ট্রিং URL-এ উপস্থিত থাকতে হবে। ডিফল্ট: true । যে কোন
enableHistory বুলিয়ান true হলে, ব্রাউজারের পিছনে এবং ফরোয়ার্ড বোতামগুলির জন্য ইতিহাস পরিচালনা সক্ষম করে। একটি ডেমো দেখুন.

অনুসন্ধান বাক্স

সার্চবক্স শুধুমাত্র

queryParameterName স্ট্রিং ক্যোয়ারী প্যারামিটার নাম—উদাহরণস্বরূপ, q (ডিফল্ট) বা query । এটি URL এ এম্বেড করা হবে (উদাহরণস্বরূপ, http://www.example.com?q=lady+gaga)। মনে রাখবেন যে শুধুমাত্র ক্যোয়ারী প্যারামিটারের নাম নির্দিষ্ট করা লোডের উপর স্বয়ংক্রিয় অনুসন্ধান ট্রিগার করে না। স্বয়ংক্রিয় অনুসন্ধান চালানোর জন্য URL-এ একটি ক্যোয়ারী স্ট্রিং উপস্থিত থাকতে হবে। যে কোন
resultsUrl URL ফলাফল পৃষ্ঠার URL. (ডিফল্ট হল Google-হোস্ট করা পৃষ্ঠা।) সার্চবক্স শুধুমাত্র
newWindow বুলিয়ান ফলাফল পৃষ্ঠাটি একটি নতুন উইন্ডোতে খোলে কিনা তা নির্দিষ্ট করে। ডিফল্ট: false । সার্চবক্স শুধুমাত্র
ivt বুলিয়ান

এই প্যারামিটারটি আপনাকে একটি বুলিয়ান সরবরাহ করতে দেয় যা Google-কে জানায় যে আপনি সম্মত এবং অসম্মত ট্রাফিক উভয় ক্ষেত্রেই অবৈধ ট্রাফিক-শুধু কুকি এবং স্থানীয় স্টোরেজ ব্যবহার করে এমন বিজ্ঞাপনগুলিকে অনুমতি দিতে চান।

true যখন এই প্যারামিটারটি উপস্থিত না থাকে বা আপনি এটিকে "true" তে সেট করেন, তখন আমরা একটি অবৈধ ট্রাফিক-শুধু কুকি সেট করব এবং শুধুমাত্র সম্মত ট্রাফিকের জন্য স্থানীয় স্টোরেজ ব্যবহার করব।

false আপনি এই প্যারামিটারটিকে "false" এ সেট করলে আমরা একটি অবৈধ ট্রাফিক-শুধু কুকি সেট করব এবং সম্মতি এবং অসম্মতিহীন উভয় ট্র্যাফিকের স্থানীয় স্টোরেজ ব্যবহার করব।

ডিফল্ট: false

নমুনা ব্যবহার: <div class="gcse-search" data-ivt="true"></div>

অনুসন্ধান ফলাফল

শুধুমাত্র অনুসন্ধানের ফলাফল

mobileLayout স্ট্রিং

মোবাইল ডিভাইসের জন্য মোবাইল লেআউট শৈলী ব্যবহার করা উচিত কিনা তা নির্দিষ্ট করে৷

enabled শুধুমাত্র মোবাইল ডিভাইসের জন্য মোবাইল লেআউট ব্যবহার করে।

disabled কোনো ডিভাইসের জন্য মোবাইল লেআউট ব্যবহার করে না।

forced সব ডিভাইসের জন্য মোবাইল লেআউট ব্যবহার করে।

ডিফল্ট: enabled

নমুনা ব্যবহার: <div class="gcse-search" data-mobileLayout="disabled"></div>

 যে কোন
স্বয়ংসম্পূর্ণ
enableAutoComplete বুলিয়ান শুধুমাত্র প্রোগ্রামেবল সার্চ ইঞ্জিন কন্ট্রোল প্যানেলে স্বয়ংসম্পূর্ণ সক্রিয় করা থাকলেই উপলব্ধ। true স্বয়ংসম্পূর্ণ সক্ষম করে। যে কোন
autoCompleteMaxCompletions পূর্ণসংখ্যা প্রদর্শনের জন্য স্বয়ংসম্পূর্ণতার সর্বাধিক সংখ্যা৷

অনুসন্ধান বাক্স

সার্চবক্স শুধুমাত্র

autoCompleteMaxPromotions পূর্ণসংখ্যা স্বয়ংসম্পূর্ণভাবে প্রদর্শনের জন্য সর্বাধিক সংখ্যক প্রচার।

অনুসন্ধান বাক্স

সার্চবক্স শুধুমাত্র

autoCompleteValidLanguages স্ট্রিং কমা দ্বারা পৃথক করা ভাষার তালিকা যার জন্য স্বয়ংসম্পূর্ণ সক্ষম করা উচিত। সমর্থিত ভাষা।

অনুসন্ধান বাক্স

সার্চবক্স শুধুমাত্র

পরিমার্জন
defaultToRefinement স্ট্রিং প্রোগ্রামেবল সার্চ ইঞ্জিন কন্ট্রোল প্যানেলে পরিমার্জন তৈরি করা হলেই উপলব্ধ। প্রদর্শনের জন্য ডিফল্ট পরিশোধন লেবেল নির্দিষ্ট করে৷ দ্রষ্টব্য: এই বৈশিষ্ট্যটি Google হোস্টেড লেআউটের জন্য সমর্থিত নয়৷ যে কোন
refinementStyle স্ট্রিং গ্রহণযোগ্য মান হল tab (ডিফল্ট) এবং link । link শুধুমাত্র তখনই সমর্থিত হয় যদি ইমেজ সার্চ নিষ্ক্রিয় থাকে, অথবা যদি ইমেজ সার্চ সক্রিয় থাকে কিন্তু ওয়েব সার্চ নিষ্ক্রিয় থাকে।

অনুসন্ধান ফলাফল

শুধুমাত্র অনুসন্ধানের ফলাফল

চিত্র অনুসন্ধান
enableImageSearch বুলিয়ান প্রোগ্রামেবল সার্চ ইঞ্জিন কন্ট্রোল প্যানেলে ইমেজ সার্চ সক্রিয় করা থাকলেই উপলভ্য।

true হলে, ছবি অনুসন্ধান সক্ষম করে। ছবির ফলাফল একটি পৃথক ট্যাবে দেখানো হবে।

অনুসন্ধান ফলাফল

শুধুমাত্র অনুসন্ধানের ফলাফল

defaultToImageSearch বুলিয়ান প্রোগ্রামেবল সার্চ ইঞ্জিন কন্ট্রোল প্যানেলে ইমেজ সার্চ সক্রিয় করা থাকলেই উপলভ্য।

true হলে, অনুসন্ধান ফলাফল পৃষ্ঠা ডিফল্টরূপে চিত্র অনুসন্ধান ফলাফল প্রদর্শন করবে। ওয়েব ফলাফল একটি পৃথক ট্যাবে উপলব্ধ হবে.

 যে কোন
imageSearchLayout স্ট্রিং প্রোগ্রামেবল সার্চ ইঞ্জিন কন্ট্রোল প্যানেলে ইমেজ সার্চ সক্রিয় করা থাকলেই উপলভ্য।

চিত্র অনুসন্ধান ফলাফল পৃষ্ঠার বিন্যাস নির্দিষ্ট করে। গ্রহণযোগ্য মান হল classic , column বা popup ।

অনুসন্ধান ফলাফল

শুধুমাত্র অনুসন্ধানের ফলাফল

imageSearchResultSetSize পূর্ণসংখ্যা, স্ট্রিং প্রোগ্রামেবল সার্চ ইঞ্জিন কন্ট্রোল প্যানেলে ইমেজ সার্চ সক্রিয় করা থাকলেই উপলভ্য।

চিত্র অনুসন্ধানের জন্য সেট করা অনুসন্ধান ফলাফলের সর্বাধিক আকার নির্দিষ্ট করে৷ উদাহরণস্বরূপ, large , small , filtered_cse , 10 ।

 যে কোন
image_as_filetype স্ট্রিং প্রোগ্রামেবল সার্চ ইঞ্জিন কন্ট্রোল প্যানেলে ইমেজ সার্চ সক্রিয় করা থাকলেই উপলভ্য।

একটি নির্দিষ্ট এক্সটেনশনের ফাইলগুলিতে ফলাফল সীমাবদ্ধ করে।

সমর্থিত এক্সটেনশনগুলি হল jpg , gif , png , bmp , svg , webp , ico , raw ।

যে কোন

image_as_oq স্ট্রিং প্রোগ্রামেবল সার্চ ইঞ্জিন কন্ট্রোল প্যানেলে ইমেজ সার্চ সক্রিয় করা থাকলেই উপলভ্য।

লজিক্যাল OR ব্যবহার করে অনুসন্ধান ফলাফল ফিল্টার করুন।

আপনি যদি "term1" বা "term2" হয় এমন অনুসন্ধানের ফলাফল চান তাহলে নমুনা ব্যবহার করুন: <div class="gcse-search" data-image_as_oq="term1 term2"></div>

যে কোন

image_as_rights স্ট্রিং প্রোগ্রামেবল সার্চ ইঞ্জিন কন্ট্রোল প্যানেলে ইমেজ সার্চ সক্রিয় করা থাকলেই উপলভ্য।

লাইসেন্সিং উপর ভিত্তি করে ফিল্টার.

সমর্থিত মানগুলি হল cc_publicdomain , cc_attribute , cc_sharealike , cc_noncommercial , cc_nonderived , এবং এইগুলির সংমিশ্রণ৷

সাধারণ সমন্বয় দেখুন।

যে কোন

image_as_sitesearch স্ট্রিং প্রোগ্রামেবল সার্চ ইঞ্জিন কন্ট্রোল প্যানেলে ইমেজ সার্চ সক্রিয় করা থাকলেই উপলভ্য।

একটি নির্দিষ্ট সাইটের পৃষ্ঠাগুলিতে ফলাফল সীমাবদ্ধ করুন।

নমুনা ব্যবহার: <div class="gcse-search" data-image_as_sitesearch="example.com"></div>

যে কোন

image_colortype স্ট্রিং প্রোগ্রামেবল সার্চ ইঞ্জিন কন্ট্রোল প্যানেলে ইমেজ সার্চ সক্রিয় করা থাকলেই উপলভ্য।

কালো এবং সাদা (মনো), গ্রেস্কেল, বা রঙিন চিত্রগুলিতে অনুসন্ধান সীমাবদ্ধ করে৷ সমর্থিত মান হল mono , gray , color ।

যে কোন

image_cr স্ট্রিং প্রোগ্রামেবল সার্চ ইঞ্জিন কন্ট্রোল প্যানেলে ইমেজ সার্চ সক্রিয় করা থাকলেই উপলভ্য।

একটি নির্দিষ্ট দেশে উদ্ভূত নথিতে অনুসন্ধান ফলাফল সীমাবদ্ধ করে।

সমর্থিত মান

যে কোন

image_dominantcolor স্ট্রিং প্রোগ্রামেবল সার্চ ইঞ্জিন কন্ট্রোল প্যানেলে ইমেজ সার্চ সক্রিয় করা থাকলেই উপলভ্য।

একটি নির্দিষ্ট প্রভাবশালী রঙের চিত্রগুলিতে অনুসন্ধান সীমাবদ্ধ করে৷ সমর্থিত মানগুলি হল red , orange , yellow , green , teal , blue , purple , pink , white , gray , black , brown ।

যে কোন

image_filter স্ট্রিং প্রোগ্রামেবল সার্চ ইঞ্জিন কন্ট্রোল প্যানেলে ইমেজ সার্চ সক্রিয় করা থাকলেই উপলভ্য।

অনুসন্ধান ফলাফল স্বয়ংক্রিয় ফিল্টারিং .

সমর্থিত মান: 0/1

নমুনা ব্যবহার: <div class="gcse-search" data-image_filter="0"></div>

যে কোন

image_gl স্ট্রিং প্রোগ্রামেবল সার্চ ইঞ্জিন কন্ট্রোল প্যানেলে ইমেজ সার্চ সক্রিয় করা থাকলেই উপলভ্য। সার্চ ফলাফল বুস্ট করুন যার উৎপত্তি দেশ প্যারামিটার মানের সাথে মেলে।

সমর্থিত মান

যে কোন

image_size স্ট্রিং প্রোগ্রামেবল সার্চ ইঞ্জিন কন্ট্রোল প্যানেলে ইমেজ সার্চ সক্রিয় করা থাকলেই উপলভ্য।

একটি নির্দিষ্ট আকারের ছবি দেখায়, যেখানে আকার হতে পারে এর মধ্যে একটি: icon , small , medium , large , xlarge , xxlarge , বা huge.

যে কোন

image_sort_by স্ট্রিং প্রোগ্রামেবল সার্চ ইঞ্জিন কন্ট্রোল প্যানেলে ইমেজ সার্চ সক্রিয় করা থাকলেই উপলভ্য।

তারিখ বা অন্যান্য কাঠামোগত বিষয়বস্তু ব্যবহার করে ফলাফল সাজান।

প্রাসঙ্গিকতা অনুসারে সাজানোর জন্য একটি খালি স্ট্রিং ব্যবহার করুন (image_sort_by="")।

নমুনা ব্যবহার: <div class="gcse-search" data-image_sort_by="date"></div>

যে কোন

image_type স্ট্রিং প্রোগ্রামেবল সার্চ ইঞ্জিন কন্ট্রোল প্যানেলে ইমেজ সার্চ সক্রিয় করা থাকলেই উপলভ্য।

একটি নির্দিষ্ট ধরনের ছবি অনুসন্ধান সীমাবদ্ধ. সমর্থিত মানগুলি হল clipart (ক্লিপ আর্ট), face (মানুষের মুখ), lineart (লাইন অঙ্কন), stock (স্টক ফটো), photo (ফটোগ্রাফ), এবং animated (অ্যানিমেটেড জিআইএফ)।

যে কোন

ওয়েব অনুসন্ধান
disableWebSearch বুলিয়ান true হলে, ওয়েব অনুসন্ধান নিষ্ক্রিয় করে। প্রোগ্রামেবল সার্চ ইঞ্জিন কন্ট্রোল প্যানেলে ইমেজ সার্চ সক্রিয় করা থাকলেই সাধারণত ব্যবহার করা হয়।

অনুসন্ধান ফলাফল

শুধুমাত্র অনুসন্ধানের ফলাফল

webSearchQueryAddition স্ট্রিং লজিক্যাল OR ব্যবহার করে অনুসন্ধান ক্যোয়ারীতে অতিরিক্ত পদ যোগ করা হয়েছে।

নমুনা ব্যবহার: <div class="gcse-search" data-webSearchQueryAddition="term1 term2"></div>

 যে কোন
webSearchResultSetSize পূর্ণসংখ্যা, স্ট্রিং ফলাফল সেট সর্বোচ্চ আকার. ছবি অনুসন্ধান এবং ওয়েব অনুসন্ধান উভয় ক্ষেত্রেই প্রযোজ্য। ডিফল্টটি লেআউটের উপর নির্ভর করে এবং প্রোগ্রামেবল সার্চ ইঞ্জিন সমগ্র ওয়েব বা শুধুমাত্র নির্দিষ্ট সাইট অনুসন্ধান করার জন্য কনফিগার করা হয়েছে কিনা। গ্রহণযোগ্য মান অন্তর্ভুক্ত:
  • 1-20 থেকে একটি পূর্ণসংখ্যা
  • small : একটি ছোট ফলাফল সেটের অনুরোধ করে, সাধারণত প্রতি পৃষ্ঠায় 4টি ফলাফল।
  • large : একটি বড় ফলাফল সেটের অনুরোধ করে, সাধারণত প্রতি পৃষ্ঠায় 8টি ফলাফল।
  • filtered_cse : সর্বোচ্চ 10টি পৃষ্ঠা বা 100টি ফলাফলের জন্য প্রতি পৃষ্ঠায় 10টি ফলাফল পর্যন্ত অনুরোধ করা হয়।
 যে কোন
webSearchSafesearch স্ট্রিং ওয়েব সার্চ ফলাফলের জন্য নিরাপদ অনুসন্ধান সক্ষম কিনা তা নির্দিষ্ট করে৷ স্বীকৃত মানগুলি off এবং active । যে কোন
as_filetype স্ট্রিং একটি নির্দিষ্ট এক্সটেনশনের ফাইলগুলিতে ফলাফল সীমাবদ্ধ করে। অনুসন্ধান কনসোল সহায়তা কেন্দ্রে Google দ্বারা সূচীযোগ্য ফাইল প্রকারের একটি তালিকা পাওয়া যাবে।

যে কোন

as_oq স্ট্রিং লজিক্যাল OR ব্যবহার করে অনুসন্ধান ফলাফল ফিল্টার করুন।

আপনি যদি "term1" বা "term2" হয় এমন অনুসন্ধানের ফলাফল চান তাহলে নমুনা ব্যবহার করুন: <div class="gcse-search" data-as_oq="term1 term2"></div>

 যে কোন
as_rights স্ট্রিং লাইসেন্সিং উপর ভিত্তি করে ফিল্টার.

সমর্থিত মানগুলি হল cc_publicdomain , cc_attribute , cc_sharealike , cc_noncommercial , cc_nonderived , এবং এইগুলির সংমিশ্রণ৷

সাধারণ সমন্বয়ের জন্য https://wiki.creativecommons.org/wiki/CC_Search_integration দেখুন।

যে কোন

as_sitesearch স্ট্রিং একটি নির্দিষ্ট সাইটের পৃষ্ঠাগুলিতে ফলাফল সীমাবদ্ধ করুন।

নমুনা ব্যবহার: <div class="gcse-search" data-as_sitesearch="example.com"></div>

 যে কোন
cr স্ট্রিং একটি নির্দিষ্ট দেশে উদ্ভূত নথিতে অনুসন্ধান ফলাফল সীমাবদ্ধ করে।

সমর্থিত মান

নমুনা ব্যবহার: <div class="gcse-search" data-cr="countryFR"></div>

 যে কোন
filter স্ট্রিং অনুসন্ধান ফলাফল স্বয়ংক্রিয় ফিল্টারিং .

সমর্থিত মান: 0/1

নমুনা ব্যবহার: <div class="gcse-search" data-filter="0"></div>

 যে কোন
gl স্ট্রিং সার্চ ফলাফল বুস্ট করুন যার উৎপত্তি দেশ প্যারামিটার মানের সাথে মেলে।

এটি শুধুমাত্র ভাষার মান নির্ধারণের সাথে একত্রে কাজ করবে।

সমর্থিত মান

নমুনা ব্যবহার: <div class="gcse-search" data-gl="fr"></div>

 যে কোন
lr স্ট্রিং একটি নির্দিষ্ট ভাষায় লেখা নথিতে অনুসন্ধান ফলাফল সীমাবদ্ধ করে।

সমর্থিত মান

নমুনা ব্যবহার: <div class="gcse-search" data-lr="lang_fr"></div>

 যে কোন
sort_by স্ট্রিং তারিখ বা অন্যান্য কাঠামোগত বিষয়বস্তু ব্যবহার করে ফলাফল সাজান। বৈশিষ্ট্যের মান অবশ্যই প্রোগ্রামেবল সার্চ ইগ্নিনের ফলাফল বাছাই সেটিংসে প্রদত্ত বিকল্পগুলির মধ্যে একটি হতে হবে।

প্রাসঙ্গিকতা অনুসারে সাজানোর জন্য একটি খালি স্ট্রিং ব্যবহার করুন (sort_by="")।

নমুনা ব্যবহার: <div class="gcse-search" data-sort_by="date"></div>

 যে কোন
অনুসন্ধান ফলাফল
enableOrderBy বুলিয়ান প্রাসঙ্গিকতা, তারিখ বা লেবেল দ্বারা ফলাফলের বাছাই সক্ষম করে। যে কোন
linkTarget স্ট্রিং লিঙ্ক টার্গেট সেট করে। ডিফল্ট: _blank ।

অনুসন্ধান ফলাফল

শুধুমাত্র অনুসন্ধানের ফলাফল

noResultsString স্ট্রিং কোন ফলাফল কোয়েরির সাথে মেলে না তখন প্রদর্শনের জন্য ডিফল্ট পাঠ নির্দিষ্ট করে। ডিফল্ট ফলাফল স্ট্রিংটি সমস্ত সমর্থিত ভাষায় একটি স্থানীয় স্ট্রিং প্রদর্শন করতে ব্যবহার করা যেতে পারে, যখন কাস্টমাইজ করা হয় না।

অনুসন্ধান ফলাফল

শুধুমাত্র অনুসন্ধানের ফলাফল

resultSetSize পূর্ণসংখ্যা, স্ট্রিং ফলাফল সেট সর্বোচ্চ আকার. উদাহরণস্বরূপ, large , small , filtered_cse , 10 । ডিফল্টটি লেআউটের উপর নির্ভর করে এবং ইঞ্জিনটি সম্পূর্ণ ওয়েব বা শুধুমাত্র নির্দিষ্ট সাইট অনুসন্ধান করার জন্য কনফিগার করা হয়েছে কিনা। যে কোন
safeSearch স্ট্রিং ওয়েব এবং ছবি অনুসন্ধান উভয়ের জন্য নিরাপদ অনুসন্ধান সক্ষম কিনা তা নির্দিষ্ট করে৷ স্বীকৃত মানগুলি off এবং active । যে কোন

কলব্যাক

কলব্যাক সিকোয়েন্স ডায়াগ্রাম
সার্চ এলিমেন্ট জাভাস্ক্রিপ্ট থেকে কলব্যাকের সিকোয়েন্স ডায়াগ্রাম

কলব্যাকগুলি অনুসন্ধান-উপাদান প্রাথমিককরণ এবং অনুসন্ধান প্রক্রিয়াগুলির বিস্তারিত নিয়ন্ত্রণ সমর্থন করে। তারা সার্চ এলিমেন্ট জাভাস্ক্রিপ্টের সাথে বিশ্বব্যাপী __gcse অবজেক্টের মাধ্যমে নিবন্ধিত। রেজিস্টার কলব্যাক সমস্ত সমর্থিত কলব্যাকের নিবন্ধনকে চিত্রিত করে।

কলব্যাক নিবন্ধন করুন

  window.__gcse = {
    parsetags: 'explicit', // Defaults to 'onload'
    initializationCallback: myInitializationCallback,
    searchCallbacks: {
      image: {
        starting: myImageSearchStartingCallback,
        ready: myImageResultsReadyCallback,
        rendered: myImageResultsRenderedCallback,
      },
      web: {
        starting: myWebSearchStartingCallback,
        ready: myWebResultsReadyCallback,
        rendered: myWebResultsRenderedCallback,
      },
    },
  };

সূচনা কলব্যাক

সার্চ এলিমেন্ট জাভাস্ক্রিপ্ট DOM-এ সার্চ এলিমেন্ট রেন্ডার করার আগে ইনিশিয়ালাইজেশন কলব্যাক আহ্বান করা হয়। যদি parsetags __gcse এ explicit সেট করা থাকে, অনুসন্ধান উপাদান জাভাস্ক্রিপ্ট অনুসন্ধান উপাদানগুলিকে প্রারম্ভিক কলব্যাকে রেন্ডারিং ছেড়ে দেয় (যেমন রেজিস্টার কলব্যাকগুলিতে দেখানো হয়েছে)। এটি রেন্ডার করার জন্য উপাদান নির্বাচন করতে বা উপাদানগুলির প্রয়োজন না হওয়া পর্যন্ত রেন্ডারিং স্থগিত করতে ব্যবহার করা যেতে পারে। এটি উপাদানগুলির বৈশিষ্ট্যগুলিকেও ওভাররাইড করতে পারে; উদাহরণস্বরূপ, এটি একটি সার্চবক্সকে পরিণত করতে পারে যা কন্ট্রোল প্যানেল বা HTML অ্যাট্রিবিউটের মাধ্যমে কনফিগার করা হয়েছে ওয়েব সার্চের জন্য ডিফল্ট হিসেবে একটি ইমেজ সার্চ বক্সে, অথবা নির্দিষ্ট করতে পারে যে একটি প্রোগ্রামেবল সার্চ ইঞ্জিন ফর্মের মাধ্যমে জমা দেওয়া প্রশ্নগুলি শুধুমাত্র-সার্চ-রেজাল্ট এলিমেন্টে কার্যকর করা হয়। একটি ডেমো দেখুন.

প্রারম্ভিক কলব্যাকের ভূমিকা __gcse এর parsetags সম্পত্তির মান দ্বারা নিয়ন্ত্রিত হয়।

  • যদি এর মান onload হয়, অনুসন্ধান উপাদান জাভাস্ক্রিপ্ট স্বয়ংক্রিয়ভাবে পৃষ্ঠায় সমস্ত অনুসন্ধান উপাদান রেন্ডার করে। প্রারম্ভিক কলব্যাক এখনও আহ্বান করা হয়েছে, কিন্তু এটি অনুসন্ধান উপাদান রেন্ডার করার জন্য দায়ী নয়।
  • যদি এর মান explicit হয়, অনুসন্ধান উপাদান জাভাস্ক্রিপ্ট অনুসন্ধান উপাদান রেন্ডার করে না। কলব্যাক render() ফাংশন ব্যবহার করে বেছে বেছে সেগুলি রেন্ডার করতে পারে, বা go() ফাংশনের সাথে সমস্ত অনুসন্ধান উপাদান রেন্ডার করতে পারে

নিচের কোডটি দেখায় কিভাবে একটি সার্চ বক্স রেন্ডার করতে হয়, সার্চ ফলাফলের সাথে, একটি div এ, explicit পার্সেট্যাগ এবং ইনিশিয়ালাইজেশন কলব্যাক ব্যবহার করে:

ইনিশিয়ালাইজেশন কলব্যাক উদাহরণ

আমাদের একটি আইডি মান সহ একটি <div> অন্তর্ভুক্ত করতে হবে যেখানে আমরা অনুসন্ধান উপাদান কোড চাই:

    <div id="test"></div>
এই জাভাস্ক্রিপ্টটি <div> এর পরে যোগ করুন। মনে রাখবেন যে এটি test উল্লেখ করে, যে id আমরা <div>
const myInitCallback = function() {
  if (document.readyState == 'complete') {
    // Document is ready when Search Element is initialized.
    // Render an element with both search box and search results in div with id 'test'.
    google.search.cse.element.render(
        {
          div: "test",
          tag: 'search'
         });
  } else {
    // Document is not ready yet, when Search Element is initialized.
    google.setOnLoadCallback(function() {
       // Render an element with both search box and search results in div with id 'test'.
        google.search.cse.element.render(
            {
              div: "test",
              tag: 'search'
            });
    }, true);
  }
};

// Insert it before the Search Element code snippet so the global properties like parsetags and callback
// are available when cse.js runs.
window.__gcse = {
  parsetags: 'explicit',
  initializationCallback: myInitCallback
};
সনাক্ত করতে ব্যবহার করি

অনুসন্ধান উপাদান লোড করা শুরু করতে এই HTML অন্তর্ভুক্ত করুন। src ক্লজের cx মানটি আপনার নিজের cx দিয়ে প্রতিস্থাপন করুন।

<script async
  src="https://cse.google.com/cse.js?cx=000888210889775888983:y9tkcjel090"></script>

কলব্যাক অনুসন্ধান করুন

অনুসন্ধান উপাদান জাভাস্ক্রিপ্ট ছয়টি কলব্যাক সমর্থন করে যা অনুসন্ধান নিয়ন্ত্রণ প্রবাহে কাজ করে। অনুসন্ধান কলব্যাক জোড়ায় আসে, একটি ওয়েব-সার্চ কলব্যাক এবং মিলিত ইমেজ-সার্চ কলব্যাক:

  • অনুসন্ধান শুরু
    • ইমেজ অনুসন্ধানের জন্য
    • ওয়েব অনুসন্ধানের জন্য
  • ফলাফল প্রস্তুত
    • ইমেজ অনুসন্ধানের জন্য
    • ওয়েব অনুসন্ধানের জন্য
  • রেন্ডার করা ফলাফল
    • ইমেজ অনুসন্ধানের জন্য
    • ওয়েব অনুসন্ধানের জন্য

ইনিশিয়ালাইজেশন কলব্যাকের মতো, সার্চ কলব্যাকগুলি __gcse অবজেক্টের এন্ট্রি ব্যবহার করে কনফিগার করা হয়। সার্চ এলিমেন্ট জাভাস্ক্রিপ্ট শুরু হওয়ার সাথে সাথে এটি ঘটে। স্টার্টআপের পরে __gcse তে পরিবর্তন উপেক্ষা করা হয়।

এই কলব্যাকগুলির প্রতিটি একটি আর্গুমেন্ট হিসাবে অনুসন্ধান উপাদানের জন্য gName পাস করা হয়৷ একটি পৃষ্ঠায় একাধিক অনুসন্ধান থাকলে gname কার্যকর। data-gname অ্যাট্রিবিউট ব্যবহার করে একটি অনুসন্ধান উপাদানকে একটি gname মান দিন:

<div class="gcse-searchbox" data-gname="storesearch"></div>

যদি এইচটিএমএল জিনাম সনাক্ত না করে, অনুসন্ধান উপাদান জাভাস্ক্রিপ্ট একটি মান তৈরি করে যা এইচটিএমএল সংশোধন না হওয়া পর্যন্ত সামঞ্জস্যপূর্ণ থাকবে।

ছবি/ওয়েব সার্চ-স্টার্টিং কলব্যাক

অনুসন্ধান এলিমেন্ট জাভাস্ক্রিপ্ট তার সার্ভার থেকে অনুসন্ধানের ফলাফলের অনুরোধ করার আগেই অনুসন্ধান শুরু করার কলব্যাকগুলি আহ্বান করা হয়৷ একটি উদাহরণ ব্যবহার-কেস কোয়েরির পরিবর্তনগুলি নিয়ন্ত্রণ করতে দিনের স্থানীয় সময় ব্যবহার করা হবে।

searchStartingCallback(gname, query)
gname
অনুসন্ধান উপাদান এর সনাক্তকারী স্ট্রিং
query
ব্যবহারকারীর দ্বারা প্রবেশ করা মান (সম্ভবত অনুসন্ধান উপাদান জাভাস্ক্রিপ্ট দ্বারা পরিবর্তিত।)

কলব্যাক সেই মান প্রদান করে যা এই অনুসন্ধানের জন্য ক্যোয়ারী হিসাবে ব্যবহার করা উচিত। যদি এটি একটি খালি স্ট্রিং প্রদান করে, রিটার্ন মান উপেক্ষা করা হয় এবং কলকারী অপরিবর্তিত ক্যোয়ারী ব্যবহার করে।

বিকল্পভাবে, আপনি কলব্যাক ফাংশনটি __gcse অবজেক্টে রাখতে পারেন বা জাভাস্ক্রিপ্টের সাথে বস্তুতে গতিশীলভাবে কলব্যাক যোগ করতে পারেন:

window.__gcse['searchCallbacks']['web']['starting'] = function(gname, query) {...};
উদাহরণ অনুসন্ধান শুরু কলব্যাক

উদাহরণ অনুসন্ধান শুরু করার কলব্যাকের উদাহরণ অনুসন্ধান শুরু হওয়া কলব্যাক দিনের সময়ের উপর নির্ভর করে কোয়েরিতে morning বা afternoon যোগ করে।

অনুসন্ধান শুরু কলব্যাক উদাহরণ 
    const myWebSearchStartingCallback = (gname, query) => {
      const hour = new Date().getHours();
      return query + (hour < 12 ? ' morning' : ' afternoon');
    };
    window.myImageSearchStartingCallbackName = myWebSearchStartingCallback;

window.__gcse:

  window.__gcse || (window.__gcse = {});
    window.__gcse.searchCallbacks = {
      image: {
        starting: 'myImageSearchStartingCallbackName',
      },
      web: {
        starting: myWebSearchStartingCallback,
      },
    };
  

  <script
  async src="https://cse.google.com/cse.js?cx=000888210889775888983:y9tkcjel090"></script>
<div class="gcse-searchbox"></div>
<div class="gcse-searchresults"></div>

ছবি/ওয়েব অনুসন্ধানের ফলাফল-প্রস্তুত কলব্যাক

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

resultsReadyCallback(gname, query, promos, results, div)
gname
অনুসন্ধান উপাদান এর সনাক্তকারী স্ট্রিং
query
এই ফলাফল উত্পাদিত ক্যোয়ারী
promos
প্রচার বস্তুর একটি অ্যারে, যা ব্যবহারকারীর প্রশ্নের জন্য মিলিত প্রচারের সাথে মিলে যায়। প্রচার বস্তুর সংজ্ঞা দেখুন।
results
ফলাফল বস্তুর একটি অ্যারে। ফলাফল বস্তুর সংজ্ঞা দেখুন।
div
একটি HTML ডিভ DOM-এ অবস্থান করে যেখানে সার্চ এলিমেন্ট সাধারণত প্রচার এবং অনুসন্ধান ফলাফল রাখে। সাধারনত, সার্চ এলিমেন্ট জাভাস্ক্রিপ্ট এই ডিভটি পপুলেশন পরিচালনা করবে, কিন্তু এই কলব্যাকটি ফলাফলের স্বয়ংক্রিয় রেন্ডারিং বন্ধ করতে এবং ফলাফল নিজেই রেন্ডার করতে এই div ব্যবহার করতে পারে।

যদি এই কলব্যাকটি একটি true মান প্রদান করে, অনুসন্ধান উপাদান জাভাস্ক্রিপ্ট তার পৃষ্ঠা-ফুটারের কাজে চলে যায়।

উদাহরণ রেডি কলব্যাক ফলাফল

উদাহরণ resultsReady কলব্যাকের উদাহরণ রেডি কলব্যাক একটি খুব সাধারণ প্রতিস্থাপনের মাধ্যমে প্রচার এবং ফলাফলের ডিফল্ট উপস্থাপনাকে ওভাররাইড করে।

ফলাফল প্রস্তুত কলব্যাক উদাহরণ 
    const myResultsReadyCallback = function(name, q, promos, results, resultsDiv) {
      const makePromoElt = (promo) => {
        const anchor = document.createElement('a');
        anchor.href = promo['url'];
        anchor.target = '_blank';
        anchor.classList.add('gs-title');
        const span = document.createElement('span');
        span.innerHTML = 'Promo: ' + promo['title'];
        anchor.appendChild(span);
        return anchor;
      };
      const makeResultParts = (result) => {
        const anchor = document.createElement('a');
        anchor.href = result['url'];
        anchor.target = '_blank';
        anchor.classList.add('gs_title');
        anchor.appendChild(document.createTextNode(result['visibleUrl']));
        const span = document.createElement('span');
        span.innerHTML = ' ' + result['title'];
        return [anchor, span];
      };

      const table = document.createElement('table');
      if (promos) {
        for (const promo of promos) {
          const row = table.insertRow(-1);
          const cell = row.insertCell(-1);
          cell.appendChild(makePromoElt(promo));
        }
        resultsDiv.appendChild(table);
        resultsDiv.appendChild(document.createElement('br'));
      }
      if (results) {
        const table = document.createElement('table');
        for (const result of results) {
          const row = table.insertRow(-1);
          const cell = row.insertCell(-1);
          const [anchor, span] = makeResultParts(result);
          cell.appendChild(anchor);
          const cell2 = row.insertCell(-1);
          cell2.appendChild(span);
        }
        resultsDiv.appendChild(table);
      }
      return true;
    };

window.__gcse:

  window.__gcse || (window.__gcse = {});
    window.__gcse.searchCallbacks = {
      web: {
        ready: myResultsReadyCallback,
      },
    };
  <script async
  src="https://cse.google.com/cse.js?cx=000888210889775888983:y9tkcjel090"></script>
<div class="gcse-searchbox"></div>
<div class="gcse-searchresults"></div>

অনুসন্ধান শুরু কলব্যাকের মতো, উপরেরটি __gcse অবজেক্টে কলব্যাক রাখার অনেক উপায়ের মধ্যে একটি।

ইমেজ/ওয়েব সার্চের ফলাফল-রেন্ডার করা কলব্যাক

সার্চ এলিমেন্ট জাভাস্ক্রিপ্ট পৃষ্ঠার ফুটার রেন্ডার করার আগেই এই কলব্যাকগুলি আহ্বান করা হয়। উদাহরণ ব্যবহারের ক্ষেত্রে একটি কলব্যাক অন্তর্ভুক্ত থাকবে যা ফলাফলের বিষয়বস্তু যোগ করে যা অনুসন্ধান উপাদান প্রদর্শন করে না যেমন একটি সংরক্ষণ করুন এই চেকবক্স বা তথ্য যা স্বয়ংক্রিয়ভাবে রেন্ডার হয় না, অথবা একটি কলব্যাক যা আরও তথ্যের জন্য যোগ করে বোতাম।

যদি একটি ফলাফল রেন্ডার করা কলব্যাকের জন্য এমন তথ্যের প্রয়োজন হয় যা ফলাফলের রেডি কলব্যাকের promos এবং results প্যারামিটারে ছিল, তাহলে এটি তাদের মধ্যে পাস করতে পারে, যেমন:

callback(gname, query, promoElts, resultElts);
gname
অনুসন্ধান উপাদান এর সনাক্তকারী স্ট্রিং
query
অনুসন্ধান স্ট্রিং.
promoElts
প্রচার সহ DOM উপাদানগুলির একটি অ্যারে৷
resultElts
ফলাফল ধারণকারী DOM উপাদানের একটি অ্যারে।

কোন রিটার্ন মান নেই।

উদাহরণ রেন্ডারড কলব্যাক ফলাফল

উদাহরণের ফলাফলে resultsRendered কলব্যাকের উদাহরণ রেন্ডার করা কলব্যাক প্রতিটি প্রচার এবং ফলাফলে একটি ডামি Keep চেকবক্স যোগ করে।

ফলাফল রেন্ডার কলব্যাক উদাহরণ 
myWebResultsRenderedCallback = function(name, q, promos, results) {
    for (const div of promos.concat(results)) {
      const innerDiv = document.createElement('div');
      innerDiv.appendChild(document.createTextNode('Keep: '));
      const checkBox = document.createElement('input');
      checkBox.type = 'checkbox';
      checkBox.name = 'save';
      innerDiv.appendChild(checkBox);
      div.insertAdjacentElement('afterbegin', innerDiv);
    }
  };

window.__gcse:

window.__gcse || (window.__gcse = {});
window.__gcse.searchCallbacks = {
  web: {
    rendered: 'myWebResultsRenderedCallback',
  },
};

  <script async
    src="https://cse.google.com/cse.js?cx=000888210889775888983:y9tkcjel090"></script>
<div class="gcse-searchbox"></div>
<div class="gcse-searchresults"></div>

যদি রেন্ডার করা ফলাফলের কলব্যাকের তথ্যের প্রয়োজন হয় যা ফলাফলের জন্য প্রস্তুত কলব্যাকে পাস করা হয়েছিল তবে এটি কলব্যাকের মধ্যে সেই ডেটাটি পাস করতে পারে। নিম্নলিখিত উদাহরণটি richSnippet থেকে রেন্ডার করা ফলাফল থেকে রেন্ডার করা কলব্যাক থেকে রেন্ডার করা ফলাফলে একটি রেটিং মান পাস করার অনেক উপায় দেখায়৷

রেন্ডারড কলব্যাক ফলাফলের সাথে সহযোগিতা করা রেডি কলব্যাক ফলাফলের উদাহরণ
const makeTwoPartCallback = () => {
  let saveForRenderCallback;
  const readyCallback = (name, q, promos, results, resultsDiv) =>
  {
    saveForRenderCallback = [];
    for (const result of results) {
      const {
        richSnippet: {
          answer = []
        } = {},
      } = result;
      const firstAnswer = answer[0];
      if (firstAnswer) {
        const upVotes = firstAnswer['upvotecount'];
        if (upVotes) {
          saveForRenderCallback.push(
            {upvotes: parseInt(upVotes, 10)}
          );
          continue;
        }
      }
      saveForRenderCallback.push({});
    }
  };
  const renderedCallback = (name, q, promos, results) => {
    for (let i = 0; i < results.length; ++i) {
      const div = results[i];
      const votes = saveForRenderCallback[i]['upvotes'];
      if (votes) {
        const innerDiv = document.createElement('div');
        innerDiv.innerHTML = '<b>Upvotes: ' + votes + '</b>';
         div.insertAdjacentElement('afterbegin', innerDiv);
      }
    }
  };
  return {readyCallback, renderedCallback};
};
__gcse সেট আপ করার সময় এইরকম কোড ব্যবহার করে এই কলব্যাকটি ইনস্টল করুন :
const {
  readyCallback: webResultsReadyCallback,
  renderedCallback: webResultsRenderedCallback,
} = makeTwoPartCallback();
window.__gcse || (window.__gcse = {});
window.__gcse.searchCallbacks = {
  web: {
    ready: webResultsReadyCallback,
    rendered: webResultsRenderedCallback,
  },
};
  <script async
  src="https://cse.google.com/cse.js?cx=000888210889775888983:kdroeu4mwju"></script>
<div class="gcse-searchbox"></div>
<div class="gcse-searchresults"></div>

আরও কলব্যাক উদাহরণ

অতিরিক্ত কলব্যাক উদাহরণ আরও কলব্যাক উদাহরণ নথিতে পাওয়া যাবে।

প্রচার এবং ফলাফল বৈশিষ্ট্য

JSDoc স্বরলিপি ব্যবহার করে, এইগুলি প্রচার এবং ফলাফল বস্তুর বৈশিষ্ট্য। এখানে, আমরা উপস্থিত হতে পারে যে সমস্ত বৈশিষ্ট্য তালিকা. অনেক সম্পত্তির উপস্থিতি প্রচার বা অনুসন্ধান ফলাফলের বিবরণের উপর নির্ভর করে।

প্রচার বৈশিষ্ট্য
{
  content: string,
  image: {
    height: number,
    url: string,
    width: number,
  },
  title: string,
  url: string,
  visibleUrl: string,
}
ফলাফল বস্তু বৈশিষ্ট্য
{
  content: string,
  contentNoFormatting: string,
  contextUrl: string, // For image search results only
  fileFormat: string,
  image: { // For image search reseults only
    height: number,
    url: string,
    width: number,
  },
  perResultLabels: !Array<{
    anchor: string,
    label: string,
    labelWithOp: string,
  }>,
  richSnippet: !Array<!Object>, // For web search results only
  thumbnailImage: {
    height: number,
    url: string,
    width: number,
  },
  title: string,
  titleNoFormatting: string,
  url: string,
  visibleUrl: string,
}

richSnippet ফলাফলে অবজেক্টের একটি বিন্যাসের আলগা প্রকার রয়েছে। এই অ্যারের এন্ট্রির মানগুলি প্রতিটি অনুসন্ধান ফলাফলের জন্য ওয়েব পৃষ্ঠায় পাওয়া কাঠামোগত ডেটা দ্বারা নিয়ন্ত্রিত হয়৷ উদাহরণস্বরূপ, একটি পর্যালোচনা ওয়েব সাইটে স্ট্রাকচার্ড ডেটা অন্তর্ভুক্ত থাকতে পারে যা এই অ্যারে এন্ট্রিটিকে richSnippet এ যুক্ত করে :

'review': {
  'ratingstars': '3.0',
  'ratingcount': '1024',
},

প্রোগ্রামেবল সার্চ এলিমেন্ট কন্ট্রোল API (V2)

google.search.cse.element অবজেক্ট নিম্নলিখিত স্ট্যাটিক ফাংশন প্রকাশ করে:

ফাংশন বর্ণনা
.render(componentConfig, opt_componentConfig) একটি অনুসন্ধান উপাদান রেন্ডার করে।

পরামিতি

নাম বর্ণনা
componentConfig একটি প্রোগ্রামযোগ্য অনুসন্ধান উপাদান উপাদানের জন্য কনফিগারেশন। নিম্নলিখিতগুলি নির্দিষ্ট করে:
  • div (string|Element): <div> বা div এলিমেন্টের id যেখানে প্রোগ্রামেবল সার্চ এলিমেন্ট রেন্ডার করা হবে।
  • tag (স্ট্রিং): যে ধরনের উপাদান (গুলি) রেন্ডার করা হবে। (যখন opt_componentConfig সরবরাহ করা হয়, tag অ্যাট্রিবিউটের মান অবশ্যই searchbox হতে হবে।) অনুমোদিত মানগুলি হল:
    • search : একটি অনুসন্ধান বাক্স এবং অনুসন্ধান ফলাফল, একসাথে প্রদর্শিত
    • searchbox : একটি প্রোগ্রামেবল সার্চ এলিমেন্টের একটি সার্চ বক্স উপাদান।
    • searchbox-only : একটি স্বতন্ত্র অনুসন্ধান বাক্স, যা দুই-কলাম বিন্যাসে opt_componentConfig দ্বারা নির্দিষ্ট করা অনুসন্ধান ফলাফলের ব্লকের সাথে যুক্ত করা হবে।
    • searchresults-only : অনুসন্ধান ফলাফলের একটি স্বতন্ত্র ব্লক। অনুসন্ধানগুলি একটি URL এ এমবেড করা একটি ক্যোয়ারী প্যারামিটার দ্বারা বা প্রোগ্রাম্যাটিক এক্সিকিউশন দ্বারা ট্রিগার করা হয়৷
  • gname (স্ট্রিং): (ঐচ্ছিক) এই উপাদানটির জন্য একটি অনন্য নাম। সরবরাহ করা না হলে, প্রোগ্রামেবল সার্চ ইঞ্জিন স্বয়ংক্রিয়ভাবে একটি gname তৈরি করবে।
  • attributes (বস্তু): একটি কী আকারে ঐচ্ছিক বৈশিষ্ট্য: মান জোড়া। সমর্থিত বৈশিষ্ট্য.
opt_componentConfig ঐচ্ছিক। দ্বিতীয় উপাদান কনফিগারেশন যুক্তি. searchresults উপাদান প্রদান করতে TWO_COLUMN মোডে ব্যবহৃত হয়৷ নিম্নলিখিতগুলি নির্দিষ্ট করে:
  • div (স্ট্রিং): <div> বা div উপাদানের id যেখানে উপাদানটি রেন্ডার করা হবে।
  • tag (স্ট্রিং): যে ধরনের উপাদান (গুলি) রেন্ডার করা হবে। যখন opt_componentConfig সরবরাহ করা হয়, tag বৈশিষ্ট্যের মান অবশ্যই searchresults হতে হবে। উপরন্তু, componentConfig এর tag অ্যাট্রিবিউটের মান অবশ্যই searchbox হতে হবে।
  • gname (স্ট্রিং): (ঐচ্ছিক) এই উপাদানটির জন্য একটি অনন্য নাম। সরবরাহ করা না হলে, প্রোগ্রামেবল সার্চ ইঞ্জিন স্বয়ংক্রিয়ভাবে এই উপাদানটির জন্য একটি gname তৈরি করবে। সরবরাহ করা হলে, এটা অবশ্যই componentConfig এ gname এর সাথে মিলবে।
  • attributes (বস্তু): একটি কী আকারে ঐচ্ছিক বৈশিষ্ট্য: মান জোড়া। সমর্থিত বৈশিষ্ট্য.
.go(opt_container) নির্দিষ্ট কন্টেইনারে সমস্ত অনুসন্ধান উপাদান ট্যাগ/ক্লাস রেন্ডার করে।

পরামিতি

নাম বর্ণনা
opt_container রেন্ডার করার জন্য অনুসন্ধান উপাদান উপাদান ধারণকারী ধারক। ধারক (স্ট্রিং) বা উপাদান নিজেই আইডি নির্দিষ্ট করুন। যদি বাদ দেওয়া হয়, পৃষ্ঠার body ট্যাগের ভিতরে সমস্ত প্রোগ্রামেবল অনুসন্ধান উপাদান উপাদান রেন্ডার করা হবে।
.getElement(gname) gname দ্বারা উপাদান বস্তু পায়। যদি পাওয়া না যায়, নাল ফেরত.

ফিরে আসা element বস্তুর নিম্নলিখিত বৈশিষ্ট্য আছে:

  • gname : উপাদান বস্তুর নাম। সরবরাহ করা না হলে, প্রোগ্রামেবল সার্চ ইঞ্জিন স্বয়ংক্রিয়ভাবে বস্তুর জন্য একটি gname তৈরি করবে। অধিক তথ্য.
  • type : উপাদানের ধরন।
  • uiOptions : উপাদান রেন্ডার করতে ব্যবহৃত চূড়ান্ত বৈশিষ্ট্য।
  • execute - function(string): একটি প্রোগ্রামেটিক ক্যোয়ারী এক্সিকিউট করে।
  • prefillQuery - ফাংশন(স্ট্রিং): ক্যোয়ারী এক্সিকিউট না করেই সার্চবক্সে একটি কোয়েরি স্ট্রিং দিয়ে প্রিফিল করে।
  • getInputQuery - ফাংশন(): ইনপুট বক্সে প্রদর্শিত বর্তমান মান পায়।
  • clearAllResults - function(): সার্চ বক্স ছাড়া সবকিছু লুকিয়ে নিয়ন্ত্রণ সাফ করে, যদি থাকে।

নিম্নলিখিত কোড অনুসন্ধান উপাদান "element1"-এ "সংবাদ" অনুসন্ধান চালায়:

var element = google.search.cse.element.getElement('element1');
            element.execute('news');
.getAllElements() gname দ্বারা চাবিকৃত সমস্ত সফলভাবে তৈরি করা উপাদান বস্তুর একটি মানচিত্র ফেরত দেয়।