Questo articolo illustra la procedura per abilitare l'API Menu per il tuo account e la relativa integrazione. Di seguito è riportata una panoramica dettagliata del processo di onboarding e dei prerequisiti di lancio. Fai riferimento a questa pagina quando pianifichi l'impegno di integrazione.
- Impostazione: configurazione dell'account e pianificazione del processo di sviluppo.
- Sviluppo: sviluppo e test di feed di dati.
- Lancio: valutazione dei dati prima del lancio.
Configurazione
In questa fase è importante verificare che il tuo account sul Portale partner sia completamente configurato e pronto ad accettare feed di dati pertinenti per i dati del menu statico. Se disponi già di un'integrazione OwG Redirect o RwG attiva a cui aggiungi i metadati dei menu, il tuo account esistente verrà riutilizzato per questa integrazione. Nei casi in cui l'integrazione con OwG Direct su questa piattaforma o l'assenza di integrazioni, viene creato un nuovo account e i dettagli di accesso vengono condivisi via email.
Accedi al tuo account sul Portale partner e vai alla pagina di configurazione della casella personale Configurazione > Feed. Sono disponibili due caselle personali pertinenti all'integrazione dei feed di dati del menu: Generico e Commercianti. Verifica che in entrambe le caselle personali sia configurata la chiave pubblica SSH. Per saperne di più su come configurare le chiavi SSH, consulta questa pagina.
La
casella personale generica
può accettare vari feed in grado di seguire schemi di dati diversi. Il tipo di feed che accetta dati del menu strutturati è denominato google.food_menu e di solito è abilitato per il tuo account per impostazione predefinita all'inizio dell'onboarding. Se provi a inviare un feed e visualizzi questo messaggio di errore:
"Elaborazione del feed non riuscita. Abbiamo riscontrato un problema interno durante l'analisi del
feed. "google.food_menu" non è abilitato. Correggilo e riprova"., rivolgiti al tuo punto di contatto Google per attivare questo tipo di feed.
Infine, vai alla pagina Configurazione > Informazioni di contatto e assicurati che tutti i tuoi dettagli di contatto siano aggiornati.
Sviluppo
La fase di sviluppo contiene la parte principale dell'implementazione: generazione e test dei feed di dati. I feed di dati devono essere creati e inviati ogni giorno alla casella personale di destinazione. L'elaborazione dei feed inviati nella sandbox dovrebbe iniziare entro un'ora dall'invio. I feed di produzione vengono elaborati una volta ogni giorno alle 12:00 nel fuso orario PST: solo il feed inviato più recente viene elaborato. Fai riferimento alla specifica e agli esempi del feed di dati quando lavori alla generazione dei feed. Anche se la specifica è presentata in formato protobuf, consigliamo di caricare i file del feed in formato JSON, perché è più facile risolvere i problemi. Per questo motivo, gli esempi di feed vengono forniti anche in formato JSON.
Un file del feed di dati può essere testato rapidamente utilizzando lo strumento online di convalida dei feed che verifica se il file corrisponde alla specifica. Lo strumento mostra se il file corrisponde allo schema dei dati e, in caso contrario, restituisce l'elenco degli errori. Per testare un intero feed di dati composto da più file, carica il feed nell'ambiente sandbox e, una volta completata l'importazione, visualizza i risultati sul Portale partner. Durante l'importazione del feed vengono applicate regole di convalida aggiuntive per testare alcune logica di business e la qualità dei dati.
Avvia
La fase di lancio può essere avviata al termine di tutte le operazioni di integrazione e il feed di produzione rispecchia correttamente l'intero inventario dei menu dei ristoranti.
Prerequisiti per il lancio
Per poter avviare l'integrazione, devono essere soddisfatte le seguenti condizioni:
- I feed di dati vengono elaborati nell'ambiente di produzione con 0 errori.
- Il feed di dati di produzione contiene l'intero inventario limitato all'ambito di questa integrazione all'inizio dell'integrazione.
- La maggior parte dei tuoi dati del commerciante corrisponde alle località di Google Maps.
- I feed di produzione hanno superato la valutazione della qualità dei dati.
- L'integrazione soddisfa tutte le norme e i requisiti sul menù.
Valutazione dei dati
Dopo che i feed di dati di produzione vengono importati senza errori, potrebbe essere necessario un processo interno per valutare la qualità dei dati del menu. Questo processo ha l'obiettivo di trovare incongruenze nella qualità dei dati, ad esempio contenuti non correlati al cibo nelle descrizioni dei piatti, mancata corrispondenza nei nomi dei piatti, nei prezzi e così via. In caso di risultati di questo tipo, il feedback verrà condiviso con il team di sviluppo.