En este artículo, se describe el proceso para habilitar la API de menú para tu cuenta y realizar la integración. A continuación, se incluye una descripción general detallada del proceso de integración y 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 confirmar que tu cuenta en el Portal de socios esté completamente configurada y lista para aceptar feeds de datos relevantes para los datos de menú estáticos. Si tienes una integración activa de redireccionamiento de OwG o RwG a la que le agregas los metadatos de los menús, se reutilizará tu cuenta existente para esta integración. En los casos en que hay integración directa de OwG en esta plataforma o no hay 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 a la página de configuración de Dropbox Configuración > Feeds. Hay dos menús desplegables relevantes para la integración del feed de datos de menú: Genéricos y Comercios. Verifica que ambos buzones tengan configurada la clave pública SSH. Para obtener más información sobre cómo configurar claves SSH, consulta esta página.
El
dropbox 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 para tu cuenta de forma predeterminada al comienzo de la integración. En caso de que intentes enviar un feed y veas este mensaje de error:
“Falló el procesamiento del feed. Tuvimos un problema interno mientras analizábamos tu feed. "google.food_menu" no está habilitado. Corrige el problema y vuelve a intentarlo", comunícate con tu punto de contacto de Google para habilitar este tipo de feed.
Por último, navega a la página Configuración > Información de contacto y asegúrate de que todos tus 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 a la zona de pruebas se comiencen a procesar en un plazo 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. (PST). Solo se toma el feed enviado más reciente para su procesamiento. Consulta la especificación y los ejemplos del feed de datos cuando trabajes en la generación de tus feeds. Aunque la especificación se presenta en formato protobuf, te recomendamos que subas los archivos de feed en formato JSON, ya que es más fácil solucionar problemas. Por ese motivo, los muestras de feeds también se proporcionan en formato JSON.
Se puede probar rápidamente un archivo de feed de datos con la herramienta en línea del validador de feeds que verifica si ese archivo corresponde a la especificación. La herramienta muestra si el archivo coincide con el esquema de datos y, de lo contrario, muestra la lista de errores. Para probar un feed de datos completo que consta de varios archivos, sube ese feed al entorno de zona de pruebas y, después de que se complete la transferencia, consulta los resultados en el Portal para socios. Durante la transferencia de feeds, se aplican reglas de validación adicionales para probar la lógica empresarial y la calidad de los datos.
Lanzamiento
La etapa de lanzamiento se puede iniciar después de 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
Se deben cumplir estas condiciones para que se inicie la integración:
- Los feeds de datos se procesan en el entorno de producción sin errores.
- El feed de datos de producción contiene el inventario completo definido para esta integración al comienzo de esta.
- 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
Después de que los feeds de datos de producción se transfieran sin errores, es posible que haya un proceso interno para evaluar la calidad de los datos de 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, precios, etcétera. En caso de que se encuentren este tipo de resultados, los comentarios se compartirán con el equipo de desarrollo.