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

เอนทิตีแต่ละรายการที่ส่งไปยัง 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 ในเอนทิตีฟีดเป็นเวลาปัจจุบันเมื่อสร้างฟีด