বুকিং সার্ভার প্রস্তুত, বুকিং সার্ভার প্রস্তুত

আপনার পক্ষ থেকে বুকিং তৈরি এবং আপডেট করার জন্য অ্যাকশন সেন্টারকে কলব্যাক করতে দেওয়ার জন্য আপনার একটি বুকিং সার্ভারের প্রয়োজন৷ এটি অ্যাকশন সেন্টারকে ব্যবহারকারীর পক্ষ থেকে আপনার সাথে অ্যাপয়েন্টমেন্ট, বুকিং এবং রিজার্ভেশন তৈরি করতে দেয়।

আপনার স্যান্ডবক্স এবং প্রোডাকশন বুকিং সার্ভারের সাথে সংযোগটি কীভাবে কনফিগার করবেন তা জানতে, বুকিং সার্ভার শংসাপত্র কনফিগার করুন দেখুন।

আপনি রিয়েল-টাইম আপডেটে যাওয়ার আগে নিম্নলিখিত বুকিং সার্ভার প্রস্তুত কাজগুলি সম্পূর্ণ করুন:

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

একটি REST API ইন্টারফেস প্রয়োগ করুন

REST এর উপর ভিত্তি করে একটি API ইন্টারফেস প্রয়োগ করুন। এটি Google কে HTTPS এর মাধ্যমে বুকিং সার্ভারের অনুরোধ পাঠাতে দেয়।

একটি API ইন্টারফেস বাস্তবায়ন করতে, একটি ডেভেলপমেন্ট বা স্যান্ডবক্স বুকিং সার্ভার সেট আপ করুন যা অ্যাকশন সেন্টার স্যান্ডবক্স পরিবেশের সাথে সংযোগ করে। স্যান্ডবক্স সার্ভার সম্পূর্ণভাবে পরীক্ষা করার পরেই একটি উত্পাদন পরিবেশে যান৷

Google-এর বুকিং সার্ভারের সমস্ত অনুরোধ বুকিং সার্ভার পৃষ্ঠায় সেট করা বুকিং সার্ভার URL-এর সাথে সম্পর্কিত৷ উদাহরণ স্বরূপ, যদি আপনার URL api.example.com/google এ সেট করা থাকে, তাহলে সমস্ত HealthCheck অনুরোধ পাঠানো হয় api.example.com/google/v3/HealthCheck এ।

নিশ্চিত করুন যে সঠিক বুকিং সার্ভার এন্ডপয়েন্টটি স্যান্ডবক্স এবং প্রোডাকশন উভয় পরিবেশের জন্য পরিবেশ সুইচারের সাথে কনফিগার করা হয়েছে।

নিরাপত্তা এবং প্রমাণীকরণ

আপনার বুকিং সার্ভারে সমস্ত যোগাযোগ বেসিক প্রমাণীকরণ ব্যবহার করে HTTPS এর মাধ্যমে ঘটে। আপনার সার্ভার সেট আপ করতে সাহায্য করার জন্য, আমরা একটি সর্বজনীনভাবে উপলব্ধ SSL বা TLS যাচাইকরণ টুল ব্যবহার করার পরামর্শ দিই, যেমন Qualys' SSL সার্ভার পরীক্ষা ৷

Google আপনার বুকিং সার্ভারে যে সমস্ত অনুরোধ করে তা HTTPS মৌলিক প্রমাণীকরণের মাধ্যমে প্রমাণীকৃত হয়। আপনি অ্যাকশন সেন্টারের বুকিং সার্ভার কনফিগারেশন পৃষ্ঠায় আপনার বুকিং সার্ভারের মৌলিক প্রমাণীকরণ তথ্য, পাসওয়ার্ড এবং ব্যবহারকারীর নাম লিখতে পারেন। শংসাপত্র প্রতি ছয় মাসে পরিবর্তন করতে হবে।

আপনার বুকিং সার্ভার তৈরি করুন

বুকিং সার্ভার নির্ধারণ করে কিভাবে ইন্টিগ্রেশন আপনার সিস্টেমের সাথে যোগাযোগ করে এবং বুকিং তৈরি বা আপডেট করে। আপনার স্যান্ডবক্স এবং প্রোডাকশন বুকিং সার্ভারের সাথে সংযোগ কনফিগার করতে, বুকিং সার্ভার শংসাপত্র কনফিগার করুন দেখুন।

