Feeds

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

Crea feeds

1. Genere sus feeds. La mayoría de los datos de tu inventario se transmiten a Google mediante feeds. Para comenzar, cree su feed de Merchant (y el de Servicios, si corresponde):

   • 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 / no recomendado): No se recomienda implementar feeds de servicios para integraciones de principiantes. Si deseas mantener tu integración existente, sigue esta documentación heredada.

   Campos obligatorios y recomendados

   Feed	Nombre del campo	Descripción	¿Obligatorio?
   Comercio	merchant_id	Identificador único del comercio	Sí
   Comercio	name	Nombre del comerciante	Sí
   Comercio	geo	Dirección y coordenadas geográficas del comercio	Sí
   Comercio	teléfono	Teléfono del comerciante	Sí
   Comercio	categoría	Tipo de lugar del comercio	Deseable
   Comercio	action_link	Información sobre los vínculos directos específicos del comercio	Sí
   Merchant	ID de la marca	String que identifica la marca orientada al consumidor que se usará	Opcional

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

   Para comenzar, consulte los feeds de muestra.

   • Feeds de pedidos minoristas
   • Feeds de pedidos minoristas con metadatos

   Puedes obtener más información sobre cómo especificar vínculos de acción en los feeds de la integración inicial aquí.

   Incluye metadatos del feed en cada uno de tus feeds para que Google pueda interpretarlos.

   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 processing_instruction. PROCESS_AS_INCREMENTAL dejó de estar disponible y ya no puede usarse.
   Nota: La integración inicial también se puede implementar junto con la integración de extremo a extremo de Reserva con Google o como un complemento de la integración de extremo a extremo. Para ello, también deberás implementar los feeds de disponibilidad y los campos obligatorios de integración de extremo a extremo, según se indica en 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. Le recomendamos que suba los feeds en formato JSON.

   Si deseas continuar con el formato pb3, obtén información general sobre cómo usar búferes de protocolo a fin de 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 la Configuración. El servidor SFTP de Google está disponible en sftp://partnerupload.google.com, en el puerto 19321.

   Sube los archivos con nombres únicos, como un nombre que incluya una marca de tiempo. Los nombres únicos son útiles para 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, utilice los siguientes lineamientos:

   • Tamaño de los archivos del feed y Shards:
     • El tamaño de archivo del feed debe no superar los 200 MB (después de la compresión). Comprimirlos mediante gzip
     • Si el archivo puede alcanzar más de 200 MB (después de la compresión), divídelos en varios fragmentos siguiendo el instructivo Fragmenta archivos de feed . Sin embargo, es poco probable que la integración inicial alcance el límite de 200 MB por sí sola.
   • Frecuencia de las actualizaciones completas:
     • Se proporciona un feed de comercio completo una vez al día.
     • (Si se implementa), se proporciona un feed de servicio completo una vez al día.
   Nota: Google procesa los archivos del feed en cuanto se suben al buzón de SFTP. Si el feed está fragmentado 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 los feeds, Google los procesa y evalúa su calidad y exhaustividad. 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 anteriores, excepto en el último, antes de enviar tus feeds.