Bu makalede, hesabınız için menü API'sini etkinleştirme ve bu API ile entegrasyon süreci ele alınmaktadır. Aşağıda, ilk katılım sürecine ve lansmanla ilgili ön koşullara dair ayrıntılı bir genel bakış verilmiştir. Entegrasyon çalışmasını planlarken lütfen bu sayfaya bakın.
- Kurulum: Hesap yapılandırması ve geliştirme sürecinin planlanması.
- Geliştirme: Veri feed'i geliştirme ve test etme.
- Lansman: Lansmandan önce veri değerlendirmesi.
Kurulum
Bu aşamada, İş Ortağı Portalı'ndaki hesabınızın tamamen yapılandırıldığından ve statik menü verileriyle ilgili veri feed'lerini kabul etmeye hazır olduğundan emin olmanız önemlidir. Menülerin meta verilerini eklediğiniz etkin bir OwG yönlendirme veya RwG entegrasyonunuz varsa mevcut hesabınız bu entegrasyon için yeniden kullanılır. Bu platformda OwG Direct entegrasyonu olan veya hiç entegrasyon olmayan durumlarda yeni bir hesap oluşturulur ve erişim ayrıntıları e-postayla paylaşılır.
İş Ortağı Portalı'nda hesabınıza erişin ve feed yapılandırma sayfasına Yapılandırma > Feed'ler gidin. Menü veri feed'i entegrasyonu için alakalı iki SFTP sunucusu vardır: Genel ve Satıcılar. Lütfen her iki SFTP sunucusunda da SSH ortak anahtarının yapılandırıldığından emin olun. SSH anahtarlarını yapılandırma hakkında daha fazla bilgi edinmek için bu sayfaya bakın.
Genel SFTP sunucusu, farklı veri şemalarını izleyebilen çeşitli feed'leri kabul edebilir. Yapılandırılmış menü verilerini kabul eden feed türü google.food_menu olarak adlandırılır ve genellikle ilk katılımınızın başında hesabınızda varsayılan olarak etkinleştirilir. Feed göndermeye çalışırken şu hata mesajını görürseniz:
"Feed işlenemedi. Feed'inizi ayrıştırırken dahili bir sorunla karşılaştık. "google.food_menu" etkin değil. Lütfen düzeltin ve tekrar deneyin." hatası alıyorsanız bu feed türünü etkinleştirmek için lütfen Google iletişim yetkilinizle iletişime geçin.
Son olarak lütfen Yapılandırma > İletişim Bilgileri sayfasına gidip tüm iletişim bilgilerinizin güncel olduğundan emin olun.
Geliştirme
Geliştirme aşaması, uygulama çalışmasının ana bölümünü (veri feed'lerini oluşturma ve test etme) içerir. Veri feed'lerinin her gün oluşturulup hedef SFTP sunucusuna gönderilmesi gerekir. Gönderilen feed'lerin, gönderimden sonraki bir saat içinde işlenmeye başlaması beklenir. Feed'lerinizi oluşturma üzerinde çalışırken veri feed'i spesifikasyonuna ve örneklerine bakın. Spesifikasyon protobuf biçiminde sunulmasına rağmen, sorun giderme işleminin daha kolay olması nedeniyle feed dosyalarını JSON biçiminde yüklemenizi öneririz. Bu nedenle, feed örnekleri de JSON biçiminde sağlanır.
Bir veri feed'i dosyası, söz konusu dosyanın spesifikasyona uygun olup olmadığını doğrulayan feed doğrulayıcı online aracı kullanılarak hızlıca test edilebilir. Araç, dosyanın veri şemasıyla eşleşip eşleşmediğini gösterir. Eşleşmezse hataların listesini gösterir. Birden fazla dosyadan oluşan bir veri feed'inin tamamını test etmek için bu feed'i korumalı alan ortamına yükleyin ve besleme tamamlandıktan sonra İş Ortağı Merkezi'nde sonuçları görün. Feed beslemesi sırasında, bazı iş mantıklarını ve verilerin kalitesini test etmek için ek doğrulama kuralları uygulanır.
Başlat
Tüm entegrasyon çalışmaları tamamlandıktan ve üretim feed'i restoran menüleri envanterin tamamını doğru şekilde yansıttıktan sonra lansman aşaması başlatılabilir.
Lansmanla ilgili ön koşullar
Entegrasyonun başlatılması için aşağıdaki koşulların karşılanması gerekir:
- Veri feed'leri, üretim ortamında 0 hata ile işlenir.
- Üretim veri feed'i, bu entegrasyon başlangıcında bu entegrasyon için kapsamlı envanter içerir.
- Satıcı verilerinizin büyük kısmı Google Haritalar konumlarıyla eşleşiyor.
- Üretim feed'leri veri kalitesi değerlendirmesini geçti.
- Entegrasyon, tüm yemek menüsü politikalarını ve şartlarını karşılamalıdır.
Veri değerlendirmesi
Üretim veri feed'leri hatasız bir şekilde beslendikten sonra, menü verilerinin kalitesini değerlendirmek için dahili bir işlem yapılabilir. Bu süreç, yemek açıklamalarında yemekle ilgili olmayan içerikler, yemek adları ve fiyatlardaki uyuşmazlıklar gibi veri kalitesinde tutarsızlıkları tespit etmeyi amaçlar. Bu tür bulgular varsa geri bildirim geliştirme ekibiyle paylaşılır.