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