Bài viết này trình bày quy trình bật API trình đơn cho tài khoản của bạn và tích hợp với API đó. Dưới đây là thông tin tổng quan chi tiết về quy trình tham gia và các điều kiện tiên quyết để khởi chạy. Vui lòng tham khảo trang này khi bạn lên kế hoạch tích hợp.
- Thiết lập – định cấu hình tài khoản và lập kế hoạch cho quá trình phát triển.
- Phát triển – phát triển và thử nghiệm nguồn cấp dữ liệu.
- Ra mắt: đánh giá dữ liệu trước khi triển khai.
Thiết lập
Ở giai đoạn này, bạn cần xác nhận rằng tài khoản của mình trên Cổng đối tác đã được định cấu hình đầy đủ và sẵn sàng chấp nhận những nguồn cấp dữ liệu liên quan đến dữ liệu tĩnh của trình đơn. Nếu bạn đang thêm siêu dữ liệu thực đơn (OwG Redirect) hoặc RwG đang hoạt động, thì tài khoản hiện có của bạn sẽ được dùng lại cho chức năng tích hợp này. Trong trường hợp tích hợp OwG Direct trên nền tảng này hoặc không tích hợp nào, thì một tài khoản mới sẽ được tạo và thông tin truy cập sẽ được chia sẻ qua email.
Truy cập vào tài khoản của bạn trên Cổng đối tác và chuyển đến trang cấu hình dropbox Cấu hình > Nguồn cấp dữ liệu. Có hai tài khoản dropbox phù hợp với việc tích hợp nguồn cấp dữ liệu thực đơn: Chung và Người bán. Vui lòng kiểm tra để đảm bảo cả hai dropbox đều có khoá công khai SSH được định cấu hình. Để biết thêm thông tin về cách định cấu hình khoá SSH, hãy xem trang này.
Tài khoản dropbox chung có thể chấp nhận nhiều nguồn cấp dữ liệu có thể tuân theo nhiều giản đồ dữ liệu. Loại nguồn cấp dữ liệu chấp nhận dữ liệu trình đơn có cấu trúc có tên là google.food_menu và thường được bật cho tài khoản của bạn theo mặc định khi bắt đầu quá trình làm quen. Trong trường hợp bạn cố gắng gửi nguồn cấp dữ liệu và thấy thông báo lỗi này –
"Xử lý nguồn cấp dữ liệu không thành công. Chúng tôi đã gặp một vấn đề nội bộ khi phân tích cú pháp nguồn cấp dữ liệu của bạn. "google.food_menu" chưa được bật. Vui lòng khắc phục rồi thử lại.", vui lòng liên hệ với đầu mối liên hệ của bạn tại Google để bật loại nguồn cấp dữ liệu này.
Cuối cùng, vui lòng chuyển đến trang Cấu hình > Thông tin liên hệ và đảm bảo rằng mọi thông tin liên hệ của bạn đều đã cập nhật.
Quá trình phát triển
Giai đoạn phát triển chứa phần chính của nỗ lực triển khai, đó là tạo và kiểm thử nguồn cấp dữ liệu. Nguồn cấp dữ liệu phải được tạo và gửi đến tài khoản đăng đích hằng ngày. Nguồn cấp dữ liệu được gửi trong hộp cát dự kiến sẽ bắt đầu xử lý trong vòng một giờ sau khi gửi. Nguồn cấp dữ liệu sản xuất được xử lý vào lúc 12 giờ trưa mỗi ngày theo múi giờ PST. Nguồn cấp dữ liệu sản xuất chỉ được lấy để xử lý. Vui lòng tham khảo quy cách của nguồn cấp dữ liệu và mẫu của nguồn cấp dữ liệu khi bạn tạo nguồn cấp dữ liệu. Mặc dù quy cách được trình bày ở định dạng protobuf, nhưng bạn nên tải tệp nguồn cấp dữ liệu lên ở định dạng JSON vì như vậy sẽ dễ khắc phục sự cố hơn. Do đó, chúng tôi cũng cung cấp mẫu nguồn cấp dữ liệu ở định dạng JSON.
Bạn có thể nhanh chóng kiểm tra một tệp nguồn cấp dữ liệu bằng công cụ trực tuyến trình xác thực nguồn cấp dữ liệu để xác minh xem tệp đó có phù hợp với quy cách hay không. Công cụ này sẽ cho biết liệu tệp có khớp với giản đồ dữ liệu hay không và nếu không khớp, thì công cụ sẽ xuất ra danh sách lỗi. Để thử nghiệm toàn bộ nguồn cấp dữ liệu chứa nhiều tệp, hãy tải nguồn cấp dữ liệu đó lên trong môi trường hộp cát và sau khi quá trình nhập hoàn tất, hãy xem kết quả trên Cổng đối tác. Trong quá trình nhập nguồn cấp dữ liệu, chúng tôi sẽ áp dụng thêm các quy tắc xác thực để kiểm tra một số logic kinh doanh và chất lượng của dữ liệu.
Launch
Giai đoạn ra mắt có thể bắt đầu sau khi mọi công việc tích hợp hoàn tất và nguồn cấp dữ liệu sản xuất phản ánh chính xác toàn bộ kho hàng của thực đơn nhà hàng.
Chạy các điều kiện tiên quyết
Quá trình tích hợp phải đáp ứng các điều kiện sau:
- Nguồn cấp dữ liệu được xử lý trong môi trường phát hành công khai và không có lỗi nào.
- Nguồn cấp dữ liệu thực tế chứa toàn bộ khoảng không quảng cáo trong phạm vi hoạt động tích hợp này khi bắt đầu quá trình tích hợp này.
- Phần lớn dữ liệu của người bán trùng khớp với vị trí trên Google Maps.
- Nguồn cấp dữ liệu sản xuất đã vượt qua quy trình đánh giá chất lượng dữ liệu.
- Quy trình tích hợp này đáp ứng tất cả các Chính sách và yêu cầu về thực đơn.
Đánh giá dữ liệu
Sau khi bạn nhập nguồn cấp dữ liệu sản xuất mà không gặp lỗi, có thể sẽ có một quy trình nội bộ để đánh giá chất lượng của dữ liệu trình đơn. Quy trình này nhằm tìm ra những điểm không thống nhất về chất lượng dữ liệu, chẳng hạn như nội dung không liên quan đến thực phẩm trong nội dung mô tả món ăn, tên món ăn và giá không khớp, v.v. Trong trường hợp có phát hiện như vậy, chúng tôi sẽ chia sẻ ý kiến phản hồi với nhóm phát triển.