আপনার বুকিং সার্ভার Google এর মাধ্যমে রিজার্ভের অনুরোধে যে প্রতিক্রিয়া দেয় তাতে সঠিক, রিয়েল-টাইম ইনভেনটরি বিশদ থাকবে বলে আশা করা হচ্ছে। নিম্নলিখিত সারণী প্রতিটি বাস্তবায়নের পদ্ধতিগুলি দেখায়, এবং পরিষেবা প্রোটোকল ফর্ম্যাটের লিঙ্কগুলি অন্তর্ভুক্ত করে:

পদ্ধতি সংজ্ঞা প্রতিক্রিয়া HTTP অনুরোধ
BatchAvailabilityLookup পৃষ্ঠা লোড

যখন একজন ব্যবহারকারী আপনার বণিকের জন্য একটি টেবিল সংরক্ষণ করুন ক্লিক করেন, তখন পৃষ্ঠা লোডের জন্য BatchAvailabilityLookup অনুরোধটি বলা হয়।

পেলোডে অসংখ্য স্লট রয়েছে যা আপনার সাম্প্রতিক ফিড আপলোডের উপর ভিত্তি করে, যা Google এর সাথে রিজার্ভ উপলব্ধ বলে মনে করে।

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

প্রতিক্রিয়া অবশ্যই বুকিংয়ের সাফল্য বা ব্যর্থতার প্রতিনিধিত্ব করবে।

বুকিং ব্যর্থ হলে, আপনাকে ব্যর্থতার নির্দিষ্ট কারণ ফেরত দিতে হবে। উদাহরণস্বরূপ, CreateBooking প্রতিক্রিয়া কল করার আগে স্লটটি বুক করা হয়েছিল।

যদি একটি সফল বুকিং তৈরি করা হয়, তবে প্রতিক্রিয়াটিতে ভবিষ্যতের যেকোনো অনুরোধ বা আপডেটে বুকিং উল্লেখ করার জন্য একটি অনন্য booking_id অন্তর্ভুক্ত থাকে।

 POST /v3/CreateBooking/
UpdateBooking Google এর মাধ্যমে রিজার্ভের মাধ্যমে বুকিং করার পরে, একজন ব্যবহারকারী তাদের বুকিং পরিবর্তন করতে বেছে নিতে পারেন। যখন ব্যবহারকারী তাদের রিজার্ভেশন আপডেট করে বা এটি বাতিল করে, একটি UpdateBooking অনুরোধ পাঠানো হয়। CreateBooking প্রতিক্রিয়ার মতো, UpdateBooking এ আপনার প্রতিক্রিয়া অবশ্যই বুকিংয়ের সাফল্যের প্রতিনিধিত্ব করবে বা ব্যর্থতার নির্দিষ্ট কারণ ফেরত দেবে। পোস্ট /v3/আপডেটবুকিং/
HealthCheck আপনার অবকাঠামো সক্রিয় এবং চলমান কিনা তা নিশ্চিত করতে অ্যাকশন সেন্টার আপনার বুকিং সার্ভারে নিয়মিত কল করে।

আপনার সার্ভারের পরিবেশন স্থিতি নির্দেশ করতে HTTP স্থিতি কোড ব্যবহার করুন৷ সার্ভার সক্রিয় এবং সফলভাবে চলমান থাকলে একটি HTTP স্থিতি কোড 200 ফেরত দিন।

একটি ত্রুটি নির্দেশ করতে বা সাময়িকভাবে আপনার ইন্টিগ্রেশন অফলাইনে নিতে, উপযুক্ত নন-2xx HTTP স্ট্যাটাস কোডটি ফেরত দিন।

 পান /v3/স্বাস্থ্য পরীক্ষা/

স্যান্ডবক্স বুকিং প্রবাহ

