En este documento, se brindan lineamientos sobre las prácticas recomendadas. Consulta las sugerencias de 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 con tu sistema de ERP (planificación de recursos empresariales), Content API te permite enviar actualizaciones en cuanto cambia tu inventario.
Para recibir comentarios inmediatos
En Content API, obtienes una respuesta a cada solicitud de forma instantánea, en lugar de hacerlo a través de 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 solicitudes por lotes grandes.
Para cambiar tus datos de productos con frecuencia
Con Content API, puedes realizar actualizaciones incrementales en tu inventario de productos de alta velocidad muchas veces al día, mientras que enviar todo el feed de datos cada vez no es factible. Si las actualizaciones están disponibles de forma individual, envíalas individualmente, no esperes hasta que haya varias actualizaciones para poder agruparlas. Del mismo modo, si las actualizaciones están disponibles en lotes, envíalas en lotes, no las dividas en solicitudes individuales.
Para 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 o MCA. La administración de una cuenta de MCA a nivel de API se puede realizar a través del servicio de cuentas y permite agregar y administrar cuentas secundarias de forma programática. Puedes encontrar más información sobre cómo obtener una cuenta MCA aquí.
Cómo usar la API
No uses la API como lo harías con feeds de datos
Evita las actualizaciones diarias de todo tu feed de productos cuando uses el recurso products.
En su lugar, actualiza específicamente solo los productos cuyos datos realmente cambiaron. Enviar el 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 con regularidad la información de los productos que subiste
Si eres responsable de mantener la información del producto en una cuenta de Merchant Center en particular, evita solicitarla a 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 usan Content API. Sin embargo, estos clientes no están destinados a que estos clientes recuperen la información de los productos con regularidad. 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 uses feeds de datos y Content API para enviar artículos de productos al mismo tiempo
Si estás considerando cambiar a la API para enviar artículos, asegúrate de no usar feeds de datos más para enviar artículos de productos. Si continúas enviando artículos por ambos medios, podrían producirse resultados inesperados.
¿Existe alguna manera de usar la API y los feeds de datos de forma segura 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 de feeds 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 producirse resultados inesperados.
A continuación, se indican otros ejemplos de maneras aceptables de utilizar feeds y la API en conjunto:
Ejecución de solicitudes de solo lectura (get o list) de la API: algunos comercios quieren 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 del producto.
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 impuestos de cuentas y Servicio de configuración de envío) Estas no son funciones que los Datafeeds pueden proporcionar, por lo que no hay conflicto con el uso de la API para administrarlas.
¿Cómo paso de usar feeds de datos a usar solo la API o viceversa?
Si actualmente usas feeds de datos y quieres comenzar a 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 en sí ya no quitará la información del producto de tu cuenta de Merchant Center. Asegúrese de que no haya actualizaciones del feed de datos si desea eliminar el producto del feed de datos o del feed de datos en sí. De lo contrario, el feed de datos volverá a asumir la propiedad y quitará el producto del feed de datos.
Si actualmente solo usas la API para la información de productos y deseas utilizar feeds de datos como tu fuente principal de información de productos, solo tienes que agregar el nuevo feed de datos a tu cuenta de Merchant Center, y esa persona se hará cargo de los productos de la lista. Si quieres quitar productos antes del vencimiento y que se subieron solo desde la API, debes borrarlos a través de Merchant Center o la API.
¿Cómo puedo segmentar los productos para varios países con Content API for Shopping?
Si quieres segmentar los anuncios y las fichas gratuitas de los productos enviados a través de Content API a varios países, configura países adicionales en el feed principal de Content API en Merchant Center o agrega los países adicionales con el campo shipping en el recurso products.
A continuación, se incluye un ejemplo de cómo modificar la configuración del feed principal de Content API.
Para obtener más información, consulta Segmentación de anuncios de Shopping y fichas gratuitas en varios países.
Asegúrate de que las 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 de tu lenguaje de programación elegido y de que la versión de la biblioteca esté actualizada. Si deseas obtener más información, consulta la guía para desarrolladores correspondiente al lenguaje que hayas elegido en Muestras y bibliotecas.
Asegúrate de usar los atributos de destino 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, tal 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 Acciones de Shopping), pero deseas excluir ciertos productos, usa el atributo excludedDestinations y especifica Shopping Actions como el valor. Siempre y cuando no haya errores, esta acción 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). En cambio, 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 anterior), actualiza el elemento para evitar que se desactive. 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 distribuyes la carga de manera uniforme durante varios días.
No borres el feed de Content API; de lo contrario, es posible que desaparezcan tus productos
La primera vez que subas un producto con channel:online a través de Content
API, aparecerá un nuevo feed en Merchant Center llamado Content API. La primera
vez que subas un producto con channel:local a través de Content API, aparecerá un nuevo
feed 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 locales o en línea que hayas agregado a Merchant Center mediante 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 por lotes personalizado que contenga todas las solicitudes deseadas. De esta manera, la latencia para realizar solicitudes al extremo de la API solo ocurre una vez para la llamada por lotes personalizados en lugar de en cada solicitud individual, lo que es muy importante si realizas solicitudes secuenciales.
No envíes varias actualizaciones a un solo artículo en un solo lote
Esto generará resultados inesperados debido a la incertidumbre de la secuencia de actualizaciones y puede causar un error de conflicto.
No enviar actualizaciones para artículos no modificados
Asegúrate de enviar solo solicitudes de productos nuevos, modificados o borrados, 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 actualizados el precio, la disponibilidad o la información
de oferta de un producto, considera usar los
feeds complementarios en el recurso products
para enviar actualizaciones solo de esos atributos. Dado que las actualizaciones de feeds complementarias son pequeñas, puedes realizar muchas más actualizaciones de feeds complementarias en un período determinado
que las actualizaciones completas de productos, lo que ayudará a mantener los precios
y la disponibilidad de los productos en línea con las páginas de destino.
Otra forma para actualizar el precio y la disponibilidad de los productos 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 en Merchant Center y la información en las páginas de destino del producto. Sin embargo, ten en cuenta que esto está diseñado para solucionar pequeños problemas de precisión en cuanto al precio y la disponibilidad de los productos, por lo que las actualizaciones automáticas de artículos no reemplazan el hecho de proporcionar también la información correcta a través de la API.
Cuándo usar un token de actualización
El token de actualización se muestra 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 la pieza que los desarrolladores quieren tener en cuenta, ya que quita la necesidad de solicitar la autenticación al usuario de forma reiterada, ya que los tokens de acceso duran solo 60 minutos antes de vencer.