Feed menyediakan data inventaris Anda ke Actions Center. Upload Secure File Transfer Protocol (SFTP) harian ini memperbarui semua data penjual, layanan, dan slot ketersediaan. Feed menentukan penjual yang Anda dukung, ketersediaan mereka, dan fitur khusus yang diperlukan untuk mengonfirmasi bahwa Google menampilkan inventaris Anda dengan benar. Feed diupload ke dropbox SFTP yang dikonfigurasi saat Anda memberikan kunci SSH di Penyiapan.
Anda harus menyelesaikan tugas Feeds Ready berikut sebelum beralih ke Server Pemesanan:
Tugas akan ditandai sebagai selesai dan berubah menjadi hijau setelah Anda berhasil mengupload feed. Tinjau dokumentasi yang ditautkan untuk menyelesaikan setiap tugas pencapaian tertentu.
Agar fungsi integrasi Pemesanan Restoran secara End-to-End berfungsi dengan baik, Anda harus menyediakan upload Feed Penjual, Feed Layanan, dan Feed Ketersediaan harian secara otomatis. Infrastruktur feed otomatis Anda harus menyediakan inventaris lengkap Anda.
Jenis feed
Integrasi Menyeluruh Reservasi Tempat Makan memerlukan feed berikut dan frekuensi uploadnya:
| Feed | Deskripsi | Frekuensi | Contoh |
|---|---|---|---|
| Penjual | Mendeskripsikan penjual Anda. | Setiap 24 jam sekali | Contoh Feed Penjual |
| Layanan | Deskripsikan layanan penjual Anda. | Setiap 24 jam sekali | Contoh Feed Layanan |
| Ketersediaan | Mendeskripsikan slot yang tersedia untuk layanan penjual Anda. Cakupan minimal 30 hari harus diberikan. Untuk memperpanjang cakupan hingga 90 hari, hubungi dukungan Google melalui formulir kontak Pusat Tindakan. | Setiap 24 jam sekali | Contoh Feed Ketersediaan |
Format feed dideskripsikan dengan sintaksis protocol buffer 3, tetapi Anda dapat mengupload feed sesuai dengan format JSON yang sesuai. Lihat contoh feed untuk format JSON. Sebaiknya Anda mengupload feed dalam format JSON.
Konvensi penamaan dan metadata
Nama file
Jika Anda menggunakan sharding, feed yang Anda upload harus memiliki nama unik yang menentukan jenis dan jumlah feed. Stempel waktu untuk pembuatan feed memenuhi persyaratan unik penamaan file feed Anda.
Struktur: {feed_name}_{timestamp_epoch}_{shard_nunber}_{total_shard}.json
Contoh: availability_feed_1574117613_001_of_002.json.gz
Menentukan ID
Saat Anda menentukan ID untuk penjual atau atribut lain yang memerlukan ID, sebaiknya gunakan UID atau UUID. Anda dapat memberikan solusi alfanumerik Anda sendiri selama ID tetap berbeda di seluruh platform Anda.
Metadata
Saat Anda membuat feed, generation_timestamp harus mencerminkan waktu saat
data diambil dari database. Penggunaan kembali nilai ini di seluruh feed dapat menyebabkan error pemrosesan.
Nilai nonce, angka acak atau tidak berulang, harus unik di seluruh jenis feed dan tidak dapat digunakan kembali. Nilai harus cocok untuk semua file dalam feed yang di-shard tertentu.
Ukuran file feed
Melakukan sharding file feed
Berdasarkan inventaris Anda, sharding atau pemecahan feed menjadi beberapa file mungkin diperlukan. Feed Anda mungkin perlu dipecah dalam kondisi berikut:
- Feed gzip terkompresi melebihi 200 MB untuk satu file.
- Contoh: Feed Ketersediaan yang dibuat berukuran 1 GB. Data ini harus dibagi menjadi lima atau lebih shard terpisah.
- Inventaris partner didistribusikan di seluruh sistem atau wilayah yang menyebabkan
kesulitan mencocokkan inventaris.
- Contoh: partner memiliki inventaris Amerika Serikat dan Uni Eropa yang berada di sistem terpisah.
Feed dapat dibuat dengan dua shard. Satu untuk Amerika Serikat dan satu untuk Uni Eropa dengan nonce dan
generation_timestampyang sama.
- Contoh: partner memiliki inventaris Amerika Serikat dan Uni Eropa yang berada di sistem terpisah.
Feed dapat dibuat dengan dua shard. Satu untuk Amerika Serikat dan satu untuk Uni Eropa dengan nonce dan
Untuk mengetahui informasi selengkapnya, lihat Tutorial dan praktik terbaik file feed yang di-shard.
Feed dapat terdiri dari beberapa file yang disebut shard. Untuk menentukan ukuran feed, gunakan panduan berikut:
- Sharding feed yang disarankan:
- Feed Penjual: satu shard.
- Feed Layanan: satu shard.
- Feed Ketersediaan: kurang dari 20 shard. Jika Anda memiliki justifikasi bisnis yang memerlukan jumlah lebih dari yang ditentukan, hubungi dukungan untuk mendapatkan petunjuk lebih lanjut.
- Ukuran file dan sharding feed:
- Pertahankan ukuran file shard kurang dari 200 MB setelah kompresi. Gunakan beberapa shard jika diperlukan.
- Setiap catatan yang dikirim dalam satu shard tidak perlu dikirim dalam shard yang sama di feed mendatang.
- Untuk mendapatkan performa yang lebih baik, bagi data secara merata di antara shard sehingga semua file yang di-sharding memiliki ukuran yang serupa.
- Jika perlu, gunakan gzip untuk mengompresi feed JSON teks biasa untuk setiap shard feed.
Mengompresi file feed
File JSON atau PB3 dapat dikompresi dengan gzip sebelum Anda menguploadnya. Hal ini dapat mengurangi ukuran byte feed harian secara signifikan.
Setiap file shard harus di-gzip dan diupload satu per satu seperti gzip*.json. Shard feed terkompresi harus diakhiri dengan .json.gz atau .pb3.gz.
Mengupload feed ke Dropbox SFTP
Setelah membuat Feed
Penjual,
Layanan,
dan Ketersediaan, Anda dapat mengupload feed ke lingkungan Sandbox atau Produksi
melalui Dropbox SFTP. Dropbox SFTP dikonfigurasi saat Anda memberikan
kunci SSH di Penyiapan.
Server SFTP Google tersedia di sftp://partnerupload.google.com pada port
19321.
Google meninjau dan memvalidasi file feed segera setelah diupload ke dropbox SFTP. Jika feed di-sharding di beberapa file, file ini akan diproses setelah Anda mengupload file terakhir. Jika feed Anda berisi error, email akan dikirimkan kepada Anda dengan mencantumkan kode error feed. Error mencegah penjual, layanan, atau ketersediaan yang ditentukan agar tidak di-feed. Setelah feed divalidasi, perlu waktu hingga 24 jam hingga feed muncul di frontend.