Tạo phiên bản thực thể

Lưu ý: Những đối tác vẫn đang sử dụng giản đồ khoảng không quảng cáo không có liên quan có thể truy cập vào Tài liệu về việc tạo phiên bản phiên bản 1 trong nguồn cấp dữ liệu hàng loạt trong phần lưu trữ.

Mỗi thực thể được gửi đến Google, cho dù thông qua nguồn cấp dữ liệu hay thông tin cập nhật theo thời gian thực, có đính kèm một phiên bản. Phiên bản này được cung cấp ở dạng dấu thời gian. Trong nguồn cấp dữ liệu, bạn có thể cung cấp dấu thời gian cho từng thực thể bằng dateModified . Nếu thuộc tính này không có trong các thực thể nguồn cấp dữ liệu thì phiên bản sẽ là thành thời gian bắt đầu nhập nguồn cấp dữ liệu. Theo thời gian thực batchPush và batchDelete tương ứng với các trường generation_timestamp và delete_time được dùng để thiết lập phiên bản. Nếu không có trường này, phiên bản sẽ được đặt thành thời điểm nhận được yêu cầu. Xem định dạng mong muốn của thời gian giá trị trong giản đồ khoảng không quảng cáo quan hệ.

Google chỉ xử lý các pháp nhân (ví dụ: nhà hàng, thực đơn hoặc dịch vụ) có phiên bản bằng hoặc mới hơn phiên bản được chấp nhận gần đây nhất. Nếu không, giá trị không được nhập và lỗi Thực thể đã lỗi thời được ghi lại. Khi một phiên bản mới của thực thể được cập nhật, thì dấu thời gian sửa đổi gần đây nhất được cập nhật thành thời gian cập nhật hiện tại.

Thận trọng: Nếu một thực thể không được sửa đổi bằng phiên bản mới trong 14 ngày dữ liệu đó sẽ được thu gom và loại bỏ khỏi hoạt động phân phát.

Ví dụ:

Giả sử nguồn cấp dữ liệu được tạo vào ngày 16 tháng 6 lúc 01:10 giờ UTC như ví dụ sau thực thể được bao gồm.

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

Google chưa nhập nguồn cấp dữ liệu này. Cuối ngày hôm đó lúc 2022-06-16T01:22:00.000Z, Google nhận được một Yêu cầu batchPush cập nhật theo thời gian thực với những nội dung sau thực thể.

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

Hiện đã có phiên bản cho mã nhận dạng thực thể nhà hàng restaurant12345 Đã đặt 2022-06-16T01:20:00.000Z và dấu thời gian được sửa đổi gần đây nhất của thực thể đến 2022-06-16T01:22:00.000Z. Tóm lại, thời gian sửa đổi gần đây nhất là thời gian rằng thực thể đã được cập nhật trong khoảng không quảng cáo của Google và phiên bản là generation_timestamp từ yêu cầu cập nhật theo thời gian thực hoặc dateModified giá trị khỏi nguồn cấp dữ liệu.

Sau đó, quá trình truyền dẫn nguồn cấp dữ liệu sẽ bắt đầu vào lúc 02:00 giờ UTC, ngày 16 tháng 6. Trong trường hợp này, thực thể nhận được trong nguồn cấp dữ liệu có phiên bản 2022-06-16T01:10:00.000Z là bị coi là đã lỗi thời và không được nhập. Do đó, Google sẽ tiếp tục phục vụ thực thể có phiên bản 2022-06-16T01:20:00.000Z từ yêu cầu cập nhật theo thời gian thực.

Các phương pháp hay nhất:

• Triển khai dấu thời gian trong nguồn cấp dữ liệu cho từng thực thể.
• Áp dụng các thay đổi cập nhật theo thời gian thực cho nguồn cấp dữ liệu tiếp theo và thiết lập Dấu thời gian dateModified trong các thực thể nguồn cấp dữ liệu đến thời điểm hiện tại khi bạn đã tạo nguồn cấp dữ liệu.