Lỗi nguồn cấp dữ liệu theo lô

Nhập hàng loạt nguồn cấp dữ liệu cho phép bạn cung cấp các nhà hàng, dịch vụ và trình đơn trong giao diện Sắp xếp thứ tự từ đầu đến cuối.

Google tìm nạp nguồn cấp dữ liệu của bạn được lưu trữ trên nền tảng lưu trữ và xử lý chúng. Sau khi nhập thành công, tính năng Sắp xếp thứ tự hai đầu sẽ cung cấp thông tin về trạng thái nhập, các tệp mới đã tải lên, tổng số tệp, lỗi và cảnh báo và những thông tin khác.

Bài viết này trình bày chi tiết về hầu hết các lỗi liên quan đến nguồn cấp dữ liệu theo lô trong Actions Center, ý nghĩa của các lỗi này và cách khắc phục. Các siêu liên kết này đưa bạn đến trang giản đồ khoảng không quảng cáo quan hệ, trang này cung cấp thêm ngữ cảnh như loại dữ liệu được chấp nhận và ví dụ về các trường và thực thể cụ thể.

Lỗi nguồn cấp dữ liệu hàng loạt xuất hiện ở đâu trong Trung tâm hành động?

Nguồn cấp dữ liệu cho phép bạn cung cấp nhà hàng, dịch vụ và thực đơn trong Đặt hàng hai đầu. Để tìm hiểu thêm về cách lưu trữ nguồn cấp dữ liệu, hãy xem bài viết Nhập hàng loạt.

Sau khi các tệp nguồn cấp dữ liệu được tải lên, Google sẽ tìm nạp và xử lý chúng. Nếu có bất kỳ vấn đề nào, các vấn đề đó sẽ hiển thị dưới dạng lỗi. Dưới đây là các bước để xem lỗi Nguồn cấp dữ liệu hàng loạt trong Trung tâm hành động.

  1. Trên bảng điều hướng chính của Trung tâm hành động, hãy chuyển đến phần Nguồn cấp dữ liệu > Nhật ký. Nhật ký nhập lỗi nguồn cấp dữ liệu hàng loạt

  2. Chọn môi trường (Sản xuất hoặc Hộp cát) rồi nhấp vào thẻ Nhật ký truyền dẫn

  3. Nhập giai đoạn xem lại để xem nhật ký nhập trong X ngày qua

  4. Để biết thêm thông tin chi tiết về các lỗi đối với một lần truyền dẫn nguồn cấp dữ liệu cụ thể, hãy nhấp vào mũi tên (→)

  5. Sau đó, bạn có thể xem thêm chi tiết về các lỗi và cảnh báo Lỗi nguồn cấp dữ liệu hàng loạt chi tiết

Dưới đây là danh sách các lỗi về nguồn cấp dữ liệu hàng loạt:

Lỗi Ý nghĩa Cách khắc phục
Thiếu dữ liệu – MenuItem Trình đơn phải có ít nhất một MenuItem Một Trình đơn đã được xác định mà không có MenuItem nào Tìm mã nhận dạng cho thực thể Thực đơn không chính xác trong nguồn cấp dữ liệu rồi thêm các món trong thực đơn.
Dữ liệu không chính xác – maxPrice Dữ liệu cho trường maxPrice không chính xác Giá trị của trường maxPrice không chính xác Đảm bảo rằng giá trị của trường maxPrice lớn hơn 0 đối với mã nhận dạng thực thể được đề cập trong phần mô tả lỗi
Dữ liệu không chính xác – eligibleQuantityMax Dữ liệu cho trường eligibleQuantityMax không chính xác Giá trị của trường eligibleQuantityMax không chính xác Đảm bảo rằng giá trị của trường eligibleQuantityMax lớn hơn 0 đối với mã nhận dạng thực thể được đề cập.
Dữ liệu không chính xác – leadTimeMax Dữ liệu cho trường leadTimeMax không chính xác Trường leadTimeMax yêu cầu một giá trị số nguyên. Ví dụ: 12. Nó gửi lỗi cho bất kỳ loại dữ liệu nào khác, thậm chí là gấp đôi (15.0) Đối với Mã nhận dạng thực thể được đề cập trong thông báo lỗi, hãy kiểm tra giá trị của thuộc tính leadTimeMax và đảm bảo rằng giá trị đó là một số nguyên.
Dữ liệu không chính xác – validFrom Dữ liệu cho trường validFrom không chính xác Giá trị cho trường validFrom yêu cầu định dạng dấu thời gian ISO với loại Chuỗi. Đối với mã nhận dạng thực thể trong thông báo lỗi cho trường validFrom, hãy đảm bảo rằng giá trị là một chuỗi dấu thời gian.

