Prácticas recomendadas

En este documento, se brindan lineamientos sobre las prácticas recomendadas. Consulta las Sugerencias sobre rendimiento para obtener más información.

Cuándo usar la API

Para enviar solicitudes de manera programática

Ya sea que prefieras automatizar cada parte de tu flujo de trabajo o crear un enlace a tu sistema de ERP (planificación de recursos empresariales), Content API te permite enviar actualizaciones en cuanto cambie tu inventario.

Para recibir comentarios inmediatos

En Content API, obtienes una respuesta a cada solicitud al instante, en lugar de hacerlo mediante un resumen por correo electrónico después de que se procesan los feeds de datos. Se espera una latencia de cinco a diez segundos para las solicitudes por lotes grandes.

Cómo cambiar tus datos de productos con frecuencia

Con Content API, puedes realizar actualizaciones incrementales en tu inventario de productos, que cambia rápidamente, muchas veces al día, pero no es posible enviar el feed de datos completo cada vez. Si las actualizaciones están disponibles de forma individual, envíalas de forma individual. No esperes hasta que haya varias actualizaciones para poder agruparlas. Del mismo modo, si las actualizaciones están disponibles en lotes, envíalas por lotes, no las dividas en solicitudes individuales.

Administrar varias cuentas secundarias

Las cuentas de Merchant Center recién creadas son cuentas únicas que conservan su propio conjunto de datos de productos. Esto funciona bien en la mayoría de los casos, pero a medida que crece la cuenta, es posible que necesites un sistema de administración más complejo para tus productos. Si este es tu caso, considera usar una cuenta de varios clientes o MCA. La administración a nivel de API de una cuenta de MCA se puede llevar a cabo a través del servicio de cuentas y permite agregar y administrar cuentas secundarias de forma programática. Puedes encontrar aquí más información para obtener una cuenta de MCA.

Cómo usar la API

No utilices la API como lo harías con los feeds de datos.

Evita las actualizaciones diarias de todo tu feed de productos cuando uses el recurso products. En su lugar, actualiza de forma específica solo aquellos productos cuyos datos realmente cambiaron. Enviar tu feed de datos completo a través del recurso products consume más tiempo y recursos, tanto para Google como para ti.

No uses la API para recuperar regularmente la información de productos que subiste

Si eres responsable de mantener la información del producto en una cuenta de Merchant Center en particular, evita solicitarla a través de Content API con los métodos products.get o products.list de forma periódica. En el caso de los clientes que suben información, estos métodos pueden ayudarte a depurar problemas cuando diseñes soluciones que usen Content API. Sin embargo, no están diseñadas para la recuperación habitual de información de productos por parte de esos clientes. Debes tener otra fuente para la información de tus productos, como una base de datos de productos locales, y los productos de Merchant Center deben reflejar el contenido de esa fuente.

No utilice feeds de datos y Content API para enviar artículos de productos.

Si estás considerando cambiar a la API para el envío de artículos, asegúrate de que ya no uses feeds de datos para enviar artículos de productos. Si continúas enviando artículos en ambos medios, pueden generarse resultados inesperados.

¿Existe alguna manera de usar de manera segura la API y los feeds de datos en conjunto?

Puedes manipular tus feeds de datos con el servicio de feed de datos de la API. Si bien esto facilitará la administración del feed de datos a gran escala, ten en cuenta que no debes insertar ni actualizar productos usando la API al mismo tiempo que los feeds, ya que podrían ocurrir resultados inesperados.

Entre otros ejemplos de formas aceptables de usar feeds y la API de forma conjunta se incluyen los siguientes:

  • Ejecución de solicitudes de solo lectura (get o list) desde la API: algunos comercios desean usar la API para recuperar información y actualizaciones de estado de sus productos. Esto es aceptable porque solo los feeds actualizan la información de los productos.

  • Usar la API para administrar tus cuentas secundarias (Servicio de cuentas) o la configuración de impuestos y envíos a nivel de la cuenta (Servicio de cuenta fiscal y Servicio de configuración de envío) Estas no son funciones que los feeds de datos pueden proporcionar, por lo que no se generan conflictos con el uso de la API para administrarlas.

¿Cómo migro de usar feeds de datos a usar solo la API o viceversa?

Si actualmente usas feeds de datos y quieres usar solo la API para actualizar productos, debes volver a subir tus datos de productos con la API. Cuando usas el servicio de productos para actualizar un producto determinado, la API toma el control de la información del producto, y borrar el producto del feed de datos o borrar el feed de datos ya no quita la información del producto de tu cuenta de Merchant Center. Asegúrate de que no haya actualizaciones del feed de datos si deseas quitar el producto del feed de datos o del feed de datos en sí. De lo contrario, el feed de datos volverá a tomar propiedad y, si se quita el producto del feed de datos, se quitará el producto.

Si actualmente usas solo la API para la información de los productos y deseas usar feeds de datos como tu fuente principal de información del producto, simplemente puedes agregar el nuevo feed de datos a tu cuenta de Merchant Center para que se haga cargo de los productos en la lista. Si hay productos que quieres quitar antes de su vencimiento y que solo se subieron desde la API, debes borrarlos a través de Merchant Center o la API.

¿Cómo puedo orientar los productos a varios países mediante Content API for Shopping?

