לגבי כל ישות שנשלחת אל 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 בישויות הפיד עד למועד הנוכחי שבו הפיד נוצר.