توفّر الخلاصات بيانات المستودع إلى "مركز الإجراءات". يؤدي تحميل بروتوكول النقل الآمن للملفات (SFTP) اليومي إلى تعديل جميع بيانات التجّار والخدمات وفترات التوفّر. تحدّد الخلاصات التجّار الذين تتعامل معهم ومدى توفّرهم وأي ميزات خاصة مطلوبة للتأكّد من أنّ Google تعرض مستودعك بشكل صحيح. يتم تحميل الخلاصات إلى صناديق تحميل SFTP التي تم ضبطها عند تقديم مفتاح SSH في الإعداد.
يجب إكمال مهام "الخلاصات جاهزة" التالية قبل الانتقال إلى "خادم الحجز":
سيتم وضع علامة "مكتملة" على المهام وتغيير لونها إلى الأخضر بعد تحميل خلاصاتك بنجاح. راجِع المستندات المرتبطة لإكمال كل مهمة محددة من مهام مراحل التطوير.
لضمان عمل عملية الدمج الشاملة الخاصة بميزة "حجوزات المطاعم" بشكل سليم، عليك توفير عمليات تحميل تلقائية يومية لخلاصة التجّار وخلاصة الخدمات وخلاصة بيانات التوفّر. يجب أن توفّر البنية الأساسية للخلاصة المبرمَجة مستودعك الإعلاني الكامل.
أنواع الخلاصات
تتطلّب عمليات الدمج الشاملة في "حجوزات المطاعم" الخلاصات التالية ومعدّلات تحميلها:
| الخلاصة | الوصف | معدّل التكرار | عيّنة |
|---|---|---|---|
| التاجر | تصف هذه السمة التجّار. | مرة واحدة كل 24 ساعة | مثال على خلاصة التاجر |
| خدمات | صِف خدمات التجّار. | مرة واحدة كل 24 ساعة | مثال على خلاصة الخدمات |
| مدى التوفّر | تصف هذه السمة الفترات الزمنية المتاحة لخدمات التجّار. يجب توفير تغطية لمدة 30 يومًا على الأقل. لتمديد فترة التغطية إلى 90 يومًا، يُرجى التواصل مع فريق دعم Google من خلال نموذج التواصل في "مركز الإجراءات". | مرة واحدة كل 24 ساعة | نموذج خلاصة بيانات التوفّر |
يتم وصف تنسيقات الخلاصات باستخدام بنية بروتوكول المخزن المؤقت 3، ولكن يمكنك تحميل خلاصاتك وفقًا لتنسيق JSON المناسب. راجِع نماذج الخلاصة للاطّلاع على تنسيق JSON. ننصحك بتحميل الخلاصات بتنسيق JSON.
اصطلاحات التسمية والبيانات الوصفية
أسماء الملفات
في حال استخدام التقسيم، يجب أن تتضمّن الخلاصات التي تحمّلها أسماء فريدة تحدّد نوع الخلاصة وعددها. يستوفي الطابع الزمني لإنشاء الخلاصة شرط التفرد في تسمية ملف الخلاصة.
البنية: {feed_name}_{timestamp_epoch}_{shard_nunber}_{total_shard}.json
مثال: availability_feed_1574117613_001_of_002.json.gz
تحديد أرقام التعريف
عند تحديد أرقام تعريف للتجّار أو سمات أخرى تتطلّب رقم تعريف، ننصحك بشدة باستخدام أرقام تعريف UID أو UUID. يمكنك تقديم حلّ أبجدي رقمي خاص بك طالما أنّ المعرّفات تظل مميّزة على مستوى منصّتك.
البيانات الوصفية
عند إنشاء خلاصات، يجب أن يشير generation_timestamp إلى الوقت الذي تم فيه سحب البيانات من قاعدة البيانات. قد يؤدي إعادة استخدام هذه القيمة في خلاصات متعددة إلى حدوث أخطاء في المعالجة.
يجب أن تكون قيم الأرقام العشوائية أو غير المتكرّرة فريدة في جميع أنواع الخلاصات، ولا يمكن إعادة استخدامها. يجب أن تتطابق القيمة مع جميع الملفات في الخلاصة المقسّمة المحدّدة.
حجم ملف الخلاصة
تقسيم ملفات الخلاصة
استنادًا إلى مستودعك، قد يكون من الضروري تقسيم الخلاصات إلى عدّة ملفات. قد تحتاج خلاصاتك إلى التقسيم في الحالات التالية:
- تتجاوز خلاصة gzip المضغوطة 200 ميغابايت لملف واحد.
- مثال: حجم خلاصة بيانات التوفّر التي تم إنشاؤها هو 1 غيغابايت. يجب تقسيم هذا الجدول إلى خمسة أجزاء منفصلة أو أكثر.
- يتم توزيع مستودع الشريك على مستوى أنظمة أو مناطق مختلفة، ما يؤدي إلى صعوبة في مطابقة المستودع.
- مثال: يملك الشريك مستودعًا إعلانيًا في الولايات المتحدة والاتحاد الأوروبي، ويتم تخزين هذا المستودع في أنظمة منفصلة.
قد يتم إنشاء الخلاصة باستخدام جزأين. أحدهما للولايات المتحدة والآخر للاتحاد الأوروبي، مع استخدام قيمة nonce و
generation_timestampنفسها.
- مثال: يملك الشريك مستودعًا إعلانيًا في الولايات المتحدة والاتحاد الأوروبي، ويتم تخزين هذا المستودع في أنظمة منفصلة.
قد يتم إنشاء الخلاصة باستخدام جزأين. أحدهما للولايات المتحدة والآخر للاتحاد الأوروبي، مع استخدام قيمة nonce و
لمزيد من المعلومات، يُرجى الاطّلاع على برامج تعليمية وأفضل الممارسات لتقسيم ملفات الخلاصة.
يمكن أن تتضمّن الخلاصة ملفات متعددة تُعرف باسم أجزاء. لتحديد حجم الخلاصات، اتّبِع الإرشادات التالية:
- تقسيم الخلاصة المقترَح:
- خلاصة التاجر: جزء واحد
- خلاصة الخدمات: جزء واحد
- خلاصة بيانات مدى التوفّر: أقل من 20 جزءًا إذا كان لديك مبرّر تجاري يتطلّب مبلغًا أكبر من المبلغ المحدّد، يُرجى التواصل مع فريق الدعم للحصول على مزيد من التعليمات.
- حجم ملفات الخلاصة وتقسيمها:
- يجب أن يكون حجم ملف التقسيم أقل من 200 ميغابايت بعد الضغط. استخدِم عدة أجزاء إذا لزم الأمر.
- لا يلزم إرسال السجلات الفردية التي تم إرسالها في جزء واحد ضمن الجزء نفسه في الخلاصات المستقبلية.
- للحصول على أداء أفضل، قسِّم البيانات بالتساوي بين الأجزاء لجعل أحجام جميع ملفات الأجزاء متشابهة.
- استخدِم gzip لضغط خلاصات JSON النصية العادية لكل جزء من الخلاصات الفردية، إذا لزم الأمر.
ضغط ملفات الخلاصة
يمكن ضغط أي ملف JSON أو PB3 باستخدام gzip قبل التحميل. ويمكن أن يؤدي ذلك إلى تقليل حجم البايت في الخلاصات اليومية بشكل كبير.
يجب ضغط كل ملف جزء باستخدام gzip وتحميله بشكل فردي، مثل gzip*.json. يجب أن تنتهي أجزاء الخلاصة المضغوطة بالامتداد .json.gz أو .pb3.gz.
تحميل الخلاصات إلى صندوق تحميل SFTP
بعد إنشاء خلاصات التاجر والخدمة ومعلومات التوفّر، يمكنك تحميل خلاصاتك إلى بيئة وضع الحماية أو بيئة الإنتاج من خلال صندوق الإيداع عبر بروتوكول النقل الآمن للملفات (SFTP). يتم إعداد صندوق التحميل عبر بروتوكول SFTP عند تقديم مفتاح SSH في عملية الإعداد.
يتوفّر خادم بروتوكول SFTP من Google على sftp://partnerupload.google.com على المنفذ 19321.
تراجع Google ملفات الخلاصات وتتحقّق من صحتها فور تحميلها إلى صندوق التحميل عبر SFTP. إذا تم تقسيم الخلاصة إلى عدة ملفات، ستتم معالجتها بعد تحميل آخر ملف. إذا كانت خلاصتك تتضمّن أخطاء، سيتم إرسال رسالة إلكترونية إليك تتضمّن رموز أخطاء الخلاصة. تمنع الأخطاء استيعاب التجار أو الخدمات أو معلومات التوفّر المحدّدة. بعد التحقّق من صحة الخلاصات، قد يستغرق ظهورها في الواجهة الأمامية مدة تصل إلى 24 ساعة.