Ví dụ: "2022-01-02T00:00:00-07:00"
Thiếu dữ liệu – ServiceHours

OperationHour không chứa OperationHour lồng nhau
Thực thể OperationHours đã được xác định nhưng không có thực thể OperationHours nào hợp lệ tương ứng. Đối với mã nhận dạng thực thể được đề cập trong thông báo lỗi, hãy kiểm tra xem có thực thể ServiceHours nào được xác định đúng cách tương ứng với thực thể đó hay không.

Ví dụ: nếu thông báo lỗi là "Mã thực thể: store-1: VíOperationHoursServiceIDOperationHoursID
Dữ liệu không chính xác – advanceBookingRequirementMin Dữ liệu cho trường advanceBookingRequirementMin không chính xác Trường advanceBookingRequirementMin yêu cầu một giá trị số nguyên. Ví dụ: 12.

Ứng dụng này sẽ gửi lỗi cho mọi loại dữ liệu khác, kể cả lỗi gấp đôi (15.0)
Đối với Mã nhận dạng thực thể được đề cập trong thông báo lỗi, hãy kiểm tra giá trị của thuộc tính advanceBookingRequirementMin và đảm bảo rằng giá trị đó là một số nguyên.
Dữ liệu không chính xác – availabilityStarts Dữ liệu cho trường availabilityStarts không chính xác Giá trị cho trường availabilityStarts yêu cầu định dạng dấu thời gian ISO với loại Chuỗi. Đối với mã nhận dạng thực thể trong thông báo lỗi cho trường availabilityStarts, hãy đảm bảo rằng giá trị là một chuỗi dấu thời gian.

Ví dụ: "2022-01-02T00:00:00-07:00"
Dữ liệu không chính xác – closes Dữ liệu cho trường closes không chính xác Giá trị cho trường closes yêu cầu định dạng dấu thời gian ISO với loại Chuỗi. Đối với mã nhận dạng thực thể trong thông báo lỗi cho trường closes, hãy đảm bảo rằng giá trị là một chuỗi dấu thời gian.

Ví dụ: "2022-01-02T00:00:00-07:00"
Dữ liệu không chính xác – dateModified Dữ liệu cho trường dateModified không chính xác Giá trị cho trường dateModified yêu cầu định dạng dấu thời gian ISO với loại Chuỗi. Đối với mã nhận dạng thực thể trong thông báo lỗi cho trường dateModified, hãy đảm bảo rằng giá trị là một chuỗi dấu thời gian.

Ví dụ: "2022-01-02T00:00:00-07:00"
Dữ liệu không chính xác – discount Dữ liệu cho trường discount không chính xác Trường discount yêu cầu một giá trị số Đối với mã nhận dạng thực thể trong thông báo lỗi cho trường discount, hãy đảm bảo rằng giá trị là số.

Ví dụ: 10
Dữ liệu không chính xác – discountPercentage Dữ liệu cho trường discountPercentage không chính xác Trường discountPercentage yêu cầu một giá trị số Đối với mã nhận dạng thực thể trong thông báo lỗi cho trường discountPercentage, hãy đảm bảo rằng giá trị là số.

Ví dụ: 15
Dữ liệu không chính xác – geoRadius Dữ liệu cho trường geoRadius không chính xác Trường geoRadius yêu cầu một giá trị số nguyên dương. Đối với Mã nhận dạng thực thể được đề cập trong thông báo lỗi, hãy kiểm tra giá trị của thuộc tính geoRadius và đảm bảo rằng giá trị đó là một số nguyên.

