Bu makalede, hesabınız için menü API'sini etkinleştirme ve onunla entegrasyon süreci açıklanmaktadır. Aşağıda ilk katılım süreci ve lansman ön koşulları hakkında ayrıntılı bir genel bakış verilmiştir. Entegrasyon çalışmasını planlarken lütfen bu sayfaya bakın.
- Kurulum - Hesap yapılandırma 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ığını ve statik menü verileriyle alakalı veri feed'lerini kabul etmeye hazır olduğunu onaylamanız önemlidir. Menü 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 olması veya hiç entegrasyon olmaması durumunda yeni bir hesap oluşturulur ve erişim ayrıntıları e-posta üzerinden paylaşılır.
İş Ortağı Portalı'nda hesabınıza erişin ve Yapılandırma > Feed'ler dropbox yapılandırma sayfasına gidin. Menü veri feed'i entegrasyonuyla ilgili iki dropbox vardır: Genel ve Satıcılar. Lütfen her iki dropbox'ın da SSH ortak anahtarının yapılandırılmış olduğundan emin olun. SSH anahtarlarının nasıl yapılandırılacağı 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 başlangıcında hesabınız için varsayılan olarak etkinleştirilir. Feed göndermeye çalışırken şu hata mesajını görüyorsanız:
"Feed işlenemedi. Feed'iniz ayrıştırılırken dahili bir sorun
oluştu. "google.food_menu" etkin değil. Lütfen düzeltip tekrar deneyin." hata mesajını görürseniz bu feed türünü etkinleştirmek için lütfen Google temsilcinizle 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 sürecinin ana bölümünü içerir: veri feed'lerini oluşturma ve test etme. Veri feed'leri her gün oluşturulmalı ve hedef dropbox'a gönderilmelidir. Korumalı alana gönderilen feed'lerin, gönderildikten sonra bir saat içinde işlenmeye başlaması beklenir. Üretim feed'leri her gün saat 12:00'de (PST saat diliminde) işlenir. Yalnızca en son gönderilen feed işlenmek üzere işleme alınır. Feed'lerinizi oluşturmaya çalışırken lütfen veri feed'i spesifikasyonuna ve örneklerine bakın. Spesifikasyon protobuf biçiminde sunulsa da, sorunları gidermek daha kolay olduğundan 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ı ile hızlı bir şekilde test edilebilir. Bu araç, dosyanın veri şemasıyla eşleşip eşleşmediğini gösterir, değilse hata listesi verir. Birden çok 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ğı Portalı'ndaki sonuçlara bakın. Feed aktarımı sırasında bazı iş mantığını ve verilerin kalitesini test etmek için ek doğrulama kuralları uygulanır.
Başlatın
Lansman aşaması, tüm entegrasyon çalışmaları tamamlandıktan ve üretim feed'i restoran menülerinin tüm envanterini doğru bir şekilde yansıttıktan sonra başlatılabilir.
Kullanıma sunma ön koşulları
Entegrasyonun başlaması için şu koşulların karşılanması gerekir:
- Veri feed'leri, üretim ortamında 0 hatayla işlenir.
- Üretim veri feed'i, bu entegrasyonun başında bu entegrasyon için kapsama dahil edilen tüm envanteri içerir.
- Satıcı verilerinizin büyük kısmı Google Haritalar konumlarıyla eşleşiyor.
- Üretim feed'leri veri kalitesi değerlendirmesinden geçti.
- Entegrasyon tüm Yemek Menüsü Politikaları ve Koşullarını karşılar.
Veri değerlendirme
Üretim veri feed'leri hatasız olarak alındıktan sonra menü verilerinin kalitesini değerlendirmek için dahili bir işlem olabilir. Bu süreç, veri kalitesindeki tutarsızlıkların (ör. yemek açıklamalarındaki yiyeceklerle alakalı olmayan içerikler, yemek adları, fiyatlar ve benzerlikler) eşleşmesini bulmayı amaçlar. Bu tür bulgular olması durumunda, geri bildirim geliştirme ekibiyle paylaşılır.