Toplu besleme

Veri feed'leriniz restoranınızı, hizmetlerinizi ve menünüzü Order with Google'da kullanılabilir hale getirmenizi sağlar.

Bu dokümanda, korumalı alan ve üretim envanterlerinizi nasıl barındıracağınız ve Order with Google'daki envanterinizi güncellemek için toplu beslemeyi nasıl kullanacağınız açıklanmaktadır.

Veri feed'i ortamları

Entegrasyon geliştirmeniz için kullanabileceğiniz üç veri feed'i ortamı vardır:

Veri feed'lerini barındırma

Order with Google'ın Korumalı Alan ve Üretim veri feed'lerinizi toplu beslemeye göre işleyebilmesi için veri feed'i dosyalarınızı bir site haritasıyla Google Cloud Storage, Amazon S3 veya HTTPS'de barındırmanız gerekir.

Korumalı alan ve üretim ortamlarınıza ilişkin veri feed'lerini ayrı olarak barındırmanızı öneririz. Bu yaklaşım, değişiklikleri üretime dağıtmadan önce korumalı alan feed'i ortamınızda geliştirme ve test yapmanıza olanak tanır.

Örneğin, bir barındırma seçeneği olarak Google Cloud Storage'ı kullanıyorsanız aşağıdaki yolları görürsünüz:

• Korumalı Alan Feed'i: gs://foorestaurant-google-feed-sandbox/
• Üretim Feed'i: gs://foorestaurant-google-feed-prod/

Envanterinizi barındırmak için aşağıdakileri yapın:

1. Veri feed'i dosyalarınızı oluşturun.
2. Bir barındırma çözümü seçin.
3. Veri feed'lerinizi barındırın.
4. Veri feed'i dosyalarınızın düzenli olarak güncellendiğinden emin olun. Üretim veri feed'leri günlük olarak güncellenmelidir.

Envanter feed'i oluşturma hakkında ayrıntılı bilgi için Restaurant, Service ve Menu varlıklarının belgelerinin yanı sıra Veri feed'i oluştur bölümüne de göz atın.

Veri feed'i dosyalarıyla ilgili kurallar

Birden fazla varlık içerebilen her dosya 200 MB'ı aşmamalıdır. Üst düzey varlıklarının (Restaurant, Service, Menu) alt varlıklarıyla birlikte 4 MB'ı aşmaması gerekir.

Barındırma çözümü seçin

Aşağıdaki tabloda veri feed'lerinizi barındırma seçenekleri ve bu barındırıcıların Order with Google ile nasıl çalıştığı listelenmektedir:

Toplu besleme için veri feed'lerinizi bağlama

Feed'lerinizi barındırdıktan sonra, feed'lerinizi İş Ortağı Portalı'nda projenize bağlamanız gerekir. Üretim feed'lerinin ilk yapılandırması İlk Katılım Görevleri sayfasında yapılır. Üretim ve korumalı alan feed'leri yapılandırması daha sonra, yönetim rolüne sahip tüm portal kullanıcıları tarafından Yapılandırma > Feed'ler sayfasından güncellenebilir. Korumalı alan ortamı, geliştirme ve test amacıyla, üretim feed'leri ise kullanıcılara gösterilir.

Veri feed'lerinizi Amazon S3 ile barındırıyorsanız

1. İş Ortağı Portalı'nda Yapılandırma > Feed'leri bölümüne gidin.

2. Düzenle'yi tıklayın ve Feed'i Güncelle formunu doldurun:

   • Feed yayınlama yöntemi: Amazon S3 olarak ayarlayın.
   • İşaretçi Dosyası: marker.txt dosyasının URL'sini sağlayın.
   • Veri Dosyaları: Veri feed'lerini içeren S3 paketinin URL'sini belirtin.
   • Erişim kimliği: S3 kaynaklarından okuma izinlerine sahip IAM erişim anahtarı kimliğini girin.
   • Erişim Anahtarı: S3 kaynaklarından okuma izinlerine sahip IAM gizli erişim anahtarını girin.
3. Gönder'i tıklayın.
4. Bir iki saat sonra toplu beslemelerin feed dosyalarınızı getirip getirmediğini kontrol edin.

Veri feed'lerinizi Google Cloud Storage ile barındırıyorsanız

1. İş Ortağı Portalı'nda Yapılandırma > Feed'leri bölümüne gidin.

2. Düzenle'yi tıklayın ve Feed'i Güncelle formunu doldurun:

   • Feed yayınlama yöntemi: Google Cloud Storage olarak ayarlayın.
   • İşaretçi Dosyası: marker.txt dosyasının URL'sini sağlayın.
   • Veri Dosyaları: Veri feed'lerini içeren GCS paketinin URL'sini belirtin.