Ví dụ: 10000
Dữ liệu không chính xác – image Dữ liệu cho trường image không chính xác Trường image mong đợi một URL hợp lệ và gửi lỗi nếu phát hiện thấy bất kỳ điều gì khác. Kiểm tra xem giá trị của trường image có phải là chuỗi URL hợp lệ hay không
Dữ liệu không chính xác – latitude Dữ liệu cho trường latitude không chính xác Trường latitude yêu cầu loại giá trị sẽ là gấp đôi Đối với mã nhận dạng thực thể của loại Restaurant được đề cập trong phần mô tả lỗi, hãy đảm bảo rằng giá trị của trường latitude là gấp đôi.

Ví dụ: 35,4565
Dữ liệu không chính xác – leadTimeMin Dữ liệu cho trường leadTimeMin không chính xác Trường leadTimeMin yêu cầu một giá trị số nguyên. Ví dụ: 12.

Ứng dụng này sẽ gửi lỗi cho mọi loại dữ liệu khác, kể cả lỗi gấp đôi (15.0)
Đối với Mã nhận dạng thực thể được đề cập trong thông báo lỗi, hãy kiểm tra giá trị của thuộc tính leadTimeMin và đảm bảo rằng giá trị đó là một số nguyên.
Dữ liệu không chính xác – longitude Dữ liệu cho trường longitude không chính xác Trường longitude yêu cầu loại giá trị sẽ là gấp đôi Đối với mã nhận dạng thực thể của loại Restaurant được đề cập trong phần mô tả lỗi, hãy đảm bảo rằng giá trị của trường longitude là gấp đôi.

Ví dụ: 35,4565
Dữ liệu không chính xác – menuId Dữ liệu cho trường menuId không chính xác Giá trị cho trường menuId phải là một Chuỗi không trống Đối với mã nhận dạng thực thể được đề cập trong phần mô tả lỗi, hãy đảm bảo rằng giá trị thuộc loại Chuỗi và không để trống
Dữ liệu không chính xác – name Dữ liệu cho trường name không chính xác Giá trị của trường name phải là một chuỗi không trống Kiểm tra xem giá trị cho mã nhận dạng thực thể được đề cập trong thông báo lỗi có phải là một chuỗi không trống hay không
Dữ liệu không chính xác – nutrition.calories Dữ liệu cho trường nutrition.calories không chính xác Giá trị cho trường calories cần phải là một chuỗi có định dạng "NN Cal" Đảm bảo rằng đối với mã nhận dạng thực thể trong thông báo lỗi, giá trị là một số dương có định dạng đúng.

Ví dụ: "123,32 Cal"
Dữ liệu không chính xác – opens Dữ liệu cho trường opens không chính xác Giá trị cho trường opens yêu cầu định dạng dấu thời gian ISO với loại Chuỗi. Đối với mã nhận dạng thực thể trong thông báo lỗi cho trường opens, hãy đảm bảo rằng giá trị là một chuỗi dấu thời gian.

Ví dụ: "2022-01-02T00:00:00-07:00"
Dữ liệu không chính xác – price Dữ liệu cho trường price không chính xác Trường price yêu cầu một giá trị số Đối với mã nhận dạng thực thể trong thông báo lỗi cho trường price, hãy đảm bảo rằng giá trị là số.

Ví dụ: 15,4
Dữ liệu không chính xác – sku Dữ liệu cho trường sku không chính xác Giá trị của trường sku phải là một chuỗi không trống Kiểm tra xem giá trị cho mã nhận dạng thực thể được đề cập trong thông báo lỗi có phải là một chuỗi không trống hay không
Dữ liệu không chính xác – validFrom Dữ liệu cho trường validFrom không chính xác Giá trị cho trường validFrom yêu cầu định dạng dấu thời gian ISO với loại Chuỗi. Ngoài ra, giá trị của validFrom phải nhỏ hơn hoặc bằng validThrough Đối với mã nhận dạng thực thể được đề cập trong phần mô tả lỗi, hãy đảm bảo rằng giá trị của trường validFrom là một chuỗi dấu thời gian.

"2022-01-02T00:00:00-07:00"

