Bu makalede, hesabınız için menü API'sini etkinleştirme ve bu API ile entegrasyon süreci ele alınmaktadır. İlk katılım sürecine ve lansmanla ilgili ön koşullara dair ayrıntılı bir genel bakış aşağıda 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 Dropbox yapılandırma sayfasına Yapılandırma > Feed'ler gidin. Menü veri feed'i entegrasyonuyla ilgili iki açılır liste vardır: Genel ve Satıcılar. Lütfen her iki Dropbox'ta da SSH ortak anahtarının yapılandırıldığından emin olun. SSH anahtarlarını yapılandırma hakkında daha fazla bilgi için bu sayfaya bakın.
Genel Dropbox, 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 oluşturulması ve her gün hedef Dropbox'a gönderilmesi gerekir. Korumalı alanda gönderilen feed'lerin, gönderildikten bir saat sonra işlenmeye başlaması beklenir. Üretim feed'leri, PST saat diliminde her gün 12:00'de bir işlenir. İşleme için yalnızca en son gönderilen feed alınır. Feed'lerinizi oluşturma sürecinde lütfen 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 sonuçları İş Ortağı Merkezi'nde görebilirsiniz. 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 çoğu 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.