تحديد إصدارات الكيانات

يكون لكل كيان يتم إرساله إلى Google نسخة مرفقة به، سواء من خلال الخلاصات أو التحديثات في الوقت الفعلي. يأتي هذا الإصدار في شكل طابع زمني. ويمكن توفير الطابع الزمني في الخلاصات لكل كيان باستخدام السمة dateModified. وإذا لم يتم تضمين السمة كيانات الخلاصة، سيتم ضبط الإصدار على وقت بدء عرض الخلاصة. في تحديثات الوقت الفعلي batchPush وbatchDelete، يتم استخدام الحقلين generation_timestamp وdelete_time لضبط الإصدار. وإذا لم يتم تضمين الحقل، فسيتم تعيين الإصدار على الوقت الذي تم فيه تلقي الطلب. راجِع التنسيق المتوقَّع للقيم الزمنية في مخطط المستودع العلائقي.

تعالج Google الكيانات فقط (مثل مطعم أو قائمة طعام أو خدمة) التي يكون فيها إصدار مساوية أو أحدث من آخر نسخة مقبولة. وبخلاف ذلك، لا يتم نقل الكيان ويتم تسجيل خطأ الكيان القديم. عند تحديث أحد الكيانات بنسخة جديدة، يتم تحديث آخر طابع زمني معدّل إلى الوقت الحالي الذي تم فيه تحديثه.

مثال

لنفترض أنه تم إنشاء خلاصة في 16 حزيران (يونيو) الساعة 01:10 بالتوقيت العالمي المنسق (UTC) مع تضمين مثال الكيان التالي.

{
  "@type": "Restaurant",
  "@id": "restaurant12345",
  "dateModified": "2022-06-16T01:10:00.000Z",
  ...
}

لا يستوعب محرّك بحث Google الخلاصة بعد. في وقت لاحق من ذلك اليوم عند الساعة 2022-06-16T01:22:00.000Z، تتلقّى Google طلب تحديث في الوقت الفعلي batchPush يتضمّن الكيان التالي.

{
  "records": [
    {
      "data_record": "{\"@type\": \"Restaurant\",\"@id\": \"restaurant12345\" ...",
      "generation_timestamp": "2022-06-16T01:20:00.000Z"
    }
  ]
}

إنّ إصدار رقم تعريف كيان المطعم restaurant12345 أصبح الآن 2022-06-16T01:20:00.000Z، وقد تم ضبط آخر طابع زمني لتعديل الكيان على 2022-06-16T01:22:00.000Z. باختصار، وقت آخر تعديل هو الوقت الذي تم فيه تعديل العنصر في مستودع Google، وتمثّل النسخة قيمة generation_timestamp من طلب التعديل في الوقت الفعلي أو قيمة dateModified من الخلاصة.

وسيبدأ نقل الخلاصة في 16 حزيران (يونيو) الساعة 02:00 بالتوقيت العالمي المنسّق. وفي هذه الحالة، يُعتبر الكيان الذي يتم استلامه في الخلاصة بالإصدار 2022-06-16T01:10:00.000Z قديمًا ولا يتم نقل بياناته. لذلك يواصل Google عرض الكيان الذي يحمل الإصدار 2022-06-16T01:20:00.000Z من طلب تحديث في الوقت الفعلي.

أفضل الممارسات:

  • تنفيذ طابع زمني في الخلاصات لكل كيان
  • طبِّق تغييرات التحديث في الوقت الفعلي على خلاصتك التالية واضبط الطابع الزمني dateModified في كيانات الخلاصة على الوقت الحالي الذي أنشأت فيه الخلاصة.