Metode Pengiriman Push untuk Harga Hotel

Catatan: Google mendukung Push untuk sekumpulan kasus penggunaan dan partner terbatas. Dokumen ini ditujukan bagi partner lama yang saat ini menggunakan Push dan bagi partner baru yang lulus panduan ketat Google untuk menggunakan Push.

Jika memiliki batasan sistem yang mencegah Anda mendukung metode pengiriman Pull atau Pull dengan Petunjuk, gunakan formulir Hubungi Kami.

Ringkasan Mode Pengiriman Push

Dengan mode pengiriman Push, Anda mengirimkan pembaruan inkremental setiap kali harga atau ketersediaan berubah.

Gambar berikut menunjukkan alur permintaan/respons untuk mode pengiriman Push:

Catatan: Sebelum dapat menggunakan Push untuk mengirim pembaruan harga ke Google, Anda harus mendapatkan alamat IP server yang diizinkan seperti yang dijelaskan di bawah ini.

Mengonfigurasi Push di File Konfigurasi Protokol

Untuk memperbarui harga dengan mode pengiriman Push, tentukan elemen berikut di File Konfigurasi Protokol Anda. Anda hanya melakukan ini saat pertama kali mengonfigurasi lingkungan agar berfungsi dengan Hotel Price API:

• <Model>: Menetapkan nilai elemen <Model> ke "push".
• <WhitelistedIPs>: Mencantumkan alamat IP yang Anda gunakan untuk mengautentikasi komunikasi antara Anda dan Google. Nilai elemen ini dapat berupa daftar alamat IP Anda yang dipisahkan titik koma, atau rentang alamat IP dengan notasi CIDR. Formatnya adalah xxx.xxx.xxx.xxx/YY.

Contoh berikut menunjukkan File Konfigurasi Protokol bagi partner yang menggunakan Push:

<?xml version="1.0" encoding="UTF-8"?>
<Configuration>
  <Model>push</Model>
  <WhiteListedIPs>216.239.32.0/19;64.233.160.0/19</WhiteListedIPs>
</Configuration>

Untuk informasi selengkapnya, lihat File Konfigurasi Protokol.

Memperbarui Harga dengan Push

Untuk memperbarui data dengan Push, kirim pesan Transaction setiap kali data Anda berubah.

Gunakan panduan berikut saat mengirim pesan Transaksi:

• Kirim pesan ke endpoint berikut:
  • http://www.google.com/travel/hotels/uploads/price
• Gunakan metode HTTP POST.
• Tetapkan header Content-Type ke "application/xml".
• Isi pesan harus sesuai dengan sintaksis pesan Transaksi, seperti yang dijelaskan pada Menetapkan Harga (untuk pembaruan harga) atau Menentukan Metadata Kamar dan Paket (untuk pembaruan metadata).
• Untuk memperbarui harga, tentukan elemen <Result> untuk setiap itinerari yang ingin Anda perbarui. Untuk pembaruan metadata, tentukan data kamar dan data paket untuk setiap properti yang telah berubah.

Untuk setiap pesan Transaksi yang diterima, Google akan merespons dengan pesan HTTP 200 OK dari server untuk menunjukkan keberhasilan. Jika Google merespons dengan kode error HTTP, kirim ulang pesan Transaksi. Jika Anda mengalami masalah saat mengirim atau menerima pesan, lihat Memecahkan Masalah Feed.

Anda harus mengirim pesan Transaksi untuk setiap itinerari (kombinasi properti/tanggal check-in/lama menginap) saat harga telah berubah. Anda dapat mengirim hingga 5 pesan Transaksi per detik. Google tidak akan memblokir pesan yang dikirim lebih sering dari 5 per detik, tetapi waktu tunggu pesan Anda mungkin akan menunggu hingga permintaan lainnya selesai.

Untuk mengurangi traffic jaringan, Anda dapat menggabungkan beberapa elemen <Result> menjadi satu pesan Transaksi.

Google biasanya memproses data harga dan ketersediaan yang diperbarui dalam waktu sekitar 5 menit. Harga akan dihapus setelah 90 hari.

Untuk mengetahui informasi selengkapnya tentang penggunaan pesan Transaksi guna memperbarui harga, lihat Menetapkan Harga.

Memperbarui Metadata Kamar dan Paket dengan Push

Untuk memperbarui metadata kamar dan paket, kirim pembaruan seperti yang Anda lakukan pada pembaruan lainnya. Dalam hal ini, Anda mengirim pesan Transaksi dengan informasi baru di elemen <RoomData> dan <PackageData>. Elemen ini adalah turunan dari elemen <PropertyDataSet>.

Untuk informasi selengkapnya, lihat Menentukan Metadata Kamar dan Paket.

Error Mode Pengiriman

Jika Anda menerima error HTTP saat mengirim pesan Transaksi ke Google, coba lagi permintaan tersebut pada interval 1, 5, dan 20 menit. Jika masalah berlanjut setelah 3 percobaan ulang, hentikan pengiriman pesan dan hubungi Account Manager Google Anda.

Saat menghubungi Account Manager Google untuk melaporkan error HTTP yang Anda terima saat mengirim pesan Transaksi, Google akan menjalankan pengujian untuk sekitar 10 hotel saat bekerja sama dengan Anda untuk memverifikasi bahwa feed Anda dikonfigurasi dengan benar. Jika pengujian berhasil, Google akan meng-crawl kumpulan lengkap hotel yang ditentukan dalam Feed Harga Hotel Anda. Hal ini memastikan bahwa pemuatan dapat diterima dan harga Anda tetap akurat selama 3 hingga 5 hari. Setelah itu, Google akan memberi tahu Anda tentang peluncuran yang nantinya memungkinkan Anda untuk merujuk ke hasil secara langsung.

Seberapa sering harga harus dikirim?

Idealnya, Anda mengirim semua pembaruan segera setelah mengetahui bahwa harga telah berubah. Jika tidak tahu kapan harga berubah, Anda harus mencoba memperbarui harga sesering mungkin. Proses ini biasanya mencakup beberapa push per hari. Biasanya, itinerari untuk hari dan minggu ini lebih sering dikirim.