با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
این مقاله فرآیند فعال کردن API منو برای حساب شما و ادغام با آن را پوشش می دهد. در زیر یک نمای کلی از فرآیند ورود و پیش نیازهای راه اندازی ارائه شده است. لطفاً هنگام برنامه ریزی تلاش برای یکپارچه سازی به این صفحه مراجعه کنید.
شکل 1: فرآیند سوار شدن
فرآیند ورود شامل سه مرحله است:
راه اندازی - پیکربندی حساب و برنامه ریزی فرآیند توسعه.
توسعه - توسعه و آزمایش خوراک داده.
راه اندازی - ارزیابی داده ها قبل از راه اندازی.
راه اندازی
در این مرحله مهم است که تأیید کنید حساب شما در پورتال شریک کاملاً پیکربندی شده و آماده پذیرش فیدهای داده مربوط به داده های منوی ثابت است. اگر یک ادغام OwG Redirect یا RwG فعال دارید که در حال افزودن متادیتای منوها به آن هستید، از حساب موجود شما برای این ادغام مجددا استفاده خواهد شد. در مواردی که ادغام OwG Direct در این پلتفرم وجود دارد یا اصلاً ادغام نشده است، یک حساب کاربری جدید ایجاد می شود و جزئیات دسترسی از طریق ایمیل به اشتراک گذاشته می شود.
به حساب خود در پورتال شریک دسترسی داشته باشید و به صفحه پیکربندی فیدها Configuration > Feeds بروید. دو سرور SFTP مربوط به یکپارچه سازی فید داده منو وجود دارد: Generic و Merchants . لطفاً بررسی کنید که هر دو سرور SFTP دارای کلید عمومی SSH پیکربندی شده باشند. برای اطلاعات بیشتر در مورد نحوه پیکربندی کلیدهای SSH، به این صفحه مراجعه کنید.
سرور SFTP عمومی می تواند فیدهای مختلفی را بپذیرد که می توانند طرحواره های داده متفاوتی را دنبال کنند. نوع فید که داده‌های منوی ساختاریافته را می‌پذیرد، google.food_menu نام دارد و معمولاً در ابتدای ورود شما به‌طور پیش‌فرض برای حساب شما فعال می‌شود. در صورتی که سعی کنید فید ارسال کنید و این پیام خطا را مشاهده کنید - "پردازش فید انجام نشد. هنگام تجزیه فید شما با مشکل داخلی مواجه شدیم. "google.food_menu" فعال نیست. لطفاً رفع کنید و دوباره امتحان کنید." ، لطفاً برای فعال کردن این نوع فید با نقطه تماس Google خود تماس بگیرید.
در آخر، لطفاً به صفحه پیکربندی > اطلاعات تماس بروید و مطمئن شوید که تمام اطلاعات تماس شما به روز هستند.
توسعه
مرحله توسعه شامل بخش اصلی تلاش پیاده سازی - تولید و آزمایش فیدهای داده است. فیدهای داده باید هر روز ایجاد و به سرور SFTP هدف ارسال شوند. انتظار می‌رود فیدهای ارسالی ظرف یک ساعت پس از ارسال، پردازش شوند. هنگام کار بر روی تولید فیدهای خود به مشخصات فید داده و نمونه ها مراجعه کنید. اگرچه مشخصات در فرمت protobuf ارائه شده است، توصیه می کنیم فایل های فید را با فرمت JSON آپلود کنید، زیرا عیب یابی آسان تر است. به همین دلیل نمونه های خوراک نیز در قالب JSON ارائه می شوند.
یک فایل خوراک داده را می توان به سرعت با استفاده از ابزار اعتبارسنجی آنلاین فید آزمایش کرد که تأیید می کند آیا آن فایل با مشخصات مطابقت دارد یا خیر. این ابزار نشان می دهد که آیا فایل با طرح داده مطابقت دارد یا خیر و اگر نه - لیست خطاها را خروجی می دهد. برای آزمایش کل فید داده که از چندین فایل تشکیل شده است، آن فید را در محیط sandbox آپلود کنید و پس از تکمیل پردازش، نتایج را در پورتال شریک مشاهده کنید. در طول مصرف خوراک، قوانین اعتبار سنجی اضافی برای آزمایش برخی منطق تجاری و کیفیت داده ها اعمال می شود.
شکل 2: نتایج مصرف خوراک
راه اندازی کنید
مرحله راه‌اندازی را می‌توان پس از اتمام کار یکپارچه‌سازی آغاز کرد و خوراک تولید به درستی کل موجودی منوهای رستوران را منعکس کرد.
پیش نیازهای راه اندازی
برای راه اندازی ادغام باید این شرایط رعایت شود:
فیدهای داده در محیط تولید با 0 خطا پردازش می شوند.
فید داده های تولید شامل موجودی کاملی است که برای این یکپارچه سازی در شروع این یکپارچه سازی در نظر گرفته شده است.
بیشتر داده‌های تاجر شما با مکان‌های Google Maps مطابقت دارد.
فیدهای تولیدی ارزیابی کیفیت داده را پشت سر گذاشتند.
پس از دریافت خوراک داده های تولید بدون خطا، ممکن است یک فرآیند داخلی برای ارزیابی کیفیت داده های منو وجود داشته باشد. هدف این فرآیند یافتن ناسازگاری‌ها در کیفیت داده‌ها، مانند محتوای غیر مرتبط با مواد غذایی در توضیحات ظرف، عدم تطابق در نام غذا، قیمت‌ها و غیره است. در صورت چنین یافته‌هایی، بازخورد با تیم توسعه به اشتراک گذاشته می‌شود.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis article guides you through enabling and integrating with the Menu API, covering setup, development, and launch stages.\u003c/p\u003e\n"],["\u003cp\u003eAccount setup involves configuring dropboxes for data feeds and ensuring restaurant information is accurate.\u003c/p\u003e\n"],["\u003cp\u003eDevelopment focuses on creating and testing data feeds according to specifications, using provided tools for validation.\u003c/p\u003e\n"],["\u003cp\u003eLaunch requires error-free production data, complete inventory, merchant data matching, passing data quality evaluation, and adherence to policies.\u003c/p\u003e\n"],["\u003cp\u003eData evaluation assesses the quality of menu content and provides feedback on potential inconsistencies.\u003c/p\u003e\n"]]],["The menu API onboarding process involves three stages: Setup, Development, and Launch. Setup requires configuring the Partner Portal account and ensuring SSH keys are set up for the Generic and Merchants dropboxes. Development involves creating and testing daily data feeds, using JSON format and a feed validator. Launch requires error-free production feed processing, full inventory coverage, and high-quality data, which undergoes evaluation for accuracy and compliance with food menu policies.\n"],null,["# Onboarding process\n\nThis article covers the process of enabling the menu API for your account and\nintegrating with it. Below is a detailed overview of the onboarding process\nand launch prerequisites. Please reference this page when planning the\nintegration effort.\n\n\n**Figure 1:** Onboarding process\n\n\u003cbr /\u003e\n\nThe onboarding process consists of three stages:\n\n1. Setup - account configuration and planning of the development process.\n2. Development - data feed development and testing.\n3. Launch - data evaluation before the launch.\n\nSetup\n-----\n\n\nOn this stage it is important to confirm that your account on [Partner Portal](https://partnerdash.google.com/apps/reservewithgoogle) is fully configured and ready to accept data feeds relevant\nfor static menu data. If you have an existing active OwG Redirect or RwG\nintegration to which you are adding the menus metadata, then your existing\naccount will be reused for this integration. In cases with OwG Direct\nintegration on this platform or no integration at all, a new account is\ncreated and the access details are shared over email.\n\n\nAccess your account on the [Partner Portal](https://partnerdash.google.com/apps/reservewithgoogle) and navigate to the feeds\nconfiguration page\n[Configuration \\\u003e Feeds](https://partnerdash.google.com/apps/reservewithgoogle/configuration/feeds). There are two SFTP servers relevant for menu data feed integration:\n**Generic** and **Merchants** . Please check that both SFTP servers have the\nSSH public key configured. For more information on how to configure SSH keys,\nsee\n[this page](/actions-center/verticals/reservations/e2e/integration-steps/setup).\n| **Note:** If your account has an active OwG Redirect or RwG integration, the Entity feed or Merchants should be already fully implemented for that integration. Ensure that all restaurants in the menu feed are listed in the Entity feed or Merchants feed.\n\n\nThe\n[Generic SFTP server](/actions-center/verticals/reservations/e2e/add-ons/add-menus/generic-sftp)\ncan accept various feeds that can follow different data schemas. The feed type\naccepting structured menu data is named `google.food_menu` and it\nis usually enabled for your account by default at the start of your\nonboarding. In case you attempt to submit a feed and see this error message -\n*\"Feed processing failed. We ran into an internal problem while parsing your\nfeed. 'google.food_menu' is not enabled. Please fix and try again.\"*, please reach out to your Google point of contact to enable this feed type.\n\n\nLastly, please navigate to the\n[Configuration \\\u003e Contact Information](https://partnerdash.google.com/apps/reservewithgoogle/contactinformation)\npage and make sure all your contact details are up to date.\n\nDevelopment\n-----------\n\n\nThe development stage contains the main part of the implementation effort -\ngenerating and testing the data feeds. Data feeds have to be created and\nsubmitted to the target SFTP server every day. Feeds submitted are expected to start\nprocessing within an hour after submission. Refer to the data feed\n[specification](/actions-center/verticals/reservations/e2e/add-ons/add-menus/menus-feed)\nand\n[samples](/actions-center/verticals/reservations/e2e/add-ons/add-menus/menus-feed#samples)\n\nwhen working on generating your feeds. Although the specification is presented\nin protobuf format, we recommend uploading feed files in JSON format, because\nit is easier to troubleshoot. For that reason the\n[feed samples](/actions-center/verticals/reservations/e2e/add-ons/add-menus/menus-feed)\nare also provided in JSON format.\n\n\nOne data feed file can be tested quickly using the\n[feed validator](/actions-center/verticals/reservations/e2e/add-ons/add-menus/menu-feed-validator)\nonline tool that verifies if that file corresponds to the specification. The\ntool shows whether the file matches the data schema and if not - it outputs\nthe list of errors. In order to test an entire data feed that consists of\nmultiple files, upload that feed in the sandbox environment and after the\ningestion is completed, see the results on the [Partner Portal](https://partnerdash.google.com/apps/reservewithgoogle). During the\nfeed ingestion there are additional validation rules applied to test some\nbusiness logic and the quality of data.\n\n\n**Figure 2:** Feed ingestion results\n\n\u003cbr /\u003e\n\n| **Note:** The `google.food_menu` feed relies on the Merchants or Entity feed in order to associate the menu with the right restaurant. The Entity or Merchant must be correctly matched to a location on Google. For more details see [Merchant Matching and Testing](/actions-center/verticals/reservations/e2e/partner-portal/inventory/merchant-matching) and [Matching guidelines](/actions-center/verticals/reservations/e2e/partner-portal/inventory/merchant-matching-guidelines) articles.\n\nLaunch\n------\n\n\nThe launch stage can be initiated after all integration work is complete and\nthe production feed reflects correctly the entire inventory of restaurant\nmenus.\n\n### Launch prerequisites\n\nThese conditions have to be met for the integration to launch:\n\n- Data feeds are processed in production environment with 0 errors.\n- The production data feed contains the full inventory scoped for this integration at the start of this integration.\n- The majority of your merchant data matches with Google Maps locations.\n- The production feeds passed data quality evaluation.\n- The integration meets all [Food Menu Policies and Requirements](/actions-center/verticals/reservations/e2e/policies/integration-policies#food-menu-policy).\n\n### Data evaluation\n\n\nAfter the production data feeds are being ingested without errors, there may\nbe an internal process to evaluate the quality of menu data. This process aims\nto find inconsistencies in the data quality, such as non food related content\nin dish descriptions, mismatch in dish names, prices etc. In case of such\nfindings the feedback will be shared with the development team."]]
