العرض المجمّع

تتيح لك خلاصات البيانات إتاحة مطعمك وخدماتك وقائمتك في "الطلب من خلال Google".

يتناول هذا المستند كيفية استضافة مستودع في المستودع ومستودعات الإنتاج واستخدام العرض المجمّع لتعديل المستودع في خدمة "الطلب عبر Google".

بيئات خلاصة البيانات

تتوفّر ثلاث بيئات لخلاصة البيانات لتطوير عملية الدمج:

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

استضافة خلاصات البيانات

لكي تعالج خدمة "الطلب عبر Google" خلاصات بيانات الإنتاج ووضع الحماية من خلال العرض المجمّع، يجب استضافة ملفات خلاصة البيانات على Google Cloud Storage أو Amazon S3 أو HTTPS باستخدام ملف Sitemap.

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

على سبيل المثال، إذا كنت تستخدم Google Cloud Storage كخيار استضافة، ستظهر لك المسارات التالية:

• خلاصة وضع الحماية: gs://foorestaurant-google-feed-sandbox/
• خلاصة الإنتاج: gs://foorestaurant-google-feed-prod/

لاستضافة مستودعك، نفِّذ ما يلي:

1. أنشئ ملفات خلاصة البيانات.
2. اختَر أحد حلول الاستضافة.
3. استضافة خلاصات البيانات
4. تأكّد من تعديل ملفات خلاصة البيانات بانتظام. ويجب تعديل خلاصات بيانات الإنتاج يوميًا.

لمعرفة كيفية إنشاء خلاصة مستودع، يُرجى الاطّلاع على مستندات Restaurant وService وMenu بالإضافة إلى قسم إنشاء خلاصة بيانات.

إرشادات حول ملفات خلاصة البيانات

ويجب ألا يتجاوز حجم كل ملف 200 ميغابايت. يجب ألا تتجاوز كيانات المستوى الأعلى Restaurant وService وMenu، مع الكيانات الفرعية، 4 ميغابايت معًا.

ملاحظة: نقترح عليك أن تضيف معًا جميع كيانات المطاعم والخدمات والقائمة ذات الصلة إلى ملف خلاصة البيانات نفسه، مع إرفاق ملف واحد لكل موقع جغرافي للتاجر. على سبيل المثال، إذا كان لديك 8,000 موقع جغرافي للتاجر، يمكنك إنشاء 8,000 ملف. ويمكن أن يسهّل ملف منفصل لكل موقع جغرافي للتاجر تصحيح الأخطاء ودعم عملية الدمج.

اختيار حل استضافة

يعرض الجدول التالي خيارات استضافة خلاصات البيانات وآلية عمل هؤلاء المضيفين مع برنامج "الطلب عبر Google":

	Amazon S3	Google Cloud Storage	بروتوكول HTTPS مع خريطة موقع
بيانات الاعتماد وإمكانية الوصول	قدِّم لشركة Google المعلومات التالية: رقم تعريف مفتاح الوصول مفتاح الوصول السري المسارات المؤدية إلى الإنتاج وأدلة S3 للإنتاج ووضع الحماية marker.txt يجب أن يبدأ المسار بـ s3://. يجب أن تتضمّن حزمة S3 المعلومات التالية: ملفات الخلاصة لمستودعك marker.txt، الذي يتضمّن طابعًا زمنيًا مستخدمًا في الجلب. مثال على ملف marker.txt: 2018-12-03T08:30:42.694Z	تزويد Google بالمسارات المؤدية إلى الإنتاج وأدلة حزمة وضع الحماية وملف marker.txt يجب أن تبدأ المسارات بـ gs://. أضِف حساب الخدمة الذي يوفّره لك مستشار Google كقارئ لحزمة Google Cloud Storage. لمزيد من المعلومات حول كيفية التحكّم في وصول Google Cloud Storage (GCS)، يمكنك الاطّلاع على وحدة تحكّم Google Cloud Platform: ضبط أذونات حزمة. يجب أن تتضمّن حزمة GCS المعلومات التالية: ملفات الخلاصة لمستودعك marker.txt، الذي يتضمّن طابعًا زمنيًا مستخدمًا في الجلب. مثال على ملف marker.txt: 2018-12-03T08:30:42.694Z	قدِّم لشركة Google المعلومات التالية: بيانات اعتماد التفويض الأساسي. المسار إلى مسارات ملف Sitemap للإنتاج ووضع الحماية. يجب أن يبدأ المسار بـ https://. البروتوكول: يجب إتاحة ملفات الخلاصة على HTTPS، وليس HTTP. الأمان: تنصح Google بشدة بحماية ملفات الخلاصات المستضافة باستخدام المصادقة الأساسية.
كيفية معرفة Google للملفات التي يجب استرجاعها	قائمة بجميع الملفات في الحزمة	قائمة بجميع الملفات في الحزمة	عناوين URL فردية للملفات المدرَجة في ملف Sitemap
كيفية معرفة Google بأن الملفات جاهزة للجلب	بعد الانتهاء من إنشاء خلاصات البيانات، يمكنك تعديل ملف marker.txt باستخدام الطابع الزمني الأخير.	بعد الانتهاء من إنشاء خلاصات البيانات، يمكنك تعديل ملف marker.txt باستخدام الطابع الزمني الأخير.	بعد الانتهاء من إنشاء خلاصات البيانات، يمكنك تعديل عنوان الاستجابة last-modified من إجمالي sitemap.xml باستخدام أحدث طابع زمني.
الحدود القصوى للملفات	الحد الأقصى لعدد الملفات: 100,000. يجب أن يكون لديك أقل من 100000 ملف في حزمة Amazon S3.	الحد الأقصى لعدد الملفات: 100,000. يجب أن يكون لديك أقل من 100000 ملف في حزمة Google Cloud Storage.	الحد الأقصى لعدد الملفات: 100,000. يجب أن يكون عدد مسارات الملفات ضمن ملف XML لملف Sitemap أقل من 100000.