Ngoài ra, hãy đảm bảo rằng giá trị của validFrom nhỏ hơn hoặc bằng validThrough
Dữ liệu không chính xác – validThrough Dữ liệu cho trường validThrough không chính xác Giá trị cho trường validThrough yêu cầu định dạng dấu thời gian ISO với loại Chuỗi. Ngoài ra, giá trị của validThrough phải lớn hơn hoặc bằng validFrom Đối với mã nhận dạng thực thể được đề cập trong phần mô tả lỗi, hãy đảm bảo rằng giá trị của trường validThrough là một chuỗi dấu thời gian.

"2022-01-02T00:00:00-07:00"

Ngoài ra, hãy đảm bảo rằng giá trị của validThrough lớn hơn hoặc bằng validFrom
Dữ liệu không chính xác – value Dữ liệu cho trường value không chính xác chỉ bắt buộc phải có trường giá trị khi Optiontype được xác định. Phương thức này yêu cầu một Chuỗi hoặc Enum value. Lưu ý rằng các giá trị Enum dành riêng cho loại tuỳ chọn PIZZA_SIDE. Đối với entityID được đề cập trong phần mô tả lỗi, hãy kiểm tra xem trường value có chuỗi không trống hay không.
Trình đơn quá lớn

Kích thước Trình đơn vượt quá giới hạn tối đa
Lỗi này được tạo ra khi kích thước của một tệp trình đơn lớn hơn kích thước mà hệ thống có thể chấp nhận. Mỗi tệp có thể chứa nhiều thực thể không được vượt quá 200 MB. Các thực thể cấp cao nhất là Nhà hàng, Dịch vụ và Thực đơn cùng với các thực thể con của chúng không được vượt quá 4 MB. Đảm bảo rằng kích thước của tệp trình đơn nằm trong giới hạn của nội dung được chỉ định trong tài liệu.
Thiếu dữ liệu – addressCountry Thiếu trường bắt buộc addressCountry trong dữ liệu nhập. addressCountry là trường bắt buộc và bị thiếu trong mục Nhà hàng Đối với mã nhận dạng thực thể được đề cập trong phần mô tả lỗi, hãy kiểm tra xem trường addressCountry có phải là một chuỗi không trống hay không
Thiếu dữ liệu – addressLocality Thiếu trường bắt buộc addressLocality trong dữ liệu nhập. addressLocality là trường bắt buộc và bị thiếu trong mục Nhà hàng Đối với mã nhận dạng thực thể được đề cập trong phần mô tả lỗi, hãy kiểm tra xem trường addressLocality có phải là một chuỗi không trống hay không
Thiếu dữ liệu – addressRegion Thiếu trường bắt buộc addressRegion trong dữ liệu nhập. addressRegion là trường bắt buộc và bị thiếu trong mục Nhà hàng Đối với mã nhận dạng thực thể được đề cập trong phần mô tả lỗi, hãy kiểm tra xem trường addressRegion có phải là một chuỗi không trống hay không
Thiếu dữ liệu – Phí

Dịch vụ giao hàng/mua mang đi không tính phí giao hàng
Thực thể thuộc loại Phí không có bất kỳ price nào được liên kết với thực thể này đối với dịch vụ giao hàng/lấy đi Đối với mã thực thể nêu trong phần mô tả lỗi, hãy đảm bảo rằng bạn đã thiết lập thực thể Phí đúng cách cho ServiceType giao hàng/lấy hàng theo hướng dẫn tại đây.
Thiếu dữ liệu – FeeValue Bạn phải nhập một trong các trường price, pricePerMeter, percentageOfCart trong dữ liệu nhập. Đối với giá trị của Phí, bạn cần đặt chính xác một trong hai price, pricePerMeter or percentageOfCart . Đối với mã nhận dạng thực thể nêu trong phần mô tả lỗi, hãy đảm bảo bạn thiết lập đúng một trong số price, pricePerMeter or percentageOfCart .
Thiếu dữ liệu – geoMidpointLatitude Thiếu trường bắt buộc geoMidpointLatitude trong dữ liệu nhập. Khi xác định ServiceArea, bạn bắt buộc phải sử dụng geoMidpointLatitude cùng với geoMidpointLongitude khi geoRadius được sử dụng. Đối với mã nhận dạng thực thể được đề cập trong phần mô tả lỗi, hãy đảm bảo rằng giá trị của trường geoMidpointLatitude đã được xác định và thuộc kiểu double.

Ví dụ: 35,4565
Thiếu dữ liệu – geoMidpointLongitude geoMidpointLongitude trong dữ liệu đầu vào. Khi xác định ServiceArea, bạn cần có geoMidpointLongitude cùng với geoMidpointLatitude khi sử dụng geoRadius. Đối với mã nhận dạng thực thể được đề cập trong phần mô tả lỗi, hãy đảm bảo rằng giá trị của trường geoMidpointLatitude đã được xác định và thuộc kiểu double.

Ví dụ: 122.4565
Thiếu dữ liệu – MenuItemOption

MenuItemOffer là bắt buộc cho MenuItemOption
Đối với mỗi MenuItemOption, cần phải có một thực thể MenuItemOffer tương ứng Đảm bảo rằng đối với tất cả mã mục trong trình đơn trong phần mô tả lỗi, tất cả thực thể MenuItemOption đều có thực thể MenuItemOffer được xác định đúng.
Thiếu dữ liệu – OperationHours

Dịch vụ thiếu giờ hoạt động
Một pháp nhân dịch vụ Giao hàng/Lấy hàng bị thiếu một thực thể OperationHours tương ứng. OperationHours mô tả cửa sổ đặt hàng mà người dùng có thể truy cập vào quy trình và đặt hàng sớm nhất có thể hoặc các đơn đặt hàng trong tương lai. Đối với mã nhận dạng thực thể được đề cập trong phần mô tả lỗi, hãy đảm bảo rằng bạn đã xác định đúng thực thể OperationHours.
Thiếu dữ liệu – postalCode Thiếu trường bắt buộc postalCode trong dữ liệu nhập. postalCode là trường bắt buộc và bị thiếu trong mục Nhà hàng Đối với mã nhận dạng thực thể được đề cập trong phần mô tả lỗi, hãy kiểm tra xem trường postalCode có phải là một chuỗi không trống hay không
Thiếu dữ liệu – priceCurrency Thiếu trường bắt buộc priceCurrency trong dữ liệu nhập. Trường priceCurrency trống hoặc chứa giá trị không chính xác. Đơn vị tiền tệ này yêu cầu mã đơn vị tiền tệ theo ISO 4217 gồm 3 chữ cái. Đối với mã nhận dạng thực thể được mô tả trong phần mô tả lỗi, hãy đảm bảo trường priceCurrency là một Chuỗi không trống có mã đơn vị tiền tệ theo ISO 4217 gồm 3 chữ cái.

Ví dụ: USD, EUR
Thiếu dữ liệu – ServiceArea

Dịch vụ giao hàng không có khu vực cung cấp dịch vụ giao hàng
Bạn bắt buộc phải triển khai thực thể ServiceArea nếu thực thể Service được liên kết có serviceType được đặt thành "GỬI" Đảm bảo rằng đối với mã nhận dạng thực thể Service được đề cập trong thông báo lỗi, có một thực thể ServiceArea được xác định đúng cách
Thiếu dữ liệu – streetAddress Thiếu trường bắt buộc streetAddress trong dữ liệu nhập. streetAddress là trường bắt buộc và bị thiếu trong mục Nhà hàng Tìm thực thể Nhà hàng theo mã nhận dạng được đề cập trong phần mô tả lỗi và kiểm tra xem trường streetAddress có phải là một chuỗi không trống hay không
Thực thể cũ Trong quá trình nhập nguồn cấp dữ liệu, tính năng Sắp xếp thứ tự hai đầu sẽ so sánh dấu thời gian ngày được sửa đổi của mỗi thực thể đến với dấu thời gian của các thực thể đã nhập trước đó. Trừ phi thực thể trong nguồn cấp dữ liệu là thực thể mới hơn, còn thực thể sắp tới sẽ bị đánh dấu là cũ. Đối với tất cả mã nhận dạng thực thể được đề cập trong phần mô tả lỗi, Google phải đảm bảo rằng dấu thời gian trong nguồn cấp dữ liệu mới hơn dấu thời gian được đặt trong các nội dung cập nhật thực thể mà Google gửi trước đó cho Google. Bạn có thể tham khảo phần tạo phiên bản thực thể để hiểu rõ hơn.