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