به روز رسانی در زمان واقعی آماده است

موجودی در سیستم شما به دلیل رزروهای جدید، لغوها و تغییرات برنامه زمانی از سوی تاجران شما تغییر می کند. API به‌روزرسانی بی‌درنگ (RTU) مکانیزمی است برای اطلاع Google در مورد این تغییرات و تغییرات ایجاد شده در رزروهای موجود.

RTU در موارد زیر مورد نیاز است:

  • زمانی که کاربر رزرو سیستم شما را لغو می کند و اسلات در دسترس می شود.
  • هنگامی که کاربر از طریق مرکز اقدامات رزرو رزرو می کند و جایگاه دیگر در دسترس نیست.
  • هنگامی که رزرو انجام شده از طریق مرکز اقدامات از طرف شما لغو می شود. یک وضعیت مثال شامل لغو مستقیم توسط تاجر است. باید رزرو و در دسترس بودن را به‌روزرسانی کنید، زیرا اسلات اصلی اکنون در دسترس است.

قبل از اینکه به بررسی Sandbox بروید، تکلیف نقطه عطف RTU زیر را کامل کنید:

هر کار تکمیل شده علامت گذاری می شود و زمانی که 20 درخواست آخر برای مدت 14 روز هیچ خطایی نداشته باشد سبز می شود. برای اطمینان از سبز ماندن نقطه عطف، به ارسال درخواست های موفق ادامه دهید.

API RTU و فیدها

API RTU به Google در مورد تغییرات افزایشی در دسترس بودن موجودی و رزرو به صورت هم‌زمان اطلاع می‌دهد. علاوه بر RTU، فیدهای دسترسی کامل را روزانه ارسال کنید. این تضمین می‌کند که Google دقیق‌ترین و آخرین اطلاعات در دسترس بودن را همانطور که در سیستم شما وجود دارد، دارد. فیدهای کامل به عنوان یک عکس فوری از آخرین وضعیت موجودی موجودی در سیستم شما عمل می کنند.

برای اطلاعات بیشتر به منابع زیر مراجعه کنید:

به API دسترسی داشته باشید

پروژه Google Cloud شما نحوه دسترسی شما به API رزرو نقشه‌های Action Center است، یعنی نحوه ارسال RTU. باید از یک حساب Google در کنسول Google Developers استفاده کنید و شماره پروژه Cloud خود را در نقطه عطف Setup برنامه ورود خود ارائه دهید. برای اطلاعات بیشتر در مورد نحوه فعال کردن Cloud API ها، به فعال کردن CloudAPIs مراجعه کنید.

از تماس‌های RESTful استفاده کنید یا کتابخانه مشتری را دانلود کنید

توصیه می‌کنیم با بارهای JSON مستقیماً با Maps Booking API تماس‌های RESTful برقرار کنید. برای اطلاعات بیشتر، به مستندات REST API مراجعه کنید.

همچنین می توانید از کتابخانه های سرویس گیرنده برای اتصال به API استفاده کنید.

.
زبان لینک دانلود
جاوا کتابخانه مشتری جاوا . برای اطلاعات بیشتر، دستورالعمل های سرویس گیرنده جاوا را ببینید

کتابخانه‌های پشتیبانی اضافی که مجوز و سایر جنبه‌های تماس با Google API را مدیریت می‌کنند، برای دانلود در دسترس هستند. برای اطلاعات بیشتر، به نمونه کد مراجعه کنید.

سند Discovery را واکشی کنید

برای برخی از کتابخانه‌های سرویس گیرنده، مانند Ruby، لازم است سند Discovery برای API که روش‌ها و پارامترهای آن را توضیح می‌دهد، واکشی شود.

برای واکشی سند Discovery از دستور زیر استفاده کنید:

curl -s -o mapsbooking_rest

https://mapsbooking.googleapis.com/$discovery/rest?version=v1alpha

برای اطلاعات بیشتر در مورد نحوه دسترسی به API از Ruby، Ruby API Client and Ruby Auth Library را ببینید.

تماس های مجاز با API برقرار کنید

وقتی با API تماس می‌گیرید، به آماده‌سازی برای برقراری تماس API واگذار شده برای مجوز دادن به حساب سرویس خود با کلید خصوصی و محدوده OAuth زیر مراجعه کنید:

https://www.googleapis.com/auth/mapsbooking

Sandbox و نقاط پایانی تولید

از طریق API می‌توانید با محیط‌های Sandbox و Production تماس بگیرید. مطمئن شوید که هر دو API را در پروژه Google Cloud خود فعال کرده اید. هر دو API از یک محدوده استفاده می کنند، اما نقاط پایانی متفاوتی دارند.

نقطه پایان تولید : https://mapsbooking.googleapis.com/

نقطه پایانی Sandbox : https://partnerdev-mapsbooking.googleapis.com/

در زیر مثالی در جاوا از نحوه تغییر نقاط پایانی آورده شده است:

 // This block of code is for OAuth and is the same for prod and sandbox.
    GoogleCredential
      .fromStream(new FileInputStream(...))
      .createScoped(Collections.singleton("https://www.googleapis.com/auth/mapsbooking"))

    // This block of code sets the endpoint. This is what you'd change to connect to the sandbox.
    new GoogleMapsBookingAPI.Builder(...)
      .setApplicationName(...)
      .setRootUrl("https://partnerdev-mapsbooking.googleapis.com/") // you add this to change the endpoint to use partnerdev.
      .build()