ربط خلاصات البيانات لعرض مجمّع

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

إذا كنت تستضيف خلاصات بياناتك باستخدام Amazon S3

1. في بوابة الشركاء، انتقِل إلى الضبط > الخلاصات.

2. انقر على تعديل واملأ نموذج تعديل الخلاصة:

   • طريقة عرض الخلاصة: يتم ضبطها على Amazon S3.
   • ملف العلامة: قدِّم عنوان URL لملف marker.txt.
   • ملفات البيانات: قدِّم عنوان URL إلى حزمة S3 التي تحتوي على خلاصات البيانات.
   • رقم تعريف الوصول: أدخِل رقم تعريف مفتاح الوصول لإدارة الهوية وإمكانية الوصول مع أذونات للقراءة من موارد S3.
   • مفتاح الوصول: أدخِل مفتاح الوصول السري لإدارة الهوية وإمكانية الوصول مع أذونات للقراءة من موارد S3.
3. انقر على Submit (إرسال).
4. بعد ساعة أو ساعتين، تحقَّق مما إذا كان النقل المُجمَّع يجلب ملفات خلاصتك.

إذا كنت تستضيف خلاصات بياناتك باستخدام Google Cloud Storage

1. في بوابة الشركاء، انتقِل إلى الضبط > الخلاصات.

2. انقر على تعديل واملأ نموذج تعديل الخلاصة:

   • طريقة عرض الخلاصة: اضبط الإعدادات على Google Cloud Storage.
   • ملف العلامة: قدِّم عنوان URL لملف marker.txt.
   • ملفات البيانات: قدِّم عنوان URL إلى حزمة GCS التي تحتوي على خلاصات البيانات.
3. انقر على Submit (إرسال).
4. يتم إنشاء حساب خدمة للوصول إلى حزمة GCS. يمكن العثور على اسم الحساب في عمليات الإعداد > الخلاصات بعد اكتمال مهام الإعداد. يحتاج حساب الخدمة هذا إلى دور "قارئ عنصر قديم للتخزين". يمكن منح هذا الدور إلى حساب الخدمة في صفحة "إدارة الهوية وإمكانية الوصول" ضمن وحدة تحكُّم Google Cloud.
5. بعد ساعة أو ساعتين، تحقَّق مما إذا كان النقل المُجمَّع يجلب ملفات خلاصتك.

إذا كنت تستضيف خلاصات بياناتك باستخدام HTTPS

1. في بوابة الشركاء، انتقِل إلى الضبط > الخلاصات.

2. انقر على تعديل واملأ نموذج تعديل الخلاصة:

   • طريقة عرض الخلاصة: يتم ضبطها على HTTPS.
   • ملف Sitemap: أدخِل عنوان URL لملف sitemap.xml.
   • اسم المستخدم: أدخِل بيانات اعتماد اسم المستخدم للوصول إلى خادم HTTPS.
   • كلمة المرور: أدخِل كلمة المرور للوصول إلى خادم HTTPS.
