شما به یک سرور رزرو نیاز دارید تا به مرکز عملیات اجازه دهید از طرف شما فراخوانیهای لازم را برای ایجاد و بهروزرسانی رزروها انجام دهد. این به مرکز عملیات اجازه میدهد تا از طرف کاربر، قرار ملاقاتها، رزروها و نوبتها را با شما ایجاد کند.
برای یادگیری نحوه پیکربندی اتصال به سرورهای Sandbox و Production Booking خود، به پیکربندی اعتبارنامههای سرور Booking مراجعه کنید.
قبل از رفتن به بهروزرسانیهای بلادرنگ، وظایف آمادهسازی سرور رزرو زیر را انجام دهید:
- بارگذاری صفحه BatchAvailabilityLookup آماده است
- کلیک روی اسلات BatchAvailabilityLookup آماده
- آماده برای ایجاد رزرو
- بهروزرسانیرزرو آماده است
- فعال کردن بررسیکنندهی در دسترس بودن در تنظیمات حساب کاربری در مرکز عملیات
هر وظیفه تکمیلشده علامتگذاری میشود و وقتی جزئیات موجودی دقیق و بلادرنگ را از طریق جریان رزرو Sandbox به درخواستهای سرور رزرو ارسال میکنید، سبز میشود. نقاط عطف سرور رزرو در یک دوره ۱۴ روزه تجزیه و تحلیل میشوند.
پیادهسازی رابط REST API
یک رابط API مبتنی بر REST پیادهسازی کنید. این به گوگل اجازه میدهد درخواستهای سرور رزرو را از طریق HTTPS ارسال کند.
برای پیادهسازی رابط API، یک سرور توسعه یا رزرو سندباکس راهاندازی کنید که به محیط اکشن سنتر سندباکس متصل شود. تنها پس از آزمایش کامل سرور سندباکس، به محیط تولید منتقل شوید.
تمام درخواستهای سرور رزرو گوگل نسبت به URL سرور رزرو تنظیم شده در صفحه سرور رزرو هستند. برای مثال، اگر URL شما روی api.example.com/google تنظیم شده باشد، تمام درخواستهای HealthCheck به api.example.com/google/v3/HealthCheck ارسال میشوند.
مطمئن شوید که نقطه پایانی صحیح Booking Server برای هر دو محیط Sandbox و Production با استفاده از تعویضکننده محیط پیکربندی شده است.
امنیت و احراز هویت
تمام ارتباطات با سرور رزرو شما از طریق HTTPS و با استفاده از احراز هویت اولیه انجام میشود. برای کمک به راهاندازی سرورتان، توصیه میکنیم از یک ابزار تأیید SSL یا TLS که در دسترس عموم است، مانند تست سرور SSL شرکت Qualys ، استفاده کنید.
تمام درخواستهایی که گوگل به سرور رزرو شما ارسال میکند، با احراز هویت پایه HTTPS تأیید میشوند. میتوانید اطلاعات احراز هویت پایه، رمز عبور و نام کاربری سرور رزرو خود را در صفحه پیکربندی سرور رزرو در مرکز عملیات وارد کنید. اعتبارنامهها باید هر شش ماه یکبار تغییر کنند.
سرور رزرو خود را بسازید
سرور رزرو، نحوهی ارتباط یکپارچهسازی با سیستم شما و ایجاد یا بهروزرسانی رزروها را تعیین میکند. برای پیکربندی اتصال به سرورهای رزرو Sandbox و Production، به بخش پیکربندی اعتبارنامههای سرور رزرو مراجعه کنید.
انتظار میرود هر پاسخی که سرور رزرو شما به درخواستی از Reserve with Google میدهد، حاوی جزئیات موجودی دقیق و بلادرنگ باشد. جدول زیر روشهای هر پیادهسازی را نشان میدهد و شامل پیوندهایی به قالبهای پروتکل سرویس است:
| روش | تعریف | پاسخ | درخواست HTTP |
|---|---|---|---|
بارگیری صفحه BatchAvailabilityLookup | وقتی کاربر روی «رزرو میز برای فروشنده» کلیک میکند، درخواست این محتوا شامل تعداد زیادی اسلات است که بر اساس آخرین آپلودهای فید شما تنظیم شدهاند و Reserve with Google آنها را در دسترس میداند. | پاسخ باید شامل هر درخواست اسلات و وضعیت فعلی اسلات باشد. این کار از نمایش اسلاتهای ناموجود جلوگیری میکند. | POST /v3/BatchAvailabilityLookup/ |
کلیک اسلات BatchAvailabilityLookup | وقتی به کاربر اسلاتهای موجود برای رزرو نمایش داده میشود و روی یک اسلات کلیک میکند، درخواست BatchAvailabilityLookup برای کلیک اسلات فراخوانی میشود. | پاسخ باید نشاندهندهی موجود بودن فعلی و واقعی اسلات باشد. اگر قبل از کلیک روی اسلات، آن اسلات رزرو شده باشد، پاسخی مبنی بر موجود نبودن آن اسلات را برگردانید. | POST /v3/BatchAvailabilityLookup/ |
CreateBooking | وقتی کاربری تأیید میکند که میخواهد یک بازه زمانی انتخابشده را در ماژول رزرو رزرو کند، درخواست CreateBooking ارسال میشود. | پاسخ باید نشان دهنده موفقیت یا عدم موفقیت رزرو باشد. اگر رزرو ناموفق بود، باید دلیل خاص عدم موفقیت را برگردانید. برای مثال، قبل از فراخوانی پاسخ اگر رزرو با موفقیت انجام شود، پاسخ شامل یک | پست /v3/ایجاد رزرو/ |
UpdateBooking | پس از انجام رزرو از طریق رزرو با گوگل، کاربر میتواند رزرو خود را تغییر دهد. وقتی کاربر رزرو خود را بهروزرسانی یا لغو میکند، یک درخواست UpdateBooking ارسال میشود. | همانند پاسخ CreateBooking ، پاسخ شما به UpdateBooking باید نشاندهنده موفقیت رزرو یا دلیل خاص شکست باشد. | پست /v3/UpdateBooking/ |
HealthCheck | مرکز عملیات (Actions Center) مرتباً با سرور رزرو شما تماس میگیرد تا فعال و در حال اجرا بودن زیرساخت شما را تأیید کند. | از کد وضعیت HTTP برای نشان دادن وضعیت سرویسدهی سرور خود استفاده کنید. اگر سرور فعال و با موفقیت در حال اجرا است، کد وضعیت HTTP 200 را برگردانید. برای نشان دادن خطا یا غیرفعال کردن موقت یکپارچهسازی، کد وضعیت HTTP غیر 2xx مناسب را برگردانید. | دریافت /v3/بررسی سلامت/ |
معیارهای مهم
برای تکمیل مرحلهی آمادهسازی سرور رزرو، ادغام شما باید معیارهای زیر را در محیطهای Sandbox و Production داشته باشد:
| روش | تعداد درخواستهای مورد نیاز (سندباکس) | تعداد درخواستهای مورد نیاز (تولید) | میزان موفقیت مورد نیاز |
|---|---|---|---|
بارگیری صفحه BatchAvailabilityLookup | ۲۰ | ۲۰ | ۹۰٪ |
کلیک اسلات BatchAvailabilityLookup | ۲۰ | ۲۰ | ۹۰٪ |
CreateBooking | ۱۰ | ۳ | ۹۰٪ |
UpdateBooking | ۱۰ | ۳ | ۹۰٪ |
جریان رزرو سندباکس
برای مشاهده جریان رزرو Sandbox، به نمای موجودی مرکز عملیات بروید. ستون RwG - E2E از نمای موجودی، یک پیوند زنده (در Sandbox) به جریان رزرو Sandbox را برای بازرگانان Sandbox که مطابقت دارند و در آینده در دسترس خواهند بود، نمایش میدهد.
اقدامات زیر در جریان رزرو انجام میشود:
وقتی روی لینک RwG - E2E کلیک میکنید، یک درخواست
BatchAvailabilityLookupدر هنگام بارگذاری صفحه اجرا میشود و موجودی شناختهشدهی فروشنده را نمایش میدهد.وقتی روی یک زمان رزرو کلیک میکنید، درخواست کلیک روی اسلات
BatchAvailabilityLookupرا فعال میکند و پنجرهی رزرو را نمایش میدهد.برای ارسال درخواست
CreateBookingیک رزرو را با استفاده از ماژول رزرو تکمیل کنید.پس از تکمیل رزرو در محیط Sandbox، حسابی که برای ایجاد رزرو استفاده شده است، یک ایمیل تأیید حاوی جزئیات رزرو دریافت میکند.
برای فعال کردن متد
UpdateBooking، رزرو را از طریق ایمیل تغییر دهید یا لغو کنید.
بررسی سلامت
مطمئن شوید که متد HealthCheck در محیط Sandbox و محیط Production پیادهسازی کردهاید. این متد وضعیت سلامت سرور رزرو شما را برمیگرداند. این متد به گوگل اجازه میدهد تا به طور مداوم وضعیت سرویسدهی سرور رزرو شما را رصد کند.
درخواست : هیچکدام
مقدار بازگشتی : هیچکدام
از کد وضعیت HTTP برای نشان دادن وضعیت سرویسدهی سرور خود استفاده کنید.
اگر سرور فعال است و با موفقیت اجرا میشود، کد وضعیت HTTP 200 را برگردانید، یا برای نشان دادن خطا، یکی از کدهای وضعیت HTTP را برگردانید.