Xem xét ngữ nghĩa của nguồn cấp dữ liệu
Ngữ nghĩa cho nguồn cấp dữ liệu bài đánh giá có một chút khác biệt:
Đối với nguồn cấp dữ liệu tổng quan nhanh về bài đánh giá:
- Mọi nhà cung cấp dịch vụ trong nguồn cấp dữ liệu bài đánh giá, nếu nhà cung cấp hiện không có trong cơ sở dữ liệu nhà cung cấp LSA, thì các bài đánh giá của nhà cung cấp sẽ không được nhập.
- Mọi nhà cung cấp dịch vụ trong nguồn cấp dữ liệu bài đánh giá, nếu nhà cung cấp đó hiện có trong cơ sở dữ liệu nhà cung cấp LSA, thì các bài đánh giá của nhà cung cấp đó sẽ được xử lý như sau:
- Đối với mọi bài đánh giá trong nguồn cấp dữ liệu, nếu bài đánh giá tương ứng không tồn tại trong bộ nhớ LSA, thì bạn nên tạo bài đánh giá đó.
- Đối với mọi bài đánh giá trong nguồn cấp dữ liệu, nếu có bài đánh giá tương ứng trong bộ nhớ LSA, thì bài đánh giá đó sẽ được cập nhật thông tin mới.
- Đối với mọi bài đánh giá không có trong nguồn cấp dữ liệu, nếu bài đánh giá tương ứng có trong bộ nhớ LSA, thì bài đánh giá đó sẽ bị xoá.
- Nếu nhà cung cấp dịch vụ không có trong nguồn cấp dữ liệu bài đánh giá và hiện có trong cơ sở dữ liệu nhà cung cấp LSA, thì các bài đánh giá của họ sẽ bị xoá và nhà cung cấp sẽ ngừng phân phát.
- Xin lưu ý rằng nhà cung cấp có 0 bài đánh giá cũng phải có một mục nhập (thay vì bị bỏ qua) trong nguồn cấp dữ liệu bài đánh giá để họ có thể phân phát (xem Nguồn cấp dữ liệu bài đánh giá mẫu – listingId 2)
Xin lưu ý rằng nguồn cấp dữ liệu đánh giá không hỗ trợ tính năng tăng dần. Bạn phải có một nguồn cấp dữ liệu bài đánh giá tương ứng cho mỗi nguồn cấp dữ liệu hồ sơ.
Xử lý lỗi đối với bài đánh giá
Nếu một mục trong nguồn cấp dữ liệu bài đánh giá không hợp lệ, chúng tôi sẽ bỏ qua việc xử lý mục đó và tiếp tục xử lý các mục còn lại hợp lệ trong nguồn cấp dữ liệu.
Nếu nguồn cấp dữ liệu bài đánh giá không hợp lệ (ví dụ: không tuân thủ giản đồ), chúng tôi sẽ ngừng xử lý toàn bộ nguồn cấp dữ liệu bài đánh giá.
Xem xét các trường
| Tên trường | Loại | Mô tả | Ví dụ: | Bắt buộc | Giới hạn |
|---|---|---|---|---|---|
| serviceProviderId | số | Giá trị nhận dạng riêng biệt của một trang thông tin (nhà cung cấp dịch vụ) | 12345 | Có | Phải phù hợp với int64 |
| ratingCount | số nguyên | Số lượng điểm xếp hạng đã được xác minh của người tiêu dùng | 10 | Có | Phải từ 0 trở lên. |
| author | chuỗi | Tên tác giả của bài đánh giá | "Jack L." | Không | |
| reviewId | chuỗi | Mã nhận dạng duy nhất của bài đánh giá. Nếu mỗi bài đánh giá không có một mã nhận dạng riêng biệt, thì bên thứ ba cần tạo một mã nhận dạng riêng biệt cho mỗi bài đánh giá (ví dụ: hàm băm của văn bản bài đánh giá và người dùng), ít nhất là riêng biệt trong số tất cả các bài đánh giá của một nhà cung cấp. | "123" | Có | |
| reviewText | chuỗi | Văn bản bài đánh giá do tác giả viết | "Bạn làm tốt lắm!" | Không | |
| rating | số nguyên | Mức phân loại (phải là số nguyên từ 1 đến 5) | 4 | Có | Phải là một số nguyên từ 1 đến 5. |
| serviceLocationCity | chuỗi | Thành phố nơi dịch vụ được thực hiện | "New York" | Không | |
| reviewTimestampMicros | số nguyên | Dấu thời gian cho biết thời điểm viết bài đánh giá ở định dạng vi giây. | 1.45142E+15 | Không | |
| serviceTimestampMicros | số nguyên | Dấu thời gian khi dịch vụ hoàn tất ở định dạng vi giây. | 1.45132E+15 | Không | |
| language | chuỗi | Ngôn ngữ của văn bản đánh giá theo mã ngôn ngữ ISO 639-1 (chữ thường, 2 chữ cái). Phải khớp với ngôn ngữ nhắm mục tiêu của nhà cung cấp. | “en” | Không | Phải khớp với ngôn ngữ nhắm mục tiêu được chỉ định cho nhà cung cấp được liên kết. Mặc định là "en" nếu bạn không chỉ định. |
| category | đối tượng | cấu trúc danh mục | Không | ||
| category->categoryId | enum | danh mục dịch vụ (trong hệ thống phân loại quảng cáo dịch vụ tại địa phương) | "garage_door_pro" | Không | |
| category->task | enum | Loại công việc (nhiệm vụ) của dịch vụ (trong Hệ thống phân loại LSA) | "Sửa cửa gara" | Không | |
| confirmedCustomer | boolean | Nếu bài đánh giá đến từ một khách hàng đã xác nhận (có khách hàng tiềm năng) | TRUE | Không |