مروری بر فیدها

این بخش جزئیات بیشتری در مورد 3 قطعه اصلی ادغام با Action Center ارائه می دهد. شما از هر یک از این موارد در مراحل ذکر شده در راهنمای End-to-End استفاده خواهید کرد.

تغذیه می کند

فیدها فایل هایی با فرمت JSON یا pb3 هستند که برای انتقال داده های موجودی شما به Action Center استفاده می شوند. این به شما امکان می دهد تمام داده های خود را به یکباره ارسال کنید تا با استفاده از آپلود SFTP، بازرگانان، خدمات و اسلات های موجود را به روز کنید.

Maps Booking API

Maps Booking API به شما امکان می‌دهد تا اشیاء را در سیستم Action Center بین ارسال‌های فید به‌روزرسانی کنید تا اطلاعات را به‌روز نگه دارید. API همچنین به شما امکان می‌دهد رزروهایی را که از طریق Reserve with Google یکپارچه‌سازی سرتاسر انجام می‌شوند لغو کنید.

به روز رسانی های زمان واقعی با استفاده از تماس های REST اجرا می شوند.

توجه: به‌روزرسانی‌های زمان واقعی به ندرت برای ادغام‌های شروع کننده قابل اجرا هستند. برای ادغام اولیه، ممکن است Maps Booking API را نادیده بگیرید.

توجه: برخی از یکپارچه‌سازی‌های قدیمی موجود از تماس‌های RPC استفاده می‌کنند. این هنوز حفظ می شود اما نباید برای ادغام های جدید استفاده شود.

سرور رزرو

برای اینکه ادغام سرتاسر مرکز اقدامات بتواند رزروهایی را از طرف شما ایجاد کند، باید یک سرور رزرو تنظیم کنید.

توجه: این برای ادغام های شروع کننده قابل اجرا نیست.

REST API

نسخه v3 آخرین نسخه API است و از یک رابط مبتنی بر REST پشتیبانی می کند. همه ادغام های جدید باید از v3 API استفاده کنند.

این بخش فایل های فید مورد استفاده برای انتقال داده های موجودی شما به Action Center را مشخص می کند. محتویات فیدهای شما مشخص می کند که چه خدماتی ارائه می کنید، چه خدماتی در دسترس هستند و چه زمانی خدمات در دسترس هستند.

آکاردئون References and Samples را بررسی کنید تا یاد بگیرید که چگونه این فیدها را با ما به اشتراک بگذارید.

ساختار فیدهای موجودی توسط Google Maps Booking API تعریف شده است.

فید زیر برای هر ادغام اجباری است:

• فید بازرگانان : حاوی داده‌هایی است که بازرگانان شما را توصیف می‌کند.

علاوه بر این، 2 فید زیر برای ادغام انتها به انتها اجباری هستند.

• فید خدمات : خدمات ارائه شده توسط بازرگانان شما را شرح می دهد.
• فید در دسترس بودن : اسلات در دسترس بودن خدمات ارائه شده توسط تاجران شما را فهرست می کند.

توجه: همه فیدها باید با processing_instruction PROCESS_AS_COMPLETE آپلود شوند. PROCESS_AS_INCREMENTAL منسوخ شده است و قابل استفاده نیست.

برخی از فیلدها در این فیدها ضروری و برخی اختیاری هستند. هر فیلدی که به‌عنوان اختیاری علامت‌گذاری شده است را می‌توان در صورت خالی بودن از فید خارج کرد.

قالب فیدها با استفاده از دستور پروتکل بافر 3 توضیح داده شده است. شما این امکان را دارید که فایل فیدها را به صورت سریال سازی باینری از داده های بافر پروتکل در قالب pb3 یا در قالب JSON مشتق شده آپلود کنید. توصیه می کنیم فیدها را با فرمت JSON آپلود کنید.

توصیه می کنیم از gzip برای فشرده سازی فیدها قبل از آپلود استفاده کنید.

این راهنما مختص بافرهای پروتکل Action Center است. برای اطلاعات کلی در مورد نحوه استفاده از بافرهای پروتکل برای تولید یک فایل pb3، در اینجا یک مثال در جاوا آورده شده است .