স্যান্ডবক্স বুকিং ফ্লো দেখতে, অ্যাকশন সেন্টার ইনভেন্টরি ভিউতে যান। ইনভেন্টরি ভিউ-এর RwG - E2E কলামটি স্যান্ডবক্স বণিকদের জন্য স্যান্ডবক্স বুকিং ফ্লোতে একটি লাইভ (স্যান্ডবক্সে) লিঙ্ক প্রদর্শন করে যা মিলে যায় এবং ভবিষ্যতে উপলব্ধ থাকে।

বুকিং প্রবাহে নিম্নলিখিত ক্রিয়াগুলি রয়েছে:

  • আপনি যখন RwG - E2E লিঙ্কে ক্লিক করেন, এটি পৃষ্ঠা লোডের সময় একটি BatchAvailabilityLookup অনুরোধ ট্রিগার করে এবং ব্যবসায়ীর পরিচিত উপলব্ধতা উপস্থাপন করে।
  • আপনি যখন একটি রিজার্ভেশন সময় ক্লিক করেন, তখন এটি স্লট ক্লিকের অনুরোধে BatchAvailabilityLookup ট্রিগার করে এবং বুকিং মডেল উপস্থাপন করে।
  • CreateBooking অনুরোধ পাঠাতে বুকিং মডেল সহ একটি বুকিং সম্পূর্ণ করুন।
  • আপনি স্যান্ডবক্স পরিবেশে একটি বুকিং সম্পূর্ণ করার পরে, বুকিং তৈরি করতে ব্যবহৃত অ্যাকাউন্টটি বুকিংয়ের বিবরণ সহ একটি ইমেল নিশ্চিতকরণ পায়।
  • UpdateBooking পদ্ধতিটি ট্রিগার করতে, ইমেল থেকে বুকিং পরিবর্তন বা বাতিল করুন।

স্বাস্থ্য পরীক্ষা

স্যান্ডবক্স এবং উৎপাদনে HealthCheck পদ্ধতি প্রয়োগ করা নিশ্চিত করুন। এই পদ্ধতিটি আপনার বুকিং সার্ভারের স্বাস্থ্যের অবস্থা ফিরিয়ে দেয়। এটি Google কে ক্রমাগত আপনার বুকিং সার্ভারের পরিবেশন অবস্থা নিরীক্ষণ করতে দেয়।

অনুরোধ : কোনোটিই নয়

রিটার্ন মান : কোনটিই নয়

আপনার সার্ভারের পরিবেশন স্থিতি নির্দেশ করতে HTTP স্থিতি কোড ব্যবহার করুন৷

যদি সার্ভার সক্রিয় থাকে এবং সফলভাবে চলে, তাহলে একটি HTTP স্থিতি কোড 200 ফেরত দিন, অথবা ত্রুটি নির্দেশ করতে HTTP স্থিতি কোডের একটি ফেরত দিন।

একটি REST API ইন্টারফেস প্রয়োগ করুন

REST এর উপর ভিত্তি করে একটি API ইন্টারফেস প্রয়োগ করুন। এটি Google কে HTTPS এর মাধ্যমে বুকিং সার্ভারের অনুরোধ পাঠাতে দেয়।

একটি API ইন্টারফেস বাস্তবায়ন করতে, একটি ডেভেলপমেন্ট বা স্যান্ডবক্স বুকিং সার্ভার সেট আপ করুন যা অ্যাকশন সেন্টার স্যান্ডবক্স পরিবেশের সাথে সংযোগ করে। স্যান্ডবক্স সার্ভার সম্পূর্ণভাবে পরীক্ষা করার পরেই একটি উত্পাদন পরিবেশে যান৷

Google-এর বুকিং সার্ভারের সমস্ত অনুরোধ বুকিং সার্ভার পৃষ্ঠায় সেট করা বুকিং সার্ভার URL-এর সাথে সম্পর্কিত৷ উদাহরণ স্বরূপ, যদি আপনার URL api.example.com/google এ সেট করা থাকে, তাহলে সমস্ত HealthCheck অনুরোধ পাঠানো হয় api.example.com/google/v3/HealthCheck এ।

নিশ্চিত করুন যে সঠিক বুকিং সার্ভার এন্ডপয়েন্টটি স্যান্ডবক্স এবং প্রোডাকশন উভয় পরিবেশের জন্য পরিবেশ সুইচারের সাথে কনফিগার করা হয়েছে।

