Varlık sürüm oluşturma

Feed'ler veya gerçek zamanlı güncellemeler aracılığıyla Google'a gönderilen her öğenin bir sürümü vardır. Bu sürüm, zaman damgası biçimindedir. Feed'lerde, dateModified özelliği kullanılarak her öğe için zaman damgası sağlanabilir. Özellik feed öğelerine dahil edilmezse sürüm, feed beslemesinin başlangıç zamanına ayarlanır. Gerçek zamanlı güncellemelerde batchPush ve batchDelete için sırasıyla generation_timestamp ve delete_time alanları sürüm ayarlamak için kullanılır. Alan dahil edilmezse sürüm, isteğin alındığı saate ayarlanır. İlişkisel envanter şemasında zaman değerlerinin beklenen biçimine bakın.

Google yalnızca son kabul edilen sürümle aynı veya daha yeni bir sürüme sahip öğeleri (ör. restoran, menü veya hizmet) işler. Aksi takdirde varlık beslenmez ve Kullanılamayacak Varlık hatası kaydedilir. Bir öğe yeni bir sürümle güncellendiğinde, son değiştirilme zaman damgası güncellendiği mevcut saatle güncellenir.

Örnek

16 Haziran'da saat 01:10 UTC'de aşağıdaki örnek öğenin dahil edildiği bir feed oluşturulduğunu varsayalım.

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

Feed henüz Google tarafından beslenmiyor. Aynı günün ilerleyen saatlerinde 2022-06-16T01:22:00.000Z saatinde Google, aşağıdaki öğeyi içeren bir gerçek zamanlı güncelleme batchPush isteği alır.

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

restaurant12345 restoran varlık kimliğinin sürümü artık 2022-06-16T01:20:00.000Z ve varlığın son değiştirilme zaman damgası 2022-06-16T01:22:00.000Z olarak ayarlandı. Özetlemek gerekirse, son değiştirilme zamanı, öğenin Google'ın envanterinde güncellendiği zamandır ve sürüm, gerçek zamanlı güncelleme isteğinde bulunan generation_timestamp değeri veya feed'deki dateModified değeridir.

Ardından feed beslemesi 16 Haziran'da 02:00 (UTC) itibarıyla başlar. Bu durumda, feed'de 2022-06-16T01:10:00.000Z sürümüyle alınan öğe eski kabul edilir ve beslenmez. Bu nedenle Google, gerçek zamanlı güncelleme isteğinde belirtilen 2022-06-16T01:20:00.000Z sürümüne sahip öğeyi sunmaya devam eder.

En iyi uygulamalar:

  • Feed'lere her öğe için bir zaman damgası uygulayın.
  • Gerçek zamanlı güncelleme değişikliklerini bir sonraki feed'inize uygulayın ve feed öğelerindeki dateModified zaman damgasını, feed'i oluşturduğunuz mevcut saate ayarlayın.