การกำหนดเวอร์ชันเอนทิตี

เอนทิตีแต่ละรายการที่ส่งไปยัง 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 น. UTC ในกรณีนี้ ระบบจะถือว่าเอนทิตีที่ได้รับในฟีดเวอร์ชัน 2022-06-16T01:10:00.000Z นั้นล้าสมัยและจะไม่ส่งผ่านข้อมูล Google จึงแสดงเอนทิตีเวอร์ชัน 2022-06-16T01:20:00.000Z จากคำขอการอัปเดตแบบเรียลไทม์ต่อไป

แนวทางปฏิบัติแนะนำ

• ใช้การประทับเวลาในฟีดสำหรับเอนทิตีแต่ละรายการ
• ใช้การเปลี่ยนแปลงการอัปเดตแบบเรียลไทม์กับฟีดถัดไป และตั้งค่าการประทับเวลา dateModified ในเอนทิตีฟีดเป็นเวลาปัจจุบันเมื่อคุณสร้างฟีด