3. انقر على Submit (إرسال).
4. بعد ساعة أو ساعتين، تحقَّق مما إذا كان النقل المُجمَّع يجلب ملفات خلاصتك.

أمثلة على المسارات

يتضمن الجدول التالي أمثلة على المسارات لكل خيار من خيارات الاستضافة:

	Amazon S3	Google Cloud Storage	بروتوكول HTTPS مع خريطة موقع
المسار	s3://foorestaurant-google-feed-sandbox/	gs://foorestaurant-google-feed-sandbox/	https://sandbox-foorestaurant.com/sitemap.xml
ملف العلامات	s3://foorestaurant-google-feed-sandbox/marker.txt	gs://foorestaurant-google-feed-sandbox/marker.txt	غير سارٍ

ملفات Sitemap لاستضافة HTTPS

اتّبِع الإرشادات التالية عند تعريف ملفات Sitemap:

• يجب أن تشير الروابط في ملف Sitemap إلى الملفات نفسها.
• إذا كانت خريطة الموقع تتضمّن إشارات إلى مقدّم خدمات سحابية بدلاً من اسم نطاقك، تأكّد من أنّ بداية عناوين URL، مثل https://www.yourcloudprovider.com/your_id، ثابتة وفريدة بالنسبة إلى مهامك المجمّعة.
• احرص على عدم تحميل ملفات Sitemap جزئية (على سبيل المثال، في حال تحميل بيانات جزئية). ويؤدي هذا الإجراء إلى عرض Google للملفات فقط في ملف Sitemap، ما سيؤدي إلى انخفاض مستويات المستودع، وقد يؤدي إلى حظر عرض الخلاصة.
• تأكَّد من أنّ المسارات المؤدية إلى الملفات المشار إليها في ملف Sitemap لا تتغير. على سبيل المثال، لا تريد أن يتضمّن ملف Sitemap https://www.yourcloudprovider.com/your_id/10000.json مرجع ملف Sitemap اليوم ولكنه يشير إلى https://www.yourcloudprovider.com/your_id/20000.json غدًا.

مثال على ملف Sitemap

في ما يلي مثال على ملف sitemap.xml يعرض ملفات خلاصة البيانات:

المثال 1: الكيانات المجمّعة حسب التجّار (إجراء مقترَح).

XML

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_1.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_2.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_3.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
</urlset>

المثال 2: الكيانات المجمّعة حسب الأنواع.

XML

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 <url>
   <loc>https://your_fulfillment_url.com/restaurant.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/menu.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/service.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
</urlset>

ملاحظة: الحقل المطلوب فقط لملف Sitemap للطلب من Google هو loc.

تعديل خلاصات البيانات

بعد ربط خلاصات بياناتك، تبحث Google عن تعديلات مرة واحدة كل ساعة، ولكنها تعرض كل خلاصات البيانات فقط عندما يتم تعديل ملفات marker.txt أو sitemap.xml. ونتوقع تحديث خلاصات البيانات مرة واحدة في اليوم لمنع المستودع القديم.

لتحديد أنّ خلاصات البيانات قد تم تعديلها وأنّها جاهزة للعرض المجمّع، عليك تعديل حقل البيانات الوصفية للعنصر last-modified للملف marker.txt (بالنسبة إلى Google Cloud Platform وS3) أو عنوان الاستجابة last-modified لملف sitemap.xml. ويستخدم محرّك البحث Google هذه القيم لتحديد مدى حداثة خلاصة البيانات.

أثناء نقل الخلاصة المجمّعة،

• سيتمّ إدراج كيانات جديدة لا تتوفّر في مستودعك الحالي على WOG، ولا يتم إدراج أي أخطاء فيها.
• تتوفّر حاليًا الكيانات في المستودع التي لا تتضمّن أي أخطاء في العرض، ويجب أن تكون أحدث من dateModified في الإدخال الحالي أو إذا لم تكن تتضمّن dateModified. إنّ وقت بدء عرض الخلاصة أحدث من الإدخال الحالي الذي سيتم تعديله، وإلا سيتم وضع علامة "قديمة" عليها.
• سيتمّ حذف الكيانات التي كانت جزءًا من خلاصة سابقة لم تعُد مضمّنة في الخلاصة المجمّعة التي تتم معالجتها، شرط عدم وجود أخطاء على مستوى الملف في الخلاصة.

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

ملاحظة: تختلف last-modified عن إصدارات الكيانات. يتم تشغيل last-modified عند استلام الدفعة، وليس لها أي تأثير في إصدار الكيان.