항목 버전 관리

피드 또는 실시간 업데이트를 통해 Google에 전송되는 각 항목에는 버전이 연결되어 있습니다. 이 버전은 타임스탬프 형식으로 제공됩니다. 피드에서 dateModified 속성을 사용하여 각 항목의 타임스탬프를 제공할 수 있습니다. 속성이 피드 항목에 포함되지 않은 경우 버전이 피드 처리 시작 시간으로 설정됩니다. 실시간 업데이트 batchPushbatchDelete에서 각각 generation_timestampdelete_time 필드는 버전을 설정하는 데 사용됩니다. 필드가 포함되지 않으면 버전은 요청이 수신된 시간으로 설정됩니다. 관계형 인벤토리 스키마에서 시간 값의 예상 형식을 확인하세요.

Google은 마지막으로 허용된 버전 이상의 항목 (예: 식당, 메뉴, 서비스)을 처리합니다. 그렇지 않으면 항목이 수집되지 않고 오래된 항목 오류가 기록됩니다. 항목이 새 버전으로 업데이트되면 마지막으로 수정된 타임스탬프가 현재 업데이트된 시간으로 업데이트됩니다.

6월 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"
    }
  ]
}

식당 항목 ID restaurant12345의 버전은 이제 2022-06-16T01:20:00.000Z이고 항목의 마지막으로 수정된 타임스탬프는 2022-06-16T01:22:00.000Z로 설정됩니다. 요약하면, 최종 수정 시간은 Google 인벤토리에서 항목이 업데이트된 시간이며 버전은 실시간 업데이트 요청의 generation_timestamp 값 또는 피드의 dateModified 값입니다.

이후 피드 처리는 6월 16일 02:00(UTC)에 시작됩니다. 이 경우 2022-06-16T01:10:00.000Z 버전으로 피드에서 수신된 항목은 오래된 것으로 간주되어 수집되지 않습니다. 따라서 Google은 실시간 업데이트 요청에서 2022-06-16T01:20:00.000Z 버전으로 항목을 계속 제공합니다.

권장사항:

  • 각 항목의 피드에 타임스탬프를 구현합니다.
  • 다음 피드에 실시간 업데이트 변경사항을 적용하고 피드 항목의 dateModified 타임스탬프를 피드를 만든 현재 시간으로 설정합니다.