تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتناول هذه المقالة عملية تفعيل واجهة برمجة التطبيقات لقائمة الطعام في حسابك
والدمج معها. في ما يلي نظرة عامة تفصيلية حول عملية الإعداد
ومتطلبات الإطلاق. يُرجى الرجوع إلى هذه الصفحة عند التخطيط لجهود دمج
المحتوى.
الشكل 1:
عملية الإعداد
تتكون عملية الإعداد من ثلاث مراحل:
الإعداد: ضبط الحساب وتخطيط عملية التطوير
التطوير: تطوير خلاصة البيانات واختبارها
الإطلاق: تقييم البيانات قبل الإطلاق
ضبط إعدادات الجهاز
في هذه المرحلة، من المهم التأكّد من أنّ حسابك على بوابة الشركاء قد تم إعداده بالكامل وأصبح جاهزًا لقبول خلاصات البيانات ذات الصلة
ببيانات القائمة الثابتة. إذا كان لديك عملية دمج حالية ونشطة لإعادة التوجيه في "مواقع Google" أو RwG
تُضيف إليها البيانات الوصفية للقوائم، ستتم إعادة استخدام حسابك الحالي
لإجراء عملية الدمج هذه. في حال دمج OwG Direct
على هذه المنصة أو عدم الدمج على الإطلاق، يتم إنشاء حساب جديد
ويتم مشاركة تفاصيل الوصول عبر البريد الإلكتروني.
يُرجى الوصول إلى حسابك على بوابة الشركاء والانتقال إلى صفحة إعدادات الخلاصات
الإعداد > الخلاصات. هناك خادمان من بروتوكول النقل الآمن للملفات (SFTP) مرتبطان بدمج خلاصة بيانات القائمة:
عام والتجار. يُرجى التأكّد من أنّه تم ضبط
المفتاح العام لبروتوكول النقل الآمن (SSH) في كلٍّ من خادمَي بروتوكول النقل الآمن للملفات (SFTP). لمزيد من المعلومات حول كيفية ضبط مفاتيح SSH،
يُرجى الاطّلاع على
هذه الصفحة.
يمكن لـ
خادم SFTP العام
قبول خلاصات مختلفة يمكن أن تتّبع مخطّطات بيانات مختلفة. يُطلق على نوع الخلاصة
الذي يقبل بيانات القائمة المنظَّمة اسم google.food_menu، ويتم عادةً تفعيله لحسابك تلقائيًا في بداية عملية
الإعداد. في حال محاولة إرسال خلاصة وظهور رسالة الخطأ التالية:
"تعذّرت معالجة الخلاصة. واجهنا مشكلة داخلية أثناء تحليل
خلاصتك. لم يتم تفعيل google.food_menu. يُرجى إصلاح المشكلة وإعادة المحاولة"، يُرجى التواصل مع جهة التواصل المخصّصة لك في Google لتفعيل هذا النوع من الخلاصات.
أخيرًا، يُرجى الانتقال إلى صفحة
الإعداد > معلومات الاتصال
والتأكّد من أنّ جميع تفاصيل الاتصال محدّثة.
تطوير
تتضمّن مرحلة التطوير الجزء الرئيسي من جهد التنفيذ، وهو توليد خلاصات البيانات واختبارها. يجب إنشاء خلاصات البيانات ونقلها إلى خادم بروتوكول النقل الآمن للملفات (SFTP) المستهدَف يوميًا. من المتوقّع أن تبدأ عملية
معالجة الخلاصات التي تم إرسالها في غضون ساعة من إرسالها. يُرجى الرجوع إلى مواصفات
وعيّنات
خلاصة البيانات عند إنشاء خلاصاتك. على الرغم من أنّ المواصفات معروضة
بتنسيق protobuf، ننصحك بتحميل ملفات الخلاصة بتنسيق JSON، لأنّه
من الأسهل تحديد المشاكل وحلّها. لهذا السبب، يتم أيضًا تقديم
عيّنات الخلاصات
بتنسيق JSON.
يمكن اختبار ملف خلاصة بيانات واحد بسرعة باستخدام أداة أداة التحقّق من الخلاصة على الإنترنت التي تتحقّق مما إذا كان هذا الملف متوافقًا مع المواصفات. توضِّح الأدوات
ما إذا كان الملف يتطابق مع مخطّط البيانات، وإذا لم يكن الأمر كذلك، تُخرج
قائمة بالأخطاء. لاختبار خلاصة بيانات كاملة تتألف من
ملفات متعددة، حمِّل هذه الخلاصة في بيئة وضع الحماية، وبعد اكتمال عملية
نقل البيانات، اطّلِع على النتائج في بوابة الشركاء. أثناء نقل
الخلاصة، يتم تطبيق قواعد التحقّق الإضافية لاختبار بعض
منطق النشاط التجاري وجودة البيانات.
الشكل 2:
نتائج نقل الخلاصة
إطلاق
يمكن بدء مرحلة الإطلاق بعد اكتمال جميع أعمال الدمج و
أن تعرض خلاصة الإصدار العلني بشكل صحيح المستودع الكامل لقوائم طعام
المطعم.
متطلبات التشغيل
يجب استيفاء الشروط التالية لبدء عملية الدمج:
تتم معالجة خلاصات البيانات في بيئة الإنتاج بدون أي أخطاء.
تحتوي خلاصة بيانات الإصدار العلني على المستودع الإعلاني الكامل الذي يشمله هذا
الدمج في بداية عملية الدمج هذه.
تتطابق معظم بيانات التجّار مع المواقع الجغرافية في "خرائط Google".
بعد نقل خلاصات بيانات الإنتاج بدون أخطاء، قد تتم
عملية داخلية لتقييم جودة بيانات القائمة. تهدف هذه العملية
إلى العثور على أيّ تناقضات في جودة البيانات، مثل المحتوى غير المرتبط بالطعام
في أوصاف الأطباق، وعدم تطابق أسماء الأطباق وأسعارها وما إلى ذلك. وفي حال رصد أيّ
ملاحظات، ستتم مشاركة الملاحظات مع فريق التطوير.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis guide details the process for enabling and integrating with the Menu API, covering setup, development, and launch stages.\u003c/p\u003e\n"],["\u003cp\u003ePartners need to ensure their account is properly configured on the Partner Portal and that the \u003ccode\u003egoogle.food_menu\u003c/code\u003e feed type is enabled.\u003c/p\u003e\n"],["\u003cp\u003eDaily data feeds should be created and submitted, adhering to the provided specification, and validated using the online tool or sandbox environment.\u003c/p\u003e\n"],["\u003cp\u003eBefore launch, ensure data feeds are error-free in production, the full restaurant inventory is included, and data quality meets Google's standards.\u003c/p\u003e\n"],["\u003cp\u003eGoogle may conduct a data quality evaluation, providing feedback to developers on any inconsistencies found in the provided menu data.\u003c/p\u003e\n"]]],["The process involves three stages: Setup, Development, and Launch. Setup requires configuring the account in the Partner Portal, ensuring SSH keys are set for the Generic and Merchants dropboxes, and enabling the `google.food_menu` feed type. Development includes generating and testing daily data feeds (preferably in JSON), using the feed validator tool, and checking feed ingestion results. Launch requires error-free production feed processing, a complete restaurant menu inventory, merchant data matching with Google Maps locations, 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/waitlists/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/waitlists/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/waitlists/add-ons/add-menus/menus-feed)\nand\n[samples](/actions-center/verticals/reservations/waitlists/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/waitlists/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/waitlists/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/waitlists/partner-portal/inventory/merchant-matching) and [Matching guidelines](/actions-center/verticals/reservations/waitlists/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/waitlists/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."]]