Si quieres segmentar los anuncios y fichas gratuitas para varios países de los productos enviados mediante Content API, configura países adicionales en el feed principal de Content API en Merchant Center o agrega esos países adicionales mediante el campo shipping del recurso products.

A continuación, se muestra un ejemplo de cómo modificar la configuración del feed principal de Content API.

Para obtener más información, consulta el artículo Segmenta anuncios de Shopping y fichas gratuitas en varios países.

Asegúrate de que tus bibliotecas cliente estén actualizadas

Si usas una biblioteca cliente de Google para interactuar con Content API, asegúrate de usar el administrador de paquetes del lenguaje de programación que elegiste y de que la versión de la biblioteca esté actualizada. Si deseas obtener más información, consulta la guía para desarrolladores del lenguaje que elegiste en Muestras y bibliotecas.

Asegúrese de usar los atributos de destinos para controlar qué productos aparecen en los distintos programas de compras.

Content API adopta automáticamente la configuración predeterminada para tu feed de Content API como se estableció en Merchant Center. Puedes usar los atributos de producto includedDestinations o excludedDestinations para controlar la participación en el programa a nivel del producto dentro de un feed o a través de Content API.

Si tu feed de API está habilitado en un programa, por ejemplo, Comprar con Google (antes conocido como Shopping Actions), pero deseas excluir ciertos productos, usa el atributo excludedDestinations y especifica Shopping Actions como valor. Siempre que no haya errores, se reemplazará la configuración predeterminada del feed en Merchant Center y ese artículo específico no aparecerá en Comprar con Google (antes conocido como Acciones de Shopping). Por el contrario, si tu feed no está habilitado en un programa (por ejemplo, Shopping), puedes incluir artículos individuales usando el atributo includedDestinations y Shopping_ads como valor, y el artículo aparecerá en los anuncios de Shopping.

Para obtener más información sobre los atributos de producto includedDestinations y excludedDestinations, consulta el Centro de ayuda.

Asegúrate de actualizar los artículos antes de que venzan

Si un elemento no cambia antes de su vencimiento, 30 días después de la última actualización o en la fecha de vencimiento especificada (si es antes), actualízalo para evitar que se desactive. Si necesitas actualizar muchos elementos, ya que ninguno de ellos cambió o no puedes realizar un seguimiento de cuándo se actualizaron por última vez, no actualices todos los elementos al mismo tiempo, sino distribuye la carga de manera uniforme durante varios días.

No borre el feed de Content API, ya que es posible que sus productos desaparezcan.

La primera vez que subas un producto con channel:online a través de Content API, aparecerá un feed nuevo en Merchant Center llamado Content API. La primera vez que subas un producto con channel:local a través de Content API, aparecerá un feed nuevo en Merchant Center con el título Content API con un subtítulo en Productos locales. Asegúrate de no borrar accidentalmente el feed local o en línea de Content API. Según el feed que borres, se quitarán los productos locales o en línea que hayas agregado a Merchant Center mediante Content API.

Agrupa varias solicitudes por lotes al mismo servicio con el método custombatch

En lugar de realizar muchas solicitudes secuenciales o paralelas al mismo servicio, realiza una sola solicitud por lote personalizado que contenga todas las solicitudes deseadas. De esta manera, la latencia para realizar solicitudes al extremo de la API solo ocurre una vez en la llamada por lotes personalizados y no en cada solicitud individual, lo que es muy importante si realizas solicitudes secuenciales.

No envíes varias actualizaciones de un solo artículo con un solo lote

Esto generará resultados inesperados debido a la incertidumbre en cuanto a la secuencia de actualizaciones y puede causar un error de conflicto.

No enviar actualizaciones de los artículos sin cambios

Asegúrate de enviar solicitudes de artículos de productos nuevos, modificados o borrados solo, a menos que los artículos venzan de otra forma.

Usa feeds complementarios si los precios o la disponibilidad cambian rápidamente.

Si tienes problemas para mantener actualizada la información de precio, disponibilidad o oferta de un producto, considera usar los feeds complementarios del recurso products para enviar actualizaciones solo para esos atributos. Dado que las actualizaciones de feeds complementarios son pequeñas, en un período determinado, puedes realizar muchas más actualizaciones de feeds complementarios que las actualizaciones de productos completas. Esto ayudará a mantener los precios y la disponibilidad de tus productos en línea con las páginas de destino.

Otra forma de actualizar el precio y la disponibilidad de un producto es usar las actualizaciones automáticas de artículos. Se puede usar junto con las actualizaciones de la API para evitar discrepancias entre la información de Merchant Center y la de las páginas de destino de los productos. Sin embargo, ten en cuenta que este sistema se diseñó para solucionar pequeños problemas relacionados con la precisión del precio y la disponibilidad de los productos, por lo que las actualizaciones automáticas de artículos no reemplazan la opción de proporcionar la información correcta a través de la API.

Cuándo usar un token de actualización

El token de actualización se devuelve en el encabezado HTTP de las solicitudes de autorización. Contiene mucha otra información relacionada con la autenticación, pero el token de actualización es, a menudo, la parte que los desarrolladores quieren poner en práctica, ya que elimina la necesidad de solicitar la autenticación al usuario reiteradamente, ya que los tokens de acceso duran solo 60 minutos antes de que venzan.