En este documento, se proporcionan lineamientos sobre las prácticas recomendadas. Consulta Sugerencias de rendimiento para obtener más información.
Cuándo usar la API
Enviar solicitudes de forma programática
Ya sea que prefieras automatizar cada parte de tu flujo de trabajo o crear un gancho en tu sistema ERP (planificación de recursos empresariales), la Content API te permite enviar actualizaciones en cuanto cambia tu inventario.
Recibir comentarios inmediatos
En la API de Content, recibes una respuesta a cada solicitud de forma instantánea, en lugar de un resumen por correo electrónico después de que se procesan los feeds de datos. Se espera una latencia de entre cinco y diez segundos para las solicitudes de lotes grandes.
Cambiar con frecuencia tus datos de productos
Con Content API, puedes realizar actualizaciones incrementales de tu inventario de productos de rápida rotación varias veces al día, mientras que enviar todo tu feed de datos cada vez no es factible. Si las actualizaciones están disponibles de forma individual, envíalas de esa manera. No esperes a que haya varias para enviarlas en lote. Del mismo modo, si las actualizaciones están disponibles en lotes, envíalas en lotes y no las dividas en solicitudes individuales.
Administrar varias cuentas secundarias
Las cuentas de Merchant Center creadas recientemente 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 tu cuenta crezca, 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 (MCA). La administración a nivel de la API de una cuenta de MCA se puede realizar a través del servicio de Accounts y permite agregar y administrar subcuentas de forma programática. Puedes obtener más información para obtener una cuenta de MCA aquí.
Cómo usar la API
No uses la API como si fueran feeds de datos
Evita actualizar todo tu feed de productos a diario cuando uses el recurso products.
En su lugar, actualiza específicamente solo aquellos productos cuyos datos hayan cambiado. Enviar todo tu feed de datos a través del recurso products consume más tiempo y recursos tanto para Google como para ti.
No uses la API para recuperar con regularidad la información de los productos que subiste.
Si eres responsable de mantener la información de los productos en una cuenta específica de Merchant Center, evita solicitar información de los productos a la Content API a través de 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 la API de Content. Sin embargo, no están diseñados para la recuperación periódica de información de productos por parte de dichos clientes. Debes tener otra fuente para la información de tus productos, como una base de datos de productos locales, y los productos en Merchant Center deben reflejar el contenido de esa fuente.
No uses feeds de datos ni Content API para enviar artículos de productos.
Si estás considerando cambiar a la API para enviar artículos, asegúrate de que ya no estés usando feeds de datos para enviar artículos de productos. Si sigues enviando artículos en ambos medios, es posible que se produzcan resultados inesperados.
¿Existe alguna forma de usar de forma segura las APIs y los feeds de datos juntos?
Puedes manipular tus feeds de datos con el servicio de Datafeed de la API. Si bien esto facilitará mucho la administración de feeds de datos a gran escala, ten en cuenta que no debes insertar ni actualizar productos con la API de forma simultánea con los feeds, ya que podrían producirse resultados inesperados.
Estos son otros ejemplos de formas aceptables de usar los feeds y la API de forma conjunta:
Ejecutar solicitudes de solo lectura (obtener o enumerar) desde la API: Algunos comercios desean usar la API para recuperar información y actualizaciones de estado sobre sus productos. Esto es aceptable porque la información del producto solo se actualiza a través de los feeds.
Usar la API para administrar tus cuentas secundarias (servicio de Accounts) o la configuración de impuestos y envío a nivel de la cuenta (servicio de Accounttax y servicio de Shippingsettings) Estas no son funciones que los feeds de datos pueden proporcionar, por lo que no hay conflicto con el uso de la API para administrar estas funciones.
¿Cómo migro del uso de feeds de datos al uso exclusivo de la API o viceversa?
Si actualmente usas feeds de datos y quieres cambiar a usar solo la API para actualizar los productos, deberás 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 en sí ya no quitará la información del producto de tu cuenta de Merchant Center. Asegúrate de que no haya actualizaciones del feed de datos si quieres quitar el producto del feed de datos o el feed de datos en sí. De lo contrario, el feed de datos volverá a tomar la propiedad y quitar el producto del feed de datos provocará que se quite el producto.
Si actualmente solo usas la API para la información de productos y deseas usar los feeds de datos como tu fuente principal de información de productos, puedes simplemente agregar el nuevo feed de datos a tu cuenta de Merchant Center, y este se hará cargo de los productos que se muestren en la lista. Si hay productos que deseas quitar antes de que venzan y que se subieron solo desde la API, debes borrarlos a través de Merchant Center o de la API.
¿Cómo segmentar productos para varios países con la Content API for Shopping?
Para segmentar sus anuncios y fichas gratuitas para varios países con los productos enviados a través de Content API, configura países adicionales en el feed principal de Content API en Merchant Center o agrega esos países adicionales a través del campo shipping en el recurso products.
A continuación, se muestra un ejemplo de cómo modificar la configuración del feed principal de la API de Content.
Para obtener más información, consulta Cómo segmentar 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 la API de Content, asegúrate de usar el administrador de paquetes para el lenguaje de programación que elegiste y de que la versión de la biblioteca esté actualizada. Para obtener más información, consulta la guía para desarrolladores del lenguaje que elegiste en Samples and Libraries.
Asegúrate de usar los atributos de destino para controlar qué productos aparecen en los diferentes programas de compras.
Content API adopta automáticamente la configuración predeterminada de tu feed de Content API tal como se configuró 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 la Content API.
Si tu feed de la API se habilitó para 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 anulará la configuración predeterminada del feed en Merchant Center y ese artículo en particular no aparecerá en Comprar con Google (anteriormente conocido como Acciones de Shopping). Por el contrario, si tu feed no se habilitó para un programa, como Shopping, puedes incluir artículos individuales con 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 elementos antes de que venzan
Si un artículo no cambia antes de que venza, actualízalo 30 días después de la última actualización o en la fecha de vencimiento especificada, si es anterior, para evitar su desactivación. Si necesitas actualizar muchos elementos porque ninguno cambió o no puedes hacer un seguimiento de cuándo se actualizaron por última vez, no actualices todos los elementos al mismo tiempo, sino que distribuye la carga de manera uniforme durante varios días.
No borres el feed de Content API, ya que es posible que desaparezcan tus productos
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 llamado Content API con un subtítulo de Productos locales. Asegúrate de no borrar accidentalmente el feed de Content API en línea o local. Según el feed que borres, se quitarán los productos en línea o locales que hayas agregado a Merchant Center a través de Content API.
Agrupa varias solicitudes al mismo servicio con el método custombatch
En lugar de realizar muchas solicitudes secuenciales o paralelas al mismo servicio, realiza una sola solicitud de custombatch que contenga todas las solicitudes deseadas. De esta manera, la latencia para realizar solicitudes al extremo de la API solo se produce una vez para la llamada de custombatch en lugar de en cada solicitud individual, lo que es especialmente importante si realizas solicitudes secuenciales.
No envíes varias actualizaciones para un solo elemento en un solo lote.
Esto generará resultados inesperados debido a la incertidumbre sobre la secuencia de actualizaciones y puede provocar un error de conflicto.
No enviar actualizaciones para los elementos sin cambios
Asegúrate de enviar solicitudes solo para los elementos de productos nuevos, modificados o borrados, a menos que los elementos venzan.
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 venta de un producto, considera usar los feeds complementarios en el recurso products para enviar actualizaciones solo de esos atributos. Dado que las actualizaciones de los feeds complementarios son pequeñas, puedes realizar muchas más actualizaciones de feeds complementarios en un período determinado que actualizaciones completas de productos, lo que te ayudará a mantener los precios y la disponibilidad de tus productos en línea con tus páginas de destino.
Otra forma de actualizar el precio y la disponibilidad de los productos es usar las actualizaciones automáticas de artículos. Esto se puede usar además de las actualizaciones de la API para evitar discrepancias entre la información de Merchant Center y la información de las páginas de destino de los productos. Sin embargo, ten en cuenta que esta función se diseñó para solucionar problemas menores 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 necesidad 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 suele ser el elemento que los desarrolladores quieren obtener, ya que elimina la necesidad de solicitar repetidamente la autenticación al usuario, dado que los tokens de acceso solo duran 60 minutos antes de vencer.