Feeds básicos (heredados)

Primero, debes crear tus feeds y, luego, Google los evalúa.

Crea tus feeds

1. Genera tus feeds. La mayor parte de los datos de tu inventario se transmiten a Google mediante feeds. Para comenzar, crea dos tipos de feeds:

   • Feed de comercios: El feed de comercios describe tus comercios y los vínculos de acción a nivel del comercio.
   • Feed de servicios (opcional): El feed de servicios describe los servicios y niveles de servicio action_link que tus comercios proporcionan a tu plataforma.

   Campos obligatorios y recomendados

   Feed	Nombre del campo	Descripción	¿Obligatorio?
   Comercio	merchant_id	Es el identificador único del comercio.	Sí
   Comercio	name	Nombre del comercio	Sí
   Comercio	geo	Dirección y coordenadas geográficas del comercio	Sí
   Comercio	teléfono	Teléfono del comercio	Sí
   Comercio	category	El tipo de lugar del comercio	Deseable
   Comercio	action_link	Información sobre los vínculos directos específicos del comercio	Opcional si se proporcionan feeds de servicios; de lo contrario, es obligatorio
   Merchant	brand_id	Cadena que identifica la marca que se usará para el consumidor	Opcional
   Servicios	service_id	Identificador único del servicio proporcionado por el comercio	Sí (solo si se proporciona el feed de servicios)
   Servicios	merchant_id	Vínculo al comercio que proporciona este servicio	Sí (solo si se proporciona el feed de servicios)
   Servicios	localized_service_name	Nombre del servicio proporcionado	Sí (solo si se proporciona el feed de servicios)
   Servicios	localized_description	Descripción del servicio visible para el usuario	Opcional
   Servicios	action_link	Proporciona información sobre los vínculos directos relacionados con el servicio	Sí (solo si se proporciona el feed de servicios)
   Servicios	tipo	Tipo de vínculo directo (p.ej., SERVICE_TYPE_DINING_RESERVATION)	Sí (solo si se proporciona el feed de servicios)

   Nota: Se deben ignorar todos los campos adicionales descritos en la sección de referencia.
   Punto clave: Solo debes subir el feed de comercio.

   Para comenzar, revisa los feeds de muestra

   • Feeds de reserva de restaurantes
   • Feed de entrega de pedidos de comida
   • Feed de retiro de pedidos de comida
   • Feeds de pedidos de comida con metadatos
   • Feeds de pedidos de venta minorista
   • Feeds de pedidos minoristas con metadatos
   • Feeds de reservas presenciales
   • Feeds de reservas virtuales o en línea

   En el caso de los comercios que tienen varios servicios, pero los publican mediante un solo vínculo de acción, debes proporcionar un solo vínculo de acción para todos los servicios asociados con un comercio en el feed de comercios.

   Si deseas obtener más información para especificar vínculos de acción en los feeds de integración de partida heredados aquí.

   Incluye metadatos del feed en cada uno de tus feeds que le indiquen a Google cómo interpretar el feed.

   A continuación, se muestra un fragmento de metadatos del feed:

   "metadata": {
    "generation_timestamp": "1467993600",
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "total_shards": 1
   }
   

   Nota: Todos los feeds deben subirse con el valor PROCESS_AS_COMPLETE en la propiedad process_instruction. PROCESS_AS_INCREMENTAL dejó de estar disponible y ya no se puede usar.
   Nota: La integración de inicio heredada también se puede implementar en conjunto con una integración de extremo a extremo del Centro de acciones o como un complemento de la integración de extremo a extremo. Para ello, también deberás implementar feeds de disponibilidad y los campos obligatorios de la integración de extremo a extremo, de acuerdo con esta guía.

2. Exporta tus feeds. El formato de los feeds se describe mediante la sintaxis del búfer de protocolo 3. Sin embargo, puedes consultar los ejemplos mencionados anteriormente para ver el formato JSON. Te recomendamos que subas los feeds en formato JSON.

   Si realmente quieres continuar con el formato pb3, a fin de obtener información general sobre cómo usar los búferes de protocolo para generar un archivo pb3, consulta Conceptos básicos del búfer de protocolo: Java.

3. Sube los feeds a tu buzón de SFTP. Para subir tus feeds, usa la información del buzón de SFTP que te proporcionó Google y la clave privada que creaste en Configuración. El servidor SFTP de Google está disponible en sftp://partnerupload.google.com, en el puerto 19321.

   Sube tus archivos con nombres únicos, como un nombre que incluya una marca de tiempo. Los nombres únicos ayudan a solucionar problemas y permiten realizar consultas sobre el estado del feed.

   Para determinar el tamaño de los feeds y la frecuencia de publicación, sigue estos lineamientos:

   • Tamaño de los archivos y fragmentos del feed:
     • El tamaño de archivo del feed debe ser inferior a los 200 MB (después de la compresión). Comprimirlas con gzip
     • Si tu archivo puede alcanzar más de 200 MB (después de la compresión), divídelo en varios fragmentos según el instructivo sobre fragmentación de archivos de feed . Sin embargo, es poco probable que por sí sola la integración de inicio heredada alcance el límite de 200 MB.
   • Frecuencia de las actualizaciones completas:
     • Se proporciona un feed completo de comercios una vez al día.
     • (Si está implementado) Se proporciona un feed de servicio completo una vez al día.
   Nota: Google procesa los archivos de feed en cuanto se suben al buzón de SFTP. Si el feed se fragmenta en varios archivos, el proceso comienza después de que subes el último archivo. Si tu feed contiene errores, recibirás un correo electrónico con los códigos de error del feed.

Google evalúa los feeds

Una vez que subes tus feeds, Google los procesa y evalúa para comprobar su integridad y calidad. Consideramos los siguientes factores:

• Los feeds cumplen con las especificaciones.
• Los feeds incluyen todos los campos obligatorios.
• Cada comercio tiene, al menos, un action_link o un servicio con, al menos, action_link definido.
• La mayoría de los datos de tus comercios coinciden con las ubicaciones de Google Maps.

Nota: Para garantizar una integración sin problemas, realiza una evaluación previa de los factores mencionados anteriormente, excepto el último, antes de enviar tus feeds.