নিরাপত্তা এবং প্রমাণীকরণ

আপনার বুকিং সার্ভারে সমস্ত যোগাযোগ বেসিক প্রমাণীকরণ ব্যবহার করে HTTPS এর মাধ্যমে ঘটে। আপনার সার্ভার সেট আপ করতে সাহায্য করার জন্য, আমরা একটি সর্বজনীনভাবে উপলব্ধ SSL বা TLS যাচাইকরণ টুল ব্যবহার করার পরামর্শ দিই, যেমন Qualys' SSL সার্ভার পরীক্ষা ৷

Google আপনার বুকিং সার্ভারে যে সমস্ত অনুরোধ করে তা HTTPS মৌলিক প্রমাণীকরণের মাধ্যমে প্রমাণীকৃত হয়। আপনি অ্যাকশন সেন্টারের বুকিং সার্ভার কনফিগারেশন পৃষ্ঠায় আপনার বুকিং সার্ভারের মৌলিক প্রমাণীকরণ তথ্য, পাসওয়ার্ড এবং ব্যবহারকারীর নাম লিখতে পারেন। শংসাপত্র প্রতি ছয় মাসে পরিবর্তন করতে হবে।

আপনার বুকিং সার্ভার তৈরি করুন

বুকিং সার্ভার নির্ধারণ করে কিভাবে ইন্টিগ্রেশন আপনার সিস্টেমের সাথে যোগাযোগ করে এবং বুকিং তৈরি বা আপডেট করে। আপনার স্যান্ডবক্স এবং প্রোডাকশন বুকিং সার্ভারের সাথে সংযোগ কনফিগার করতে, বুকিং সার্ভার শংসাপত্র কনফিগার করুন দেখুন।

আপনার বুকিং সার্ভার Google এর মাধ্যমে রিজার্ভের অনুরোধে যে প্রতিক্রিয়া দেয় তাতে সঠিক, রিয়েল-টাইম ইনভেনটরি বিশদ থাকবে বলে আশা করা হচ্ছে। নিম্নলিখিত সারণী প্রতিটি বাস্তবায়নের পদ্ধতিগুলি দেখায়, এবং পরিষেবা প্রোটোকল ফর্ম্যাটের লিঙ্কগুলি অন্তর্ভুক্ত করে:

পদ্ধতি সংজ্ঞা প্রতিক্রিয়া HTTP অনুরোধ
BatchAvailabilityLookup পৃষ্ঠা লোড

যখন একজন ব্যবহারকারী আপনার বণিকের জন্য একটি টেবিল সংরক্ষণ করুন ক্লিক করেন, তখন পৃষ্ঠা লোডের জন্য BatchAvailabilityLookup অনুরোধটি বলা হয়।

পেলোডে অসংখ্য স্লট রয়েছে যা আপনার সাম্প্রতিক ফিড আপলোডের উপর ভিত্তি করে, যা Google এর সাথে রিজার্ভ উপলব্ধ বলে মনে করে।

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

প্রতিক্রিয়া অবশ্যই বুকিংয়ের সাফল্য বা ব্যর্থতার প্রতিনিধিত্ব করবে।

বুকিং ব্যর্থ হলে, আপনাকে ব্যর্থতার নির্দিষ্ট কারণ ফেরত দিতে হবে। উদাহরণস্বরূপ, CreateBooking প্রতিক্রিয়া কল করার আগে স্লটটি বুক করা হয়েছিল।

যদি একটি সফল বুকিং তৈরি করা হয়, তবে প্রতিক্রিয়াটিতে ভবিষ্যতের যেকোনো অনুরোধ বা আপডেটে বুকিং উল্লেখ করার জন্য একটি অনন্য booking_id অন্তর্ভুক্ত থাকে।

 POST /v3/CreateBooking/
UpdateBooking Google এর মাধ্যমে রিজার্ভের মাধ্যমে বুকিং করার পরে, একজন ব্যবহারকারী তাদের বুকিং পরিবর্তন করতে বেছে নিতে পারেন। যখন ব্যবহারকারী তাদের রিজার্ভেশন আপডেট করে বা এটি বাতিল করে, একটি UpdateBooking অনুরোধ পাঠানো হয়। CreateBooking প্রতিক্রিয়ার মতো, UpdateBooking এ আপনার প্রতিক্রিয়া অবশ্যই বুকিংয়ের সাফল্যের প্রতিনিধিত্ব করবে বা ব্যর্থতার নির্দিষ্ট কারণ ফেরত দেবে। পোস্ট /v3/আপডেটবুকিং/
HealthCheck আপনার অবকাঠামো সক্রিয় এবং চলমান কিনা তা নিশ্চিত করতে অ্যাকশন সেন্টার আপনার বুকিং সার্ভারে নিয়মিত কল করে।

আপনার সার্ভারের পরিবেশন স্থিতি নির্দেশ করতে HTTP স্থিতি কোড ব্যবহার করুন৷ সার্ভার সক্রিয় এবং সফলভাবে চলমান থাকলে একটি HTTP স্থিতি কোড 200 ফেরত দিন।

একটি ত্রুটি নির্দেশ করতে বা সাময়িকভাবে আপনার ইন্টিগ্রেশন অফলাইনে নিতে, উপযুক্ত নন-2xx HTTP স্ট্যাটাস কোডটি ফেরত দিন।

 পান /v3/স্বাস্থ্য পরীক্ষা/

স্যান্ডবক্স বুকিং প্রবাহ

স্যান্ডবক্স বুকিং ফ্লো দেখতে, অ্যাকশন সেন্টার ইনভেন্টরি ভিউতে যান। ইনভেন্টরি ভিউ-এর RwG - E2E কলামটি স্যান্ডবক্স বণিকদের জন্য স্যান্ডবক্স বুকিং ফ্লোতে একটি লাইভ (স্যান্ডবক্সে) লিঙ্ক প্রদর্শন করে যা মিলে যায় এবং ভবিষ্যতে উপলব্ধ থাকে।

বুকিং প্রবাহে নিম্নলিখিত ক্রিয়াগুলি রয়েছে:

  • আপনি যখন RwG - E2E লিঙ্কে ক্লিক করেন, এটি পৃষ্ঠা লোডের সময় একটি BatchAvailabilityLookup অনুরোধ ট্রিগার করে এবং ব্যবসায়ীর পরিচিত উপলব্ধতা উপস্থাপন করে।
  • আপনি যখন একটি রিজার্ভেশন সময় ক্লিক করেন, তখন এটি স্লট ক্লিকের অনুরোধে BatchAvailabilityLookup ট্রিগার করে এবং বুকিং মডেল উপস্থাপন করে।
  • CreateBooking অনুরোধ পাঠাতে বুকিং মডেল সহ একটি বুকিং সম্পূর্ণ করুন।
  • আপনি স্যান্ডবক্স পরিবেশে একটি বুকিং সম্পূর্ণ করার পরে, বুকিং তৈরি করতে ব্যবহৃত অ্যাকাউন্টটি বুকিংয়ের বিবরণ সহ একটি ইমেল নিশ্চিতকরণ পায়।
  • UpdateBooking পদ্ধতিটি ট্রিগার করতে, ইমেল থেকে বুকিং পরিবর্তন বা বাতিল করুন।

স্বাস্থ্য পরীক্ষা

স্যান্ডবক্স এবং উৎপাদনে HealthCheck পদ্ধতি প্রয়োগ করা নিশ্চিত করুন। এই পদ্ধতিটি আপনার বুকিং সার্ভারের স্বাস্থ্যের অবস্থা ফিরিয়ে দেয়। এটি Google কে ক্রমাগত আপনার বুকিং সার্ভারের পরিবেশন অবস্থা নিরীক্ষণ করতে দেয়।

অনুরোধ : কোনোটিই নয়

রিটার্ন মান : কোনটিই নয়

আপনার সার্ভারের পরিবেশন স্থিতি নির্দেশ করতে HTTP স্থিতি কোড ব্যবহার করুন৷

যদি সার্ভার সক্রিয় থাকে এবং সফলভাবে চলে, তাহলে একটি HTTP স্থিতি কোড 200 ফেরত দিন, অথবা ত্রুটি নির্দেশ করতে HTTP স্থিতি কোডের একটি ফেরত দিন।