نظرة عامة

يمكن لشركاء Google تقديم بيانات منظَّمة لقوائم الطعام إلى Google من خلال عملية التكامل الشاملة الخاصة بميزة "الحجز"، وذلك لاستخدامها في قسم قائمة الطعام ضمن الملف التجاري للمطعم على Google ونقاط دخول أخرى على مساحات عرض Google المخصّصة للمستهلكين.

يتم استيعاب بيانات القائمة باستخدام الخلاصات العامة. قبل البدء:

1. تأكَّد من إكمال إعداد الحساب.
2. التعرّف على عملية تحميل "الخلاصة العامة"
3. التعرّف على كيفية ضبط حسابك لتحميل الخلاصات العامة

المخطط

يمكنك الاطّلاع على مخطط القائمة الكامل هنا.

إنشاء خلاصات قوائم الطعام وتحميلها

عند إنشاء "خلاصات قوائم الطعام" وتحميلها، اتّبِع الإرشادات والاصطلاحات التالية:

• لتقديم تفاصيل المطعم، اتّبِع مواصفات البيانات الموضّحة في خلاصة التاجر. للاطّلاع على مثال لملف JSON، يُرجى الرجوع إلى نموذج JSON. يجب أن تكون أسماء ملفات البيانات فريدة بين عمليات التحميل. ننصحك بتضمين طابع زمني في اسم الملف، مثل menu1_1633621547.json
• في واصف مجموعة الملفات لخلاصة القائمة، اضبط الحقل name على google.food_menu. للاطّلاع على مثال على محتوى ملف الواصف، يمكنك الرجوع إلى نموذج JSON لملف الواصف. يجب أن تكون أسماء ملفات الواصف فريدة بين عمليات التحميل. ننصحك بتضمين طابع زمني في اسم الملف، مثلاً descriptor_1633621547.filesetdesc.json. يجب تحميل ملف الواصف إلى خادم SFTP العام كجزء من خلاصة قائمة الطعام.
• يجب تحميل الخلاصات إلى خادم SFTP العام بوتيرة يومية كتحديثات كاملة.
• يجب ألا تزيد الخلاصات عن 1,000 جزء (ملف) كما هو موضّح في استخدام بروتوكول نقل الملفات الآمن (SFTP) للخلاصة العامة.

يمكن الاطّلاع على حالة استيعاب الخلاصة في القسم الخلاصات > السجلّ في بوابة الشريك. يمكن العثور على معلومات خادم SFTP الخاص بالخلاصة في قسم الإعدادات > الخلاصات في "بوابة الشريك".

يمكن الاطّلاع على حالة استيعاب الخلاصة في القسم الخلاصات > السجلّ في "بوابة الشريك". يمكن العثور على معلومات خادم SFTP الخاص بالخلاصة في قسم الإعدادات > الخلاصات في "بوابة الشريك".

التعامل مع خيارات عناصر القائمة

يمكن تحديد خيارات عناصر القائمة باستخدام MenuItemOption proto.

على الشركاء الذين يقدّمون مجموعات متعدّدة من الخيارات المطلوبة لعنصر قائمة واحد (مثل قهوة لاتيه مع خيارات الحجم وخيارات الحليب) تحديد أفضل طريقة لعرض هذه الخيارات على Google. تنصح Google بما يلي:

• يجب أن تتطابق خلاصة قائمة الطعام مع الموقع الإلكتروني الخاص بالطلب لدى الشريك (أو قائمة الطعام في المطعم إذا لم يكن لديك موقع إلكتروني خاص بالطلب في الموقع الجغرافي). إذا كانت السلعة معروضة بسعر فردي على موقع الطلب، يجب استخدام MenuItem. إذا كان العنصر معروضًا بسعر أساسي وخيارات متعددة، يجب استخدام MenuItemOption.
• تجنَّب تضمين قائمة طويلة من الخيارات، على سبيل المثال:
  • بوريتو الدجاج
  • بوريتو دجاج مع الجبن
  • بوريتو دجاج مع صلصة
  • بوريتو دجاج مع صلصة وجبن
  • بوريتو دجاج مع "غواكامولي"
  • بوريتو دجاج مع غواكامولي وصلصة
• لا تتوفّر خيارات عناصر القائمة إلا إذا كان الطبق يتطلّب تحديد أحد الخيارات. على سبيل المثال، عند طلب بيتزا، يكون المقاس خيارًا مطلوبًا. لا تتوافق خيارات عناصر القائمة التي تخص الإضافات (مثل "خيار إضافة الأفوكادو") مع الخلاصات ويجب عدم تضمينها فيها.

يجب أن يكون سعر خيار صنف قائمة الطعام هو السعر الكامل للصنف مع تحديد هذا الخيار. يجب تحديد السعر لعنصر القائمة أو خياراته، ولكن ليس لكليهما.

المطاعم التي تتضمّن قوائم طعام متعدّدة

يمكن أن يكون للمطعم الواحد (الكيان) قائمة طعام واحدة فقط. بالنسبة إلى مطعم لديه قوائم متعددة (أي قوائم منفصلة للغداء والعشاء)، يمكنك دمج جميع القوائم في قائمة واحدة باستخدام MenuSections (أي قائمة واحدة تتضمّن قسمًا للغداء وقسمًا للعشاء). ستكون بنية القائمة الناتجة كما يلي:

• القائمة
• قسم الغداء
• حساء
• الحساء 1
• الحساء 2
• سندويتشات
• ساندويتش 1
• ساندويتش 2
• قسم العشاء
• المقبلات
• Starter 1
• Starter 2
• المقابس الرئيسية
• الطبق الرئيسي 1
• الطبق الرئيسي 2

مشاركة قوائم الطعام بين المطاعم

يمكن مشاركة قائمة طعام واحدة بين عدة مطاعم من خلال تضمين جميع المطاعم في قائمة merchant_ids الخاصة بقائمة الطعام. يُرجى العِلم أنّ هذه القائمة تقبل معرّفات الكيانات للشركاء الذين يستخدمون خلاصة الكيان.

أفضل الممارسات

في ما يلي أفضل الممارسات التي يجب اتّباعها عند تطوير خلاصات القوائم.

• يمكن ربط قائمة طعام واحدة فقط بمطعم.
• قدِّم اللغة المفضّلة كلغة أولى في TextField. في حال إرسال عناصر LocalizedText متعددة، سيتم عرض العنصر الأول في قائمة النصوص للمستخدمين.
• يجب إضافة جميع أصناف القائمة إلى أقسام القائمة. لا تُضِف عناصر القائمة مباشرةً إلى عنصر القائمة.
• قدِّم المحتوى باستخدام ترميز utf-8. ليس من الضروري استخدام حرف إلغاء مع الأحرف بتنسيق غير ascii.
• إذا كنت ستطلق تطبيقك في مناطق متعددة، تأكَّد من استخدام رموز العملات والقيم الصحيحة في الحقلَين units وnanos، مع إيلاء اهتمام خاص للحقل nanos الذي يمثّل 10^-9 من الوحدة. استخدِم "أداة عرض قائمة الأسعار" في عارض المستودع الإعلاني للتأكّد من أنّك ضبطت الأسعار بشكل صحيح.
• إنّ توفير قوائم غنية بالصور ووافية ومتجددة للمستخدمين هو أمر أساسي لتقديم تجربة مفيدة وجذابة. تُعدّ الأسعار والأوصاف والصور والمعلومات الغذائية من العناصر الأساسية التي تؤثر في عملية اتخاذ القرار، وننصح الشركاء بتقديم أكبر قدر ممكن من هذه البيانات لتوفير تجربة مثالية للمستخدمين والتجّار.

أدوات التطوير والاختبار

بعد إطلاق خلاصات قوائم الطعام، ستكون بيانات خلاصة قائمة الطعام مؤهّلة للظهور في تجارب الاستكشاف، وقد تظهر في علامة التبويب "قائمة الطعام" في ورقة معلومات المطعم. تتوفّر علامة التبويب الخاصة بقائمة الطعام على "بحث Google" (على الأجهزة الجوّالة وأجهزة الكمبيوتر)، وسيتم توسيع نطاق التجربة لتشمل مساحات عرض إضافية، بما في ذلك "خرائط Google". قد تختلف التجربة المعروضة حسب السطح.

لضمان تنظيم قائمة الطعام بشكل صحيح، استخدِم "أداة عرض قائمة الطعام" في عارض المستودع لمعاينة قوائم الطعام.

يمكن الحصول على قوائم الطعام من مصادر عديدة، بما في ذلك من المطاعم نفسها عبر ملفاتها التجارية على Google، ومن شركاء الحجوزات وطلبات الطعام، ومن صور المستخدمين لقوائم الطعام، وغير ذلك. إذا كانت مصادر متعدّدة تقدّم قوائم طعام للمطعم نفسه، يمكن للتاجر اختيار مقدّم خدمة مفضّل في محرر قائمة الطعام في "الملف التجاري على Google".