Feed'ler, envanter verilerinizi İşlemler Merkezi'ne sağlar. Bu günlük Güvenli Dosya Aktarım Protokolü (SFTP) yüklemesi, tüm satıcıları, hizmetleri ve uygunluk aralıkları verilerini günceller. Feed'ler, hangi satıcıları desteklediğinizi, stok durumlarını ve Google'ın envanterinizi düzgün şekilde gösterdiğini onaylamak için gereken özel özellikleri belirtir. Feed'ler, Kurulum bölümünde SSH anahtarınızı sağladığınızda yapılandırılan SFTP dropbox'larına yüklenir.
Rezervasyon sunucusuna geçmeden önce aşağıdaki Feed'ler Hazır görevlerini tamamlamanız gerekir:
Görevler, feed'lerinizi başarıyla yükledikten sonra tamamlandı olarak işaretlenir ve yeşile döner. Belirli kilometre taşı görevlerini tamamlamak için bağlantısı verilen belgeleri inceleyin.
Yemek Rezervasyonları Uçtan Uca Entegrasyonunuzun düzgün çalışması için günlük olarak satıcı feed'i, hizmet feed'i ve uygunluk feed'i yüklemelerini otomatik olarak sağlamanız gerekir. Otomatik feed altyapınız, envanterinizin tamamını sağlamalıdır.
Feed türleri
Yemek rezervasyonları için uçtan uca entegrasyonlar aşağıdaki feed'leri ve bunların yükleme sıklıklarını gerektirir:
| Feed | Açıklama | Sıklık | Örnek |
|---|---|---|---|
| Satıcı | Satıcılarınızı tanımlar. | 24 saatte bir kez | Satıcı feed'i örneği |
| Hizmetler | Satıcılarınızın hizmetlerini açıklayın. | 24 saatte bir kez | Hizmet feed'i örneği |
| Kullanılabilirlik | Satıcılarınızın hizmetleri için mevcut zaman aralıklarını açıklar. En az 30 günlük kapsama alanı sağlanmalıdır. Kapsamı 90 güne uzatmak için İşlemler Merkezi iletişim formu üzerinden Google Destek Ekibi ile iletişime geçin. | 24 saatte bir kez | Stok durumu feed'i örneği |
Feed biçimleri protocol buffer 3 söz dizimi ile açıklanır ancak feed'lerinizi ilgili JSON biçimine göre yükleyebilirsiniz. JSON biçimi için feed örneklerine bakın. Feed'leri JSON biçiminde yüklemenizi öneririz.
Adlandırma kuralları ve meta veriler
Dosya adları
Parçalama kullanıyorsanız yüklediğiniz feed'lerin, feed türünü ve sayısını belirten benzersiz adları olmalıdır. Feed oluşturma zaman damgası, feed dosyanızın adlandırılmasıyla ilgili benzersizlik şartını karşılar.
Yapı: {feed_name}_{timestamp_epoch}_{shard_nunber}_{total_shard}.json
Örnek: availability_feed_1574117613_001_of_002.json.gz
Kimlikleri tanımlama
Satıcılarınız veya kimlik gerektiren diğer özellikler için kimlik tanımlarken UID veya UUID'leri kullanmanızı önemle tavsiye ederiz. Platformunuzda kimlikler farklı kaldığı sürece kendi alfanümerik çözümünüzü sağlayabilirsiniz.
Meta veri
Feed oluşturduğunuzda generation_timestamp, verilerin veritabanından çekildiği zamanı yansıtmalıdır. Bu değerin feed'lerde yeniden kullanılması işleme hatalarına yol açabilir.
Tek kullanımlık değerler (rastgele veya tekrarlanmayan sayılar) feed türleri arasında benzersiz olmalı ve yeniden kullanılamaz. Değer, belirli parçalanmış feed'deki tüm dosyalarla eşleşmelidir.
Feed dosya boyutu
Feed dosyalarını parçalama
Envanterinize bağlı olarak, feed'leri birden fazla dosyaya bölmek veya parçalamak gerekebilir. Feed'lerinizin aşağıdaki durumlarda parçalanması gerekebilir:
- Sıkıştırılmış gzip feed'i, bir dosya için 200 MB'ı aşıyor.
- Örnek: Oluşturulan stok durumu feed'i 1 GB. Bu, beş veya daha fazla ayrı parçaya bölünmelidir.
- İş ortağı envanteri, sistemlere veya bölgelere dağıtıldığından envanterin mutabakatı zorlaşır.
- Örnek: İş ortağının ayrı sistemlerde bulunan ABD ve AB envanteri var.
Feed iki parça halinde oluşturulmuş olabilir. Aynı nonce ve
generation_timestampile ABD ve AB için birer tane.
- Örnek: İş ortağının ayrı sistemlerde bulunan ABD ve AB envanteri var.
Feed iki parça halinde oluşturulmuş olabilir. Aynı nonce ve
Daha fazla bilgi için Feed dosyalarını parçalama ile ilgili eğitimler ve en iyi uygulamalar başlıklı makaleyi inceleyin.
Bir feed, parçalar adı verilen birden fazla dosyadan oluşabilir. Feed'lerin boyutunu belirlemek için aşağıdaki yönergeleri kullanın:
- Önerilen feed parçalama:
- Satıcı feed'i: tek parça.
- Hizmet feed'i: bir parça.
- Stok durumu feed'i: 20'den az parça. Belirtilen miktardan daha fazla alan gerektiren bir iş gerekçeniz varsa daha fazla talimat için destek ekibiyle iletişime geçin.
- Feed dosyalarının boyutu ve parçalama:
- Parça dosya boyutunu sıkıştırmadan sonra 200 MB'tan küçük tutun. Gerekirse birden fazla parça kullanın.
- Tek bir parçada gönderilen ayrı kayıtların gelecekteki feed'lerde aynı parçada gönderilmesi gerekmez.
- Daha iyi performans için tüm parça dosyalarının boyutunu benzer hale getirmek üzere verileri parçalar arasında eşit şekilde dağıtın.
- Gerekirse her bir feed parçası için düz metin JSON feed'lerini sıkıştırmak üzere gzip'i kullanın.
Feed dosyalarını sıkıştırma
Yüklemeden önce tüm JSON veya PB3 dosyaları gzip ile sıkıştırılabilir. Bu, günlük feed'lerin bayt boyutunu önemli ölçüde azaltabilir.
Her parça dosyası gzip ile sıkıştırılmalı ve gzip*.json gibi ayrı ayrı yüklenmelidir. Sıkıştırılmış feed parçaları .json.gz veya .pb3.gz ile bitmelidir.
Feed'leri SFTP dropbox'ınıza yükleyin.
Satıcı, Hizmet ve Kullanılabilirlik feed'lerini oluşturduktan sonra, feed'lerinizi SFTP dropbox'ı aracılığıyla Sandbox veya Üretim ortamına yükleyebilirsiniz. SFTP dropbox'ı, Kurulum sırasında SSH anahtarınızı sağladığınızda yapılandırılır.
Google SFTP sunucusu, sftp://partnerupload.google.com adresinde 19321 numaralı bağlantı noktasında kullanılabilir.
Google, feed dosyalarını SFTP dropbox'a yüklenir yüklenmez inceler ve doğrular. Feed birden fazla dosya arasında parçalanmışsa son dosyayı yükledikten sonra işlenir. Feed'inizde hata varsa feed hata kodlarını içeren bir e-posta gönderilir. Hatalar, tanımlanan satıcıların, hizmetlerin veya kullanılabilirliğin alınmasını engeller. Feed'ler doğrulandıktan sonra, feed'lerin ön uçta görünmesi 24 saati bulabilir.