3. Gönder'i tıklayın.
4. GCS paketinize erişmek için bir hizmet hesabı oluşturulur. Hesap adı, ilk katılım görevleri tamamlandıktan sonra Yapılandırma > Feed'leri bölümünde bulunabilir. Bu hizmet hesabının "Depolama Eski Nesne Okuyucu" rolüne sahip olması gerekir. Bu rol, Google Cloud Console'un IAM sayfasındaki hizmet hesabına verilebilir.
5. Bir iki saat sonra toplu beslemelerin feed dosyalarınızı getirip getirmediğini kontrol edin.

Veri feed'lerinizi HTTPS ile barındırıyorsanız

1. İş Ortağı Portalı'nda Yapılandırma > Feed'leri bölümüne gidin.

2. Düzenle'yi tıklayın ve Feed'i Güncelle formunu doldurun:

   • Feed yayınlama yöntemi: HTTPS olarak ayarlayın.
   • Site haritası dosyası: sitemap.xml dosyasının URL'sini sağlayın.
   • Kullanıcı adı: HTTPS sunucusuna erişmek için kullanılacak kullanıcı adı kimlik bilgilerini girin.
   • Şifre: HTTPS sunucusuna erişmek için şifreyi girin.
3. Gönder'i tıklayın.
4. Bir iki saat sonra toplu beslemelerin feed dosyalarınızı getirip getirmediğini kontrol edin.

Örnek yollar

Aşağıdaki tabloda, barındırma seçeneklerinin her biri için örnek yollar verilmiştir:

HTTPS barındırmaya ilişkin site haritaları

Site haritalarını tanımlarken aşağıdaki yönergeleri kullanın:

• Site haritanızdaki bağlantılar dosyaların kendisine işaret etmelidir.
• Site haritanız, kendi alan adınız yerine bir bulut sağlayıcısına başvuru içeriyorsa https://www.yourcloudprovider.com/your_id gibi URL'lerin başlangıcının sabit olduğundan ve toplu işiniz için benzersiz olduğundan emin olun.
• Kısmi site haritaları yüklemediğinizden emin olun (kısmi veri yüklenmesi gibi). Bu durumda, Google yalnızca site haritasındaki dosyaları besler ve bu da envanter düzeylerinizin düşmesine ve feed beslemenizin engellenmesine neden olabilir.
• Site haritasında başvurulan dosyaların yollarının değişmediğinden emin olun. Örneğin, site haritası referansınızı bugün https://www.yourcloudprovider.com/your_id/10000.json ama daha sonra yarın https://www.yourcloudprovider.com/your_id/20000.json bilgisi olarak kullanmayın.

Örnek site haritası

Veri feed'i dosyalarını yayınlayan örnek bir sitemap.xml dosyasını aşağıda görebilirsiniz:

1. Örnek: Satıcılara göre gruplandırılmış öğeler (Önerilen).

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_1.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_2.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_3.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
</urlset>

2. Örnek: Türe göre gruplandırılmış varlıklar.

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 <url>
   <loc>https://your_fulfillment_url.com/restaurant.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/menu.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/service.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
</urlset>

Veri feed'lerinizi güncelleme

Veri feed'leriniz bağlandıktan sonra Google, güncellemeleri saatte bir kontrol eder ancak tüm veri feed'lerini yalnızca marker.txt veya sitemap.xml dosyaları değiştirildiğinde besleriz. Eski envanteri önlemek için veri feed'lerinizi günde bir kez güncellemenizi öneririz.

Veri feed'lerinin değiştirildiğini ve toplu aktarıma hazır olduğunu belirtmek için marker.txt dosyasının last-modified nesne meta veri alanını (GCP ve S3 için) veya sitemap.xml dosyasının last-modified yanıt başlığını güncelleyin. Google, veri feed'inin ne kadar yeni olduğunu belirlemek için bu değerleri kullanır.

Toplu özet akışı beslendiğinden

• Geçerli OwG envanterinizde bulunmayan ve hata içermeyen yeni varlıklar eklenir.
• Envanterde zaten mevcut olan ve aktarımda herhangi bir hata bulunmayan ve mevcut girişinden dateModified daha yeni olan veya dateModified olmadığı durumlarda feed besleme başlangıç zamanı, güncellenecek geçerli girişten daha yenidir, aksi takdirde eski olarak işaretlenir.
• Daha önceki bir feed'in parçası olan ve artık işlenen toplu feed'e dahil olmayan varlıklar, feed'de dosya düzeyinde hata olmaması koşuluyla silinir.

Zaman damgası veya last-modified yanıt başlığı yalnızca tüm veri feed'i dosyaları oluşturulduktan ve güncellendikten sonra güncellenmelidir. Veri feed'lerinizi güncelleyen toplu işleri, günde yalnızca bir kez çalışacak şekilde sınırlandırın. Alternatif olarak, her bir toplu iş arasında en az üç boşluk bırakın. Bu adımları yapmazsanız Google eski dosyalar getirebilir.