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