Obtener datos de producto
En los flujos de trabajo que usan datos de producto, puedes usar la acción Obtener datos de producto para recuperar información de producto de la tienda.
Configuración
Campos
La acción Obtener datos de producto incluye los siguientes campos, que se usan para crear la consulta:
| Campo | Descripción |
|---|---|
| Ordenar datos por | Obligatorio. Los parámetros por los que se ordenan los datos que devuelve la consulta de búsqueda. |
| Número máximo de resultados | Obligatorio. La cantidad máxima de resultados que puede devolver la consulta de búsqueda que seleccionas. Puedes devolver hasta 100 a la vez. |
| Consulta | Obligatorio. Elige entre consultas comunes o selecciona Avanzado para crear una propia. |
Cadena de consulta
Esta es una consulta de ejemplo para obtener productos actualizados en el último día:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'La variable updated_at es un filtro disponible en la Products query y se puede usar varias veces o combinar con otras variables. La variable de Liquid scheduledAt está disponible en los flujos de trabajo que usan el activador Hora programada. La etiqueta de Liquid date_minus es una etiqueta especial de Flow que permite restar tiempo a una fecha.
Cuando consultes datos, conviene saber:
- Lista de filtros de producto disponibles
- Las consultas deben seguir una sintaxis determinada
- Los valores de los campos de consulta no siempre están documentados. En algunos casos, puedes encontrarlos en la documentación de la API. Otra opción es buscar los valores de los campos en las URLs del panel de control cuando aplicas filtros. Por ejemplo, para encontrar algunos valores de consulta de pedidos, filtra la página Pedidos en el panel de control y luego revisa la URL.
- Puedes ejecutar o probar una consulta en la tienda usando la Shopify GraphiQL app.
- Ten en cuenta qué sucede si la consulta falla. A menudo la API devuelve todos los resultados (en lugar de ninguno).
Datos devueltos
Todas las acciones Obtener datos devuelven una lista de entre 0 y 100 recursos. Según el caso de uso, quizá quieras usar estos datos de distintas maneras:
- Si necesitas procesar cada elemento de la lista por separado, por ejemplo para agregar una etiqueta a cada uno, puedes usar la acción Para cada.
- Si necesitas agregar datos, como contar cuántos resultados se devolvieron, puedes usar las acciones Contar o Sumar.
- Si necesitas mostrar la lista, por ejemplo enviar un correo electrónico con todos los elementos, puedes usar los datos devueltos directamente en acciones posteriores.
Para acceder a los datos devueltos en los pasos que siguen a esta acción, usa la variable llamada Obtener datos de producto, que es una lista de productos. Puedes usar esta variable tanto en condiciones como en acciones. Por ejemplo, puedes enviar la lista de productos en una acción Enviar correo electrónico interno de esta forma:
{% for single_product in GetProductData %}
* {{ single_product.name }}
{% endfor %}Activadores
Puedes usar esta acción en cualquier flujo de trabajo, incluido el activador Hora programada. En un flujo de trabajo que usa el activador Hora programada, el flujo comienza en el horario que especificaste, en lugar de como resultado de un evento. Como no hay un evento específico en la tienda o de una app que inicie el flujo de trabajo, no se incluye ningún dato automáticamente.
Detalles de la API
Plantillas
Agregar más adelante los productos con una etiqueta a una colección
En un momento futuro, recupera todos los productos con una etiqueta determinada y luego los agrega a una colección. Ver plantilla
Eliminar productos inactivos
Eliminar productos sin inventario que no se han actualizado en un año. Ver plantilla
Publicar más adelante los productos con una etiqueta determinada
En una fecha futura, recupera los productos con una etiqueta determinada y los publica. Usa el activador Hora programada y la acción Obtener datos de producto. Ver plantilla
Quitar la etiqueta de producto "nuevo" 90 días después de crear el producto
Cada día, recupera hasta 100 productos creados hace más de 90 días que todavía tienen la etiqueta "nuevo". Luego, el flujo de trabajo elimina esa etiqueta de cada producto. Ver plantilla
Programar que se retiren productos de la tienda online en la fecha y hora especificadas
En una única fecha futura, retira productos de la tienda online por etiqueta, ID o SKU. Usa el activador Hora programada, la acción Obtener datos de producto y un bucle para cada. Ver plantilla
Enviar un resumen diario por correo electrónico con los productos agotados
Cada día, recupera todos los productos con inventario 0 y envía un resumen por correo electrónico. Usa Obtener datos de producto y el activador Hora programada. Ver plantilla
Enviar una notificación por correo electrónico cuando se agregue una variante con un SKU duplicado
Cuando se agrega una variante nueva, verifica si alguna otra variante usa el mismo SKU. Si es así, envía un correo electrónico interno con enlaces a los productos y variantes afectados. Ver plantilla
Hacer seguimiento de las variantes de producto en oferta mediante un metacampo de producto
Establece un metacampo en un producto si al menos una de sus variantes está en oferta. Esto puede ser útil para hacer seguimiento de qué productos están actualmente en oferta. Ver plantilla