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 làm quen và các điều kiện tiên quyết để ra mắt. Vui lòng tham khảo trang này khi 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 quy trình phát triển.
- Phát triển – phát triển và kiểm thử nguồn cấp dữ liệu.
- Ra mắt – đánh giá dữ liệu trước khi ra mắt.
Thiết lập
Ở giai đoạn này, điều quan trọng là bạn phải xác nhận rằng tài khoản của mình trên Partner Portal (Cổng thông tin đối tác) đã được định cấu hình đầy đủ và sẵn sàng chấp nhận nguồn cấp dữ liệu liên quan đến dữ liệu trình đơn tĩnh. Nếu bạn đang tích hợp tính năng Chuyển hướng OwG hoặc RwG đang hoạt động và bạn đang thêm siêu dữ liệu của trình đơn, thì tài khoản hiện tại của bạn sẽ được sử dụng lại cho tính 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, hệ thống sẽ tạo một tài khoản mới và chia sẻ thông tin truy cập qua email.
Truy cập vào tài khoản của bạn trên Partner Portal (Cổng thông tin đối tác) rồi chuyển đến trang cấu hình hộp thư thả xuống Cấu hình > Nguồn cấp dữ liệu. Có hai hộp thả xuống liên quan đến 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 đã định cấu hình khoá công khai SSH. Để biết thêm thông tin về cách định cấu hình khoá SSH, hãy xem trang này.
Hộp thả dữ liệu chung có thể chấp nhận nhiều nguồn cấp dữ liệu 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ạn bắt đầu 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 –
"Không xử lý được nguồn cấp dữ liệu. Chúng tôi gặp sự cố nội bộ khi phân tích cú pháp nguồn cấp dữ liệu của bạn. Bạn chưa bật "google.food_menu". 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 tất cả thông tin liên hệ của bạn đều mới 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 – tạo và kiểm thử nguồn cấp dữ liệu. Bạn phải tạo và gửi nguồn cấp dữ liệu đến hộp thư mục mục tiêu mỗi ngày. Các 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 chính thức được xử lý một lần mỗi ngày lúc 12 giờ trưa theo múi giờ PST – chỉ nguồn cấp dữ liệu mới nhất được gửi mới được xử lý. Vui lòng tham khảo quy cách và mẫu của nguồn cấp dữ liệu khi tạo nguồn cấp dữ liệu. Mặc dù thông số kỹ thuật đượ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ì dễ khắc phục sự cố hơn. Vì lý do đó, mẫu nguồn cấp dữ liệu cũng được cung cấp ở định dạng JSON.
Bạn có thể kiểm tra nhanh 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. Công cụ này sẽ xác minh xem tệp đó có tương ứng với thông số kỹ thuật hay không. Công cụ này cho biết liệu tệp có khớp với giản đồ dữ liệu hay không. Nếu không, công cụ này sẽ xuất ra danh sách lỗi. Để kiểm thử toàn bộ nguồn cấp dữ liệu bao gồm 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 truyền dẫn nguồn cấp dữ liệu, có các quy tắc xác thực bổ sung được áp dụng để kiểm thử một số logic nghiệp vụ và chất lượng dữ liệu.
Khởi chạy
Bạn có thể bắt đầu giai đoạn ra mắt sau khi hoàn tất mọi công việc tích hợp và nguồn cấp dữ liệu chính thức phản ánh chính xác toàn bộ kho hàng của thực đơn nhà hàng.
Điều kiện tiên quyết để chạy
Bạn phải đáp ứng các điều kiện sau để có thể tích hợp:
- Nguồn cấp dữ liệu được xử lý trong môi trường chính thức mà không có lỗi nào.
- Nguồn cấp dữ liệu sản xuất chứa toàn bộ khoảng không quảng cáo trong phạm vi tích hợp này khi bắt đầu tích hợp.
- Phần lớn dữ liệu người bán của bạn khớp với các vị trí trên Google Maps.
- Nguồn cấp dữ liệu chính thức đã vượt qua quy trình đánh giá chất lượng dữ liệu.
- Tính năng tích hợp này đáp ứng tất cả Yêu cầu và chính sách về thực đơn.
Đánh giá dữ liệu
Sau khi nguồn cấp dữ liệu sản xuất được nhập mà không có lỗi, có thể 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 nhất quán 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 phần mô tả món ăn, tên món ăn không khớp, giá, v.v. Trong trường hợp phát hiện những vấ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.