Tính năng cung cấp dữ liệu theo lô cho 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ính năng Đặt hàng toàn diện.
Google tìm nạp và xử lý nguồn cấp dữ liệu được lưu trữ trên nền tảng lưu trữ. Sau khi nhập thành công, tính năng Đặt hàng toàn diện sẽ cung cấp thông tin về trạng thái nhập, tệp mới tải lên, tổng số tệp, lỗi và cảnh báo, v.v.
Bài viết này trình bày chi tiết về hầu hết các lỗi nguồn cấp dữ liệu hàng loạt trong Trung tâm hành động, ý nghĩa của các lỗi đó và cách khắc phục. Đường siêu liên kết sẽ đưa bạn đến trang giản đồ kho hàng quan hệ. Trang này cung cấp thêm ngữ cảnh, chẳng hạn 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ể.
Bạn có thể xem lỗi nguồn cấp dữ liệu hàng loạt trong Actions Center ở đâu?
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ính năng Đặt hàng toàn diện. Để biết thêm về cách lưu trữ nguồn cấp dữ liệu, hãy xem bài viết Quy trình truyền dẫn hàng loạt.
Sau khi bạn tải tệp nguồn cấp dữ liệu lên, Google sẽ tìm nạp và xử lý các tệp đó. Nếu có vấn đề, các vấn đề đó sẽ xuất hiện dưới dạng lỗi. Sau đây là các bước để xem lỗi của nguồn cấp dữ liệu hàng loạt trong Trung tâm hành động.
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ý.
Chọn môi trường (Sản xuất hoặc Hộp cát), sau đó nhấp vào thẻ Nhật ký truyền dẫn
Nhập giai đoạn xem lại để xem nhật ký nhập trong X ngày qua
Để biết thêm thông tin chi tiết về lỗi của 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 (→)
Sau đó, bạn có thể xem thêm thông tin chi tiết về lỗi và cảnh báo
Dưới đây là danh sách các lỗi 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
|
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ể Trình đơn bị lỗi trong nguồn cấp dữ liệu và thêm các mục trong Trình đơn. |
Dữ liệu không chính xác – maxPriceDữ liệu không chính xác cho trường maxPrice
|
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 – eligibleQuantityMaxDữ liệu không chính xác cho trường eligibleQuantityMax
|
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 – leadTimeMaxDữ liệu không chính xác cho trường leadTimeMax
|
Trường leadTimeMax yêu cầu giá trị số nguyên. Ví dụ: 12.
Lỗi này sẽ xảy ra với bất kỳ loại dữ liệu nào khác, ngay cả double (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 đó là một số nguyên.
|
Dữ liệu không chính xác – validFromDữ liệu không chính xác cho trường validFrom
|
Giá trị cho trường validFrom dự kiến sẽ có đị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 ServiceHours lồng nhau |
Thực thể OperationHours đã được xác định nhưng không có thực thể ServiceHours hợp lệ tương ứng với thực thể đó. | Đố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 được xác định đúng cách tương ứng với mã nhận dạng đó hay không.
Ví dụ: nếu thông báo lỗi là "Mã thực thể: store-1:DELIVERY OperationHour không chứa ServiceHours lồng nhau" và giả sử rằng Mã thực thể của thực thể OperationHours là "store-1:DELIVERY:operation_hours" – hãy kiểm tra xem có thực thể serviceHours nào liên kết với ServiceID "store-1:DELIVERY" và OperationHoursID "store-1:DELIVERY:operation_hours" hay không
|
Dữ liệu không chính xác – advanceBookingRequirementMinDữ liệu không chính xác cho trường advanceBookingRequirementMin
|
Trường advanceBookingRequirementMin yêu cầu giá trị số nguyên. Ví dụ: 12.
Lỗi này sẽ xảy ra với bất kỳ loại dữ liệu nào khác, ngay cả double (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 đó là một số nguyên.
|
Dữ liệu không chính xác – availabilityStartsDữ liệu không chính xác cho trường availabilityStarts
|
Giá trị cho trường availabilityStarts dự kiến sẽ có đị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 – closesDữ liệu không chính xác cho trường closes
|
Giá trị cho trường closes dự kiến sẽ có đị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 – dateModifiedDữ liệu không chính xác cho trường dateModified
|
Giá trị cho trường dateModified dự kiến sẽ có đị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 – discountDữ liệu không chính xác cho trường discount
|
Trường discount cần có 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 giá trị là số.
Ví dụ: 10
|
Dữ liệu không chính xác – discountPercentageDữ liệu không chính xác cho trường discountPercentage
|
Trường discountPercentage cần có 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 giá trị là số.
Ví dụ: 15
|
Dữ liệu không chính xác – geoRadiusDữ liệu không chính xác cho trường geoRadius
|
Trường geoRadius yêu cầu 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 đó là một số nguyên.
Ví dụ: 10000 |
Dữ liệu không chính xác – imageDữ liệu không chính xác cho trường image
|
Trường image yêu cầu một URL hợp lệ và sẽ gửi lỗi nếu phát hiện thấy bất kỳ nội dung nào khác.
|
Kiểm tra xem giá trị của trường image có phải là một chuỗi URL hợp lệ hay không
|
Dữ liệu không chính xác – latitudeDữ liệu không chính xác cho trường latitude
|
Trường latitude dự kiến loại giá trị là double
|
Đối với mã nhận dạng thực thể thuộc loại Nhà hàng được đề cập trong nội dung mô tả lỗi, hãy đảm bảo rằng giá trị của trường latitude là số thực.
Ví dụ: 35,4565 |
Dữ liệu không chính xác – leadTimeMinDữ liệu không chính xác cho trường leadTimeMin
|
Trường leadTimeMin yêu cầu giá trị số nguyên. Ví dụ: 12.
Lỗi này sẽ xảy ra với bất kỳ loại dữ liệu nào khác, ngay cả double (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 đó là một số nguyên.
|
Dữ liệu không chính xác – longitudeDữ liệu không chính xác cho trường longitude
|
Trường longitude dự kiến loại giá trị là double
|
Đối với mã nhận dạng thực thể thuộc loại Nhà hàng được đề cập trong nội dung mô tả lỗi, hãy đảm bảo rằng giá trị của trường longitude là số thực.
Ví dụ: 35,4565 |
Dữ liệu không chính xác – menuIdDữ liệu không chính xác cho trường menuId
|
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 – nameDữ liệu không chính xác cho trường name
|
Giá trị cho 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.caloriesDữ liệu không chính xác cho trường nutrition.calories
|
Giá trị cho trường calories cần phải là một chuỗi ở đị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 ở định dạng chính xác.
Ví dụ: "123,32 Cal" |
Dữ liệu không chính xác – opensDữ liệu không chính xác cho trường opens
|
Giá trị cho trường opens dự kiến sẽ có đị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 – priceDữ liệu không chính xác cho trường price
|
Trường price cần có 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 giá trị là số.
Ví dụ: 15,4 |
Dữ liệu không chính xác – skuDữ liệu không chính xác cho trường sku
|
Giá trị cho 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 – validFromDữ liệu không chính xác cho trường validFrom
|
Giá trị cho trường validFrom dự kiến sẽ có đị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 nội dung mô tả lỗi, hãy đảm bảo rằng giá trị cho 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 – validThroughDữ liệu không chính xác cho trường validThrough
|
Giá trị cho trường validThrough dự kiến sẽ có định dạng dấu thời gian ISO với loại Chuỗi.
Ngoài ra, giá trị cho 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 nội dung mô tả lỗi, hãy đảm bảo rằng giá trị cho 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 – valueDữ liệu không chính xác cho trường value
|
trường value chỉ bắt buộc khi bạn xác định Optiontype. Phương thức này yêu cầu một Chuỗi hoặc Enum value. Xin lưu ý rằng các giá trị Enum dành riêng cho loại tuỳ chọn PIZZA_SIDE.
|
Đối với mã nhận dạng thực thể được đề cập trong nội dung mô tả lỗi, hãy kiểm tra xem trường value có chứa 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 xảy ra khi kích thước của 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. Tổng dung lượng của các thực thể cấp cao nhất là Nhà hàng, Dịch vụ và Trình đơ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 kích thước của tệp trình đơn nằm trong giới hạn đượ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 đầu vào.
|
addressCountry là trường bắt buộc và bị thiếu trong thực thể Nhà hàng
|
Đối với mã nhận dạng thực thể được đề cập trong nội dung 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 đầu vào.
|
addressLocality là trường bắt buộc và bị thiếu trong thực thể Nhà hàng
|
Đối với mã nhận dạng thực thể được đề cập trong nội dung 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 đầu vào.
|
addressRegion là trường bắt buộc và bị thiếu trong thực thể Nhà hàng
|
Đối với mã nhận dạng thực thể được đề cập trong nội dung 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/Đi mang về không có phí giao hàng |
Thực thể thuộc loại Phí không liên kết với bất kỳ price nào cho dịch vụ giao/mang đi
|
Đối với mã nhận dạng thực thể được đề cập trong nội dung mô tả lỗi, hãy đảm bảo rằng bạn đã thiết lập đúng cách thực thể Phí cho ServiceType (Loại dịch vụ) của dịch vụ giao hàng/mang đi 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.
|
Đối với giá trị của Phí, bạn cần đặt đúng một trong các price, pricePerMeter or percentageOfCart .
|
Đối với mã nhận dạng thực thể được đề cập trong nội dung mô tả lỗi, hãy đảm bảo rằng bạn chỉ đặt một trong các price, pricePerMeter or percentageOfCart .
|
Thiếu dữ liệu – geoMidpointLatitude
Thiếu trường bắt buộc geoMidpointLatitude trong dữ liệu đầu vào.
|
Khi xác định ServiceArea, bạn phải có geoMidpointLatitude cùng với geoMidpointLongitude khi sử dụng geoRadius.
|
Đối với mã nhận dạng thực thể được đề cập trong nội dung 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 loại 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 phải 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 nội dung 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 loại double.
Ví dụ: 122.4565 |
| Thiếu dữ liệu – MenuItemOption
MenuItemOffer là bắt buộc đối với MenuItemOption |
Đối với mỗi MenuItemOption, cần có một thực thể MenuItemOffer tương ứng | Đảm bảo rằng đối với tất cả mã mặt hàng trong phần mô tả lỗi, tất cả thực thể MenuItemOption đều có một thực thể MenuItemOffer được xác định đúng cách. |
| Thiếu dữ liệu – OperationHours
Thiếu giờ hoạt động của dịch vụ |
Một thực thể dịch vụ Giao hàng/Điểm bán mang đi bị thiếu thực thể OperationHours tương ứng. OperationHours mô tả khoảng thời gian đặt hàng mà người dùng có thể truy cập vào quy trình và đặt hàng càng sớm càng tốt hoặc đặ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 thực thể OperationHours được xác định đúng cách. |
Thiếu dữ liệu – postalCode
Thiếu trường bắt buộc postalCode trong dữ liệu đầu vào.
|
postalCode là trường bắt buộc và bị thiếu trong thực thể Nhà hàng
|
Đối với mã nhận dạng thực thể được đề cập trong nội dung 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 đầu vào.
|
Trường priceCurrency trống hoặc chứa giá trị không chính xác. Phương thức này yêu cầu mã tiền tệ ISO 4217 gồm 3 chữ cái.
|
Đối với mã nhận dạng thực thể được mô tả trong nội dung mô tả lỗi, hãy đảm bảo rằng trường priceCurrency là một Chuỗi không trống có mã tiền tệ 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 "DELIVERY"
|
Đảm bảo rằng đối với mã nhận dạng thực thể Dịch vụ đượ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 đầu vào.
|
streetAddress là trường bắt buộc và bị thiếu trong thực thể 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, kiểm tra xem trường streetAddress có phải là 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 Đặt hàng toàn diện sẽ so sánh dấu thời gian ngày 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 mới hơn, thực thể sắp tới sẽ được đánh dấu là cũ. | Đối với tất cả mã nhận dạng thực thể được đề cập trong nội dung 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 bản cập nhật thực thể trước đó đã gửi đến Google. Bạn có thể tham khảo phần phiên bản thực thể để biết thêm thông tin. |