En este artículo, se explica el proceso de habilitación de la API de Menu para tu cuenta y de integración en ella. A continuación, se muestra una descripción general detallada del proceso de integración y de los requisitos previos para el lanzamiento. Consulta esta página cuando planifiques el esfuerzo de integración.
- Configuración: configuración de la cuenta y planificación del proceso de desarrollo.
- Desarrollo: desarrollo y pruebas de feeds de datos.
- Lanzamiento: evaluación de datos antes del lanzamiento.
Configuración
En esta etapa, es importante que confirmes que tu cuenta del Portal para socios esté completamente configurada y lista para aceptar feeds de datos relevantes para los datos del menú estático. Si ya tienes una integración activa de redireccionamiento de OwG o RwG a la que estás agregando los metadatos de los menús, tu cuenta existente se reutilizará para esta integración. En los casos con la integración de OwG Direct en esta plataforma o con ninguna integración, se crea una cuenta nueva y los detalles de acceso se comparten por correo electrónico.
Accede a tu cuenta en el Portal para socios y navega hasta la página de configuración del dropbox, Configuración > Feeds. Existen dos dropboxes relevantes para la integración del feed de datos de menú: Genérico y Comercios. Verifica que ambos Dropbox tengan configurada la clave pública SSH. Para obtener más información sobre cómo configurar llaves SSH, consulta esta página.
El buzón genérico puede aceptar varios feeds que pueden seguir diferentes esquemas de datos. El tipo de feed que acepta datos de menú estructurados se denomina google.food_menu y, por lo general, se habilita en tu cuenta de forma predeterminada al comienzo de la integración. Si intentas enviar un feed y aparece este mensaje de error:
"Error en el procesamiento del feed. Ocurrió un problema interno durante el análisis de tu feed. No se habilitó 'google.food_menu'. Corrígelo y vuelve a intentarlo"., comunícate con tu punto de contacto de Google para habilitar este tipo de feed.
Por último, ve a la página Configuración > Información de contacto y asegúrate de que todos los detalles de contacto estén actualizados.
Desarrollo
La etapa de desarrollo contiene la parte principal del esfuerzo de implementación: generar y probar los feeds de datos. Los feeds de datos se deben crear y enviar al dropbox de destino todos los días. Se espera que los feeds enviados en la zona de pruebas comiencen a procesarse dentro de una hora después del envío. Los feeds de producción se procesan una vez al día a las 12 p.m. en la zona horaria PST; solo se toma en consideración el último feed enviado para su procesamiento. Consulta la especificación y las muestras del feed de datos cuando trabajes en la generación de tus feeds. Aunque la especificación se presenta en formato protobuf, recomendamos subir los archivos de feed en formato JSON, ya que la solución de problemas es más fácil. Por ese motivo, los ejemplos de feed también se proporcionan en formato JSON.
Un archivo de feed de datos se puede probar rápidamente con la herramienta en línea del validador de feeds que verifica si el archivo corresponde a la especificación. La herramienta muestra si el archivo coincide con el esquema de datos y, si no es así, genera la lista de errores. Para probar un feed de datos completo que contenga varios archivos, súbelo al entorno de la zona de pruebas y, después de que se complete la transferencia, consulta los resultados en el Portal para socios. Durante la transferencia del feed, se aplican reglas de validación adicionales para probar cierta lógica empresarial y la calidad de los datos.
Lanzamiento
La etapa de lanzamiento se puede iniciar una vez que se complete todo el trabajo de integración y el feed de producción refleje correctamente todo el inventario de los menús de los restaurantes.
Requisitos previos para el lanzamiento
Para que se lance la integración, deben cumplirse las siguientes condiciones:
- Los feeds de datos se procesan en el entorno de producción sin errores.
- El feed de datos de producción contiene todo el inventario específico para esta integración al comienzo.
- La mayoría de los datos de tus comercios coinciden con las ubicaciones de Google Maps.
- Los feeds de producción aprobaron la evaluación de calidad de los datos.
- La integración cumple con todas las Políticas y Requisitos de los Menús de Comida.
Evaluación de datos
Una vez que los feeds de datos de producción se transfieran sin errores, es posible que exista un proceso interno para evaluar la calidad de los datos del menú. El objetivo de este proceso es encontrar inconsistencias en la calidad de los datos, como contenido no relacionado con comida en las descripciones de los platos, discrepancias en los nombres de los platos, los precios, etc. En caso de que se detecten estas fallas, los comentarios se compartirán con el equipo de desarrollo.