Artikel ini membahas proses mengaktifkan API menu untuk akun Anda dan berintegrasi dengannya. Berikut adalah ringkasan mendetail tentang proses orientasi dan prasyarat peluncuran. Harap referensikan halaman ini saat merencanakan upaya integrasi.
- Penyiapan - konfigurasi akun dan perencanaan proses pengembangan.
- Pengembangan - pengembangan dan pengujian feed data.
- Peluncuran - evaluasi data sebelum peluncuran.
Penyiapan
Pada tahap ini, penting untuk mengonfirmasi bahwa akun Anda di Partner Portal telah dikonfigurasi sepenuhnya dan siap menerima feed data yang relevan untuk data menu statis. Jika Anda sudah memiliki integrasi Redirect OwG atau RwG aktif yang akan Anda gunakan untuk menambahkan metadata menu, akun yang ada akan digunakan kembali untuk integrasi ini. Jika ada integrasi OwG Direct di platform ini atau tidak ada integrasi sama sekali, akun baru akan dibuat dan detail akses akan dibagikan melalui email.
Akses akun Anda di Partner Portal dan buka halaman konfigurasi dropbox Konfigurasi > Feed. Ada dua drop-down yang relevan untuk integrasi feed data menu: Generic dan Merchants. Pastikan kedua dropbox telah mengonfigurasi kunci publik SSH. Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi kunci SSH, lihat halaman ini.
Dropbox generik dapat menerima berbagai feed yang dapat mengikuti skema data yang berbeda. Jenis feed
yang menerima data menu terstruktur bernama google.food_menu dan
biasanya diaktifkan untuk akun Anda secara default di awal
orientasi. Jika Anda mencoba mengirimkan feed dan melihat pesan error ini -
"Pemrosesan feed gagal. Kami mengalami masalah internal saat mengurai feed Anda. 'google.food_menu' tidak diaktifkan. Harap perbaiki dan coba lagi.", hubungi kontak dukungan pelanggan Google Anda untuk mengaktifkan jenis feed ini.
Terakhir, buka halaman Konfigurasi > Informasi Kontak dan pastikan semua detail kontak Anda sudah yang terbaru.
Pengembangan
Tahap pengembangan berisi bagian utama dari upaya penerapan - membuat dan menguji feed data. Feed data harus dibuat dan dikirim ke dropbox target setiap hari. Feed yang dikirimkan di sandbox diperkirakan akan mulai diproses dalam waktu satu jam setelah pengiriman. Feed produksi diproses sekali setiap hari pukul 12.00 di zona waktu PST - hanya feed terbaru yang dikirim yang akan diproses. Lihat spesifikasi dan contoh feed data saat membuat feed. Meskipun spesifikasi ditampilkan dalam format protobuf, sebaiknya upload file feed dalam format JSON karena lebih mudah dipecahkan masalahnya. Oleh karena itu, contoh feed juga disediakan dalam format JSON.
Satu file feed data dapat diuji dengan cepat menggunakan alat online feed validator yang memverifikasi apakah file tersebut sesuai dengan spesifikasi. Alat ini menunjukkan apakah file cocok dengan skema data atau tidak. Jika tidak, alat ini akan menampilkan daftar error. Untuk menguji seluruh feed data yang terdiri dari beberapa file, upload feed tersebut di lingkungan sandbox dan setelah penyerapan selesai, lihat hasilnya di Partner Portal. Selama penyerapan feed, ada aturan validasi tambahan yang diterapkan untuk menguji beberapa logika bisnis dan kualitas data.
Luncurkan
Tahap peluncuran dapat dimulai setelah semua pekerjaan integrasi selesai dan feed produksi mencerminkan seluruh inventaris menu restoran dengan benar.
Prasyarat peluncuran
Kondisi berikut harus dipenuhi agar integrasi dapat diluncurkan:
- Feed data diproses di lingkungan produksi dengan 0 error.
- Feed data produksi berisi inventaris lengkap yang dicakup untuk integrasi ini pada awal integrasi ini.
- Sebagian besar data penjual Anda cocok dengan lokasi Google Maps.
- Feed produksi lulus evaluasi kualitas data.
- Integrasi ini memenuhi semua Kebijakan dan Persyaratan Menu Makanan.
Evaluasi data
Setelah feed data produksi diserap tanpa error, mungkin ada proses internal untuk mengevaluasi kualitas data menu. Proses ini bertujuan untuk menemukan inkonsistensi dalam kualitas data, seperti konten yang tidak terkait dengan makanan dalam deskripsi hidangan, ketidakcocokan dalam nama hidangan, harga, dll. Jika ada temuan tersebut, masukan akan dibagikan kepada tim pengembangan.