تتناول هذه المقالة عملية تفعيل واجهة برمجة التطبيقات Menu API في حسابك والدمج معها. في ما يلي نظرة عامة مفصّلة حول عملية الإعداد والمتطلبات الأساسية لإطلاق التطبيق. يُرجى الرجوع إلى هذه الصفحة عند التخطيط لجهود الدمج.
- الإعداد - ضبط الحساب والتخطيط لعملية التطوير.
- التطوير - تطوير خلاصة البيانات واختبارها.
- الإطلاق - تقييم البيانات قبل الإطلاق.
ضبط إعدادات الجهاز
في هذه المرحلة، من المهم التأكّد من أنّ حسابك على بوابة الشريك قد تم إعداده بالكامل وأنّه جاهز لقبول خلاصات البيانات ذات الصلة ببيانات القائمة الثابتة. إذا كان لديك عملية دمج نشطة حالية لإعادة توجيه OwG أو RwG تريد إضافة البيانات الوصفية للقوائم إليها، ستتم إعادة استخدام حسابك الحالي في عملية الدمج هذه. وفي حالات دمج OwG Direct على هذه المنصة أو في حال عدم الدمج على الإطلاق، يتم إنشاء حساب جديد ومشاركة تفاصيل الوصول عبر البريد الإلكتروني.
انتقِل إلى حسابك على بوابة الشريك وانتقِل إلى صفحة إعداد صندوق التحميل الضبط > الخلاصات. هناك صندوقا تحميل مرتبطان بدمج خلاصة بيانات القائمة: عامة والتجّار. يُرجى التحقق من أنّه تم ضبط مفتاح SSH العام في كلا صندوقَي التحميل. للحصول على مزيد من المعلومات حول طريقة ضبط مفاتيح SSH، يمكنك الاطّلاع على هذه الصفحة.
ويمكن أن يقبل صندوق التحميل العام خلاصات متنوعة يمكنها اتّباع مخططات بيانات مختلفة. يُطلَق على نوع الخلاصة
الذي يقبل بيانات القائمة المنظَّمة اسم google.food_menu،
ويكون عادةً مفعّلاً في حسابك في بداية عملية الإعداد. إذا حاولت إرسال خلاصة وظهرت رسالة الخطأ هذه: "تعذّرت معالجة الخلاصة. واجهنا مشكلة داخلية أثناء تحليل خلاصتك. لم يتم تفعيل "google.food_listing". يُرجى إصلاح الخطأ وإعادة المحاولة".، يُرجى التواصل مع جهة التواصل التي تتعامل معها في Google لتفعيل هذا النوع من الخلاصات.
أخيرًا، يُرجى الانتقال إلى صفحة الضبط > معلومات الاتصال والتأكّد من أنّ جميع تفاصيل الاتصال بك مُحدَّثة.
تطوير
تتضمن مرحلة التطوير الجزء الرئيسي من جهود التنفيذ، وهو إنشاء خلاصات البيانات واختبارها. يجب إنشاء خلاصات البيانات وإرسالها إلى صندوق التحميل الهدف كل يوم. من المتوقّع أن تبدأ معالجة الخلاصات المرسَلة في وضع الحماية في غضون ساعة بعد إرسالها. تتم معالجة خلاصات الإنتاج مرة واحدة يوميًا عند الساعة 12 ظهرًا بتوقيت المنطقة الزمنية بتوقيت المحيط الهادئ، ولا تتم معالجة سوى آخر خلاصة تم إرسالها. يُرجى الاطّلاع على مواصفات خلاصة البيانات والنماذج عند العمل على إنشاء خلاصاتك. مع أنّ المواصفات يتم تقديمها بتنسيق Protobuf، ننصح بتحميل ملفات الخلاصة بتنسيق JSON لأنّه من الأسهل تحديد المشاكل وحلّها. لهذا السبب، يتم أيضًا توفير عيّنات الخلاصة بتنسيق JSON.
يمكن اختبار ملف خلاصة بيانات واحد بسرعة باستخدام أداة مدقّق الخلاصة على الإنترنت التي تتحقّق من توافق هذا الملف مع المواصفات. تعرض الأداة ما إذا كان الملف يتطابق مع مخطط البيانات، وإذا لم يكن كذلك، ستعرض قائمة الأخطاء. لاختبار خلاصة البيانات بالكامل التي تتألف من ملفات متعدّدة، يُرجى تحميل هذه الخلاصة في بيئة وضع الحماية، وبعد اكتمال عملية النقل، يمكنك الاطّلاع على النتائج على بوابة الشريك. أثناء عرض الخلاصة، يتم تطبيق قواعد إضافية للتحقّق من الصحة لاختبار بعض منطق النشاط التجاري وجودة البيانات.
إطلاق
يمكن بدء مرحلة الإطلاق بعد اكتمال جميع عمليات الدمج وتُظهر خلاصة الإنتاج المخزون الكامل لقوائم الطعام بشكل صحيح.
متطلبات التشغيل الأساسية
ويجب استيفاء الشروط التالية لبدء عملية الدمج:
- تتم معالجة خلاصات البيانات في بيئة الإنتاج بدون أخطاء.
- تحتوي خلاصة بيانات الإنتاج على المستودع الكامل على مستوى عملية الدمج هذه في بداية عملية الدمج.
- تتطابق معظم بيانات التاجر مع المواقع الجغرافية على "خرائط Google".
- اجتازت خلاصات الإنتاج تقييم جودة البيانات.
- تستوفي عملية الدمج جميع سياسات "قائمة الطعام" ومتطلباتها.
تقييم البيانات
بعد نقل خلاصات بيانات الإنتاج بدون أخطاء، قد تكون هناك عملية داخلية لتقييم جودة بيانات القائمة. تهدف هذه العملية إلى رصد التعارضات في جودة البيانات، مثل المحتوى غير المرتبط بالطعام في أوصاف الأصناف، أو عدم تطابق أسماء الأصناف، والأسعار وغيرها. وفي حال حدوث ذلك، ستتم مشاركة الملاحظات مع فريق التطوير.