Artikel ini membahas proses mengaktifkan API menu untuk akun Anda dan berintegrasi dengannya. Di bawah ini adalah ringkasan mendetail tentang proses orientasi dan prasyarat peluncuran. Lihat 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 Portal Partner telah dikonfigurasi sepenuhnya dan siap menerima feed data yang relevan untuk data menu statis. Jika Anda sudah memiliki integrasi OwG Redirect atau RwG aktif yang Anda tambahkan metadata menu, akun yang sudah ada akan digunakan kembali untuk integrasi ini. Jika ada integrasi OwG Langsung di platform ini atau tanpa integrasi sama sekali, akun baru akan dibuat dan detail aksesnya akan dibagikan melalui email.
Akses akun Anda di Partner Portal dan buka halaman konfigurasi dropbox Konfigurasi > Feed. Ada dua dropbox yang relevan untuk integrasi feed data menu: Generic dan Merchants. Pastikan kedua dropbox memiliki kunci publik SSH yang sudah dikonfigurasi. 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 diberi nama google.food_menu dan biasanya
diaktifkan untuk akun Anda secara default pada awal
aktivasi. 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. Perbaiki dan coba lagi.", hubungi kontak Google Anda untuk mengaktifkan jenis feed ini.
Terakhir, buka halaman Konfigurasi > Informasi Kontak dan pastikan semua detail kontak Anda sudah diperbarui.
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 diharapkan mulai diproses dalam waktu satu jam setelah pengiriman. Feed produksi diproses sekali setiap hari pada pukul 24.00 di zona waktu PST - hanya feed terbaru yang dikirimkan yang akan diproses untuk diproses. Harap lihat spesifikasi dan contoh feed data saat berupaya membuat feed Anda. Meskipun spesifikasi disajikan dalam format protobuf, sebaiknya upload file feed dalam format JSON karena lebih mudah untuk memecahkan masalah. Oleh karena itu, contoh feed juga disediakan dalam format JSON.
Satu file feed data dapat diuji dengan cepat menggunakan alat online validator feed yang memverifikasi apakah file tersebut sesuai dengan spesifikasi. Alat ini akan menunjukkan apakah file tersebut cocok dengan skema data dan 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 Portal Partner. 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 dengan benar seluruh inventaris menu restoran.
Luncurkan prasyarat
Kondisi ini 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 di 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 akan 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 nama hidangan, harga, dll. Jika temuan tersebut ditemukan, masukan akan disampaikan kepada tim pengembangan.