আপনার হয়ে বুকিং তৈরি ও আপডেট করার জন্য অ্যাকশন সেন্টারকে কলব্যাক করতে দেওয়ার জন্য একটি বুকিং সার্ভার প্রয়োজন। এর মাধ্যমে অ্যাকশন সেন্টার ব্যবহারকারীর পক্ষ থেকে আপনার সাথে অ্যাপয়েন্টমেন্ট, বুকিং এবং রিজার্ভেশন তৈরি করতে পারে।
আপনার স্যান্ডবক্স এবং প্রোডাকশন বুকিং সার্ভারের সংযোগ কীভাবে কনফিগার করতে হয় তা জানতে, বুকিং সার্ভার ক্রেডেনশিয়াল কনফিগার করুন দেখুন।
রিয়েল-টাইম আপডেটে যাওয়ার আগে নিম্নলিখিত বুকিং সার্ভার প্রস্তুত করার কাজগুলো সম্পন্ন করুন:
- ব্যাচঅ্যাভেইলেবিলিটিলুকআপ পেজ লোডের জন্য প্রস্তুত
- ব্যাচ প্রাপ্যতা অনুসন্ধান স্লট ক্লিক প্রস্তুত
- বুকিং তৈরি করুন প্রস্তুত
- আপডেটবুকিং প্রস্তুত
- আপনার অ্যাকশন সেন্টার কনফিগারেশন অ্যাকাউন্ট বৈশিষ্ট্যগুলিতে উপলব্ধতা পরীক্ষক সক্রিয় করুন।
যখন আপনি স্যান্ডবক্স বুকিং ফ্লো-এর মাধ্যমে বুকিং সার্ভার রিকোয়েস্টে সঠিক, রিয়েল-টাইম ইনভেন্টরি বিবরণ পাঠান, তখন প্রতিটি টাস্ক সম্পন্ন হিসেবে চিহ্নিত হয় এবং সবুজ হয়ে যায়। বুকিং সার্ভারের মাইলস্টোনগুলো ১৪ দিনের একটি সময়কাল ধরে বিশ্লেষণ করা হয়।
একটি REST API ইন্টারফেস বাস্তবায়ন করুন
REST ভিত্তিক একটি API ইন্টারফেস বাস্তবায়ন করুন। এর ফলে গুগল HTTPS-এর মাধ্যমে বুকিং সার্ভার রিকোয়েস্ট পাঠাতে পারবে।
একটি এপিআই ইন্টারফেস বাস্তবায়ন করতে, একটি ডেভেলপমেন্ট বা স্যান্ডবক্স বুকিং সার্ভার সেট আপ করুন যা অ্যাকশনস সেন্টার স্যান্ডবক্স এনভায়রনমেন্টের সাথে সংযুক্ত থাকে। স্যান্ডবক্স সার্ভারটি সম্পূর্ণরূপে পরীক্ষিত হওয়ার পরেই কেবল প্রোডাকশন এনভায়রনমেন্টে যান।
গুগলের বুকিং সার্ভারের সমস্ত অনুরোধ বুকিং সার্ভার পৃষ্ঠায় সেট করা বুকিং সার্ভার ইউআরএল-এর সাপেক্ষে পাঠানো হয়। উদাহরণস্বরূপ, যদি আপনার ইউআরএল api.example.com/google সেট করা থাকে, তাহলে সমস্ত HealthCheck অনুরোধ api.example.com/google/v3/HealthCheck এ পাঠানো হবে।
এনভায়রনমেন্ট সুইচার ব্যবহার করে স্যান্ডবক্স এবং প্রোডাকশন উভয় এনভায়রনমেন্টের জন্য সঠিক বুকিং সার্ভার এন্ডপয়েন্ট কনফিগার করা আছে কিনা, তা নিশ্চিত করুন।
নিরাপত্তা এবং প্রমাণীকরণ
আপনার বুকিং সার্ভারের সাথে সমস্ত যোগাযোগ বেসিক অথেনটিকেশন ব্যবহার করে HTTPS-এর মাধ্যমে সম্পন্ন হয়। আপনার সার্ভার সেট আপ করতে সাহায্য করার জন্য, আমরা Qualys-এর SSL সার্ভার টেস্ট- এর মতো সর্বজনীনভাবে উপলব্ধ একটি SSL বা TLS ভেরিফিকেশন টুল ব্যবহার করার পরামর্শ দিই।
আপনার বুকিং সার্ভারে Google-এর করা সমস্ত অনুরোধ HTTPS বেসিক অথেনটিকেশনের মাধ্যমে প্রমাণীকৃত হয়। আপনি অ্যাকশন সেন্টারের বুকিং সার্ভার কনফিগারেশন পৃষ্ঠায় আপনার বুকিং সার্ভারের বেসিক অথেনটিকেশন তথ্য, পাসওয়ার্ড এবং ইউজারনেম প্রবেশ করাতে পারেন। প্রতি ছয় মাস অন্তর ক্রেডেনশিয়াল পরিবর্তন করতে হবে।
আপনার বুকিং সার্ভার তৈরি করুন
বুকিং সার্ভার নির্ধারণ করে যে ইন্টিগ্রেশনটি আপনার সিস্টেমের সাথে কীভাবে যোগাযোগ করবে এবং বুকিং করবে বা আপডেট করবে। আপনার স্যান্ডবক্স এবং প্রোডাকশন বুকিং সার্ভারের সাথে সংযোগ কনফিগার করতে, ‘বুকিং সার্ভার ক্রেডেনশিয়াল কনফিগার করুন ’ দেখুন।
Reserve with Google থেকে আসা কোনো অনুরোধের জবাবে আপনার বুকিং সার্ভারের প্রতিটি প্রতিক্রিয়ায় সঠিক, রিয়েল-টাইম ইনভেন্টরির বিবরণ থাকা আবশ্যক। নিম্নলিখিত সারণিতে প্রতিটি বাস্তবায়নের পদ্ধতি দেখানো হয়েছে এবং এতে পরিষেবা প্রোটোকল ফরম্যাটগুলোর লিঙ্ক অন্তর্ভুক্ত রয়েছে:
| পদ্ধতি | সংজ্ঞা | প্রতিক্রিয়া | HTTP অনুরোধ |
|---|---|---|---|
BatchAvailabilityLookup পৃষ্ঠা লোড | যখন কোনো ব্যবহারকারী আপনার মার্চেন্টের জন্য 'রিজার্ভ এ টেবিল' (Reserve a Table) এ ক্লিক করেন, তখন পেজ লোড হওয়ার সময় পেলোডটিতে আপনার সর্বশেষ ফিড আপলোডগুলোর ওপর ভিত্তি করে অসংখ্য স্লট রয়েছে, যেগুলোকে রিজার্ভ উইথ গুগল উপলব্ধ বলে মনে করে। | প্রতিক্রিয়ায় অবশ্যই প্রতিটি স্লটের অনুরোধ এবং স্লটটির বর্তমান প্রাপ্যতা অন্তর্ভুক্ত থাকতে হবে। এর ফলে কোনো অনুপলব্ধ স্লট প্রদর্শিত হয় না। | POST /v3/ব্যাচ উপলভ্যতা লুকআপ/ |
BatchAvailabilityLookup স্লট ক্লিক | যখন কোনো ব্যবহারকারীকে বুকিংয়ের জন্য উপলব্ধ স্লটগুলো দেখানো হয় এবং তিনি কোনো একটি স্লটে ক্লিক করেন, তখন স্লট ক্লিকের জন্য BatchAvailabilityLookup রিকোয়েস্টটি কল করা হয়। | প্রতিক্রিয়াটি অবশ্যই স্লটটির বর্তমান ও প্রকৃত প্রাপ্যতা তুলে ধরবে। স্লটে ক্লিক করার আগেই যদি এটি বুক হয়ে যায়, তাহলে এটি অনুপলব্ধ বলে প্রতিক্রিয়া জানান। | POST /v3/ব্যাচ উপলভ্যতা লুকআপ/ |
CreateBooking | যখন কোনো ব্যবহারকারী বুকিং মডালে একটি নির্বাচিত টাইম স্লট বুক করার বিষয়টি নিশ্চিত করেন, তখন CreateBooking রিকোয়েস্টটি পাঠানো হয়। | প্রতিক্রিয়াটিতে বুকিংটির সাফল্য বা ব্যর্থতা অবশ্যই উল্লেখ থাকতে হবে। বুকিং ব্যর্থ হলে, ব্যর্থতার নির্দিষ্ট কারণটি জানাতে হবে। উদাহরণস্বরূপ, সফলভাবে একটি বুকিং তৈরি হলে, ভবিষ্যতের যেকোনো অনুরোধ বা আপডেটে বুকিংটি উল্লেখ করার জন্য রেসপন্সে একটি অনন্য | পোস্ট /v3/বুকিং তৈরি করুন/ |
UpdateBooking | Reserve with Google-এর মাধ্যমে বুকিং করার পর, একজন ব্যবহারকারী তার বুকিং পরিবর্তন করতে পারেন। যখন ব্যবহারকারী তার রিজার্ভেশন আপডেট করেন বা বাতিল করেন, তখন একটি UpdateBooking অনুরোধ পাঠানো হয়। | CreateBooking রেসপন্সের মতোই, UpdateBooking এর ক্ষেত্রেও আপনার রেসপন্স অবশ্যই বুকিংটির সাফল্য নির্দেশ করবে অথবা ব্যর্থতার নির্দিষ্ট কারণ উল্লেখ করবে। | পোস্ট /v3/আপডেটবুকিং/ |
HealthCheck | আপনার পরিকাঠামো সক্রিয় ও চালু আছে কিনা তা নিশ্চিত করতে অ্যাকশন সেন্টার আপনার বুকিং সার্ভারে নিয়মিত যোগাযোগ করে। | আপনার সার্ভারের পরিবেশন অবস্থা নির্দেশ করতে HTTP স্ট্যাটাস কোড ব্যবহার করুন। সার্ভারটি সক্রিয় এবং সফলভাবে চালু থাকলে HTTP স্ট্যাটাস কোড 200 রিটার্ন করুন। কোনো ত্রুটি নির্দেশ করতে বা আপনার ইন্টিগ্রেশনকে সাময়িকভাবে অফলাইনে নিতে, উপযুক্ত নন-2xx HTTP স্ট্যাটাস কোডটি রিটার্ন করুন। | GET /v3/HealthCheck/ |
মাইলফলক মানদণ্ড
'Booking Server Ready' মাইলস্টোনটি সম্পন্ন করতে, আপনার ইন্টিগ্রেশনকে স্যান্ডবক্স এবং প্রোডাকশন এনভায়রনমেন্টে নিম্নলিখিত শর্তগুলো পূরণ করতে হবে:
| পদ্ধতি | প্রয়োজনীয় সংখ্যক অনুরোধ (স্যান্ডবক্স) | প্রয়োজনীয় সংখ্যক অনুরোধ (উৎপাদন) | প্রয়োজনীয় সাফল্যের হার |
|---|---|---|---|
BatchAvailabilityLookup পৃষ্ঠা লোড | ২০ | ২০ | ৯০% |
BatchAvailabilityLookup স্লট ক্লিক | ২০ | ২০ | ৯০% |
CreateBooking | ১০ | ৩ | ৯০% |
UpdateBooking | ১০ | ৩ | ৯০% |
স্যান্ডবক্স বুকিং প্রবাহ
স্যান্ডবক্স বুকিং ফ্লো দেখতে, অ্যাকশনস সেন্টারের ইনভেন্টরি ভিউতে যান। ইনভেন্টরি ভিউয়ের RwG - E2E কলামটি সেইসব স্যান্ডবক্স মার্চেন্টদের জন্য স্যান্ডবক্স বুকিং ফ্লো-এর একটি লাইভ (স্যান্ডবক্সে) লিঙ্ক প্রদর্শন করে, যারা ম্যাচড এবং যাদের ভবিষ্যতে বুকিংয়ের সুযোগ রয়েছে।
বুকিং প্রক্রিয়ার ধাপগুলো নিচে দেওয়া হলো:
যখন আপনি RwG - E2E লিঙ্কে ক্লিক করেন, তখন পেজ লোড হওয়ার সাথে সাথে একটি
BatchAvailabilityLookupরিকোয়েস্ট চালু হয় এবং মার্চেন্টের জানা প্রাপ্যতা উপস্থাপন করে।আপনি যখন কোনো রিজার্ভেশনের সময়ে ক্লিক করেন, তখন এটি স্লট ক্লিকের অনুরোধের ক্ষেত্রে
BatchAvailabilityLookupসক্রিয় করে এবং বুকিং মডালটি প্রদর্শন করে।CreateBookingঅনুরোধটি পাঠাতে বুকিং মডাল ব্যবহার করে বুকিংটি সম্পূর্ণ করুন।স্যান্ডবক্স পরিবেশে বুকিং সম্পন্ন করার পর, বুকিংটি তৈরি করতে ব্যবহৃত অ্যাকাউন্টে বুকিংয়ের বিবরণসহ একটি নিশ্চিতকরণ ইমেল পাঠানো হয়।
UpdateBookingমেথডটি চালু করতে, ইমেল থেকে বুকিংটি পরিবর্তন বা বাতিল করুন।
স্বাস্থ্য পরীক্ষা
স্যান্ডবক্স এবং প্রোডাকশনে HealthCheck মেথডটি অবশ্যই প্রয়োগ করুন। এই মেথডটি আপনার বুকিং সার্ভারের স্বাস্থ্যগত অবস্থা ফেরত দেয়। এর মাধ্যমে গুগল আপনার বুকিং সার্ভারের পরিষেবা প্রদানের অবস্থা ক্রমাগত পর্যবেক্ষণ করতে পারে।
অনুরোধ : নেই
ফেরত মান : কিছুই না
আপনার সার্ভারের পরিবেশন অবস্থা নির্দেশ করতে HTTP স্ট্যাটাস কোড ব্যবহার করুন।
সার্ভারটি সক্রিয় এবং সফলভাবে চললে HTTP স্ট্যাটাস কোড 200 ফেরত দিন, অথবা কোনো ত্রুটি নির্দেশ করতে HTTP স্ট্যাটাস কোডগুলোর মধ্যে একটি ফেরত দিন।