Obtener datos de tarjeta de regalo
En flujos de trabajo que requieren datos de tarjetas de regalo, puedes usar la acción Obtener datos de tarjeta de regalo para recuperar información de tarjetas de regalo de la tienda.
Es importante saber que la tienda tiene tanto productos de tarjeta de regalo, que se usan para generar tarjetas de regalo, como las tarjetas de regalo en sí, que son las que los clientes usan para hacer compras. La acción Obtener datos de tarjeta de regalo recupera información sobre las tarjetas de regalo en sí. Para obtener información sobre los productos de tarjeta de regalo, usa las acciones Get product data o Get product variant data.
En esta página
Configuración
Campos
La acción Obtener datos de tarjeta de regalo incluye los siguientes campos, que se usan para construir la consulta:
| Campo | Descripción |
|---|---|
| Ordenar datos por | Obligatorio. Parámetros que determinan cómo se ordenan los datos que devuelve la consulta de búsqueda. |
| Número máximo de resultados | Obligatorio. Número máximo de resultados que puede devolver la consulta de búsqueda que selecciones. Puedes obtener hasta 100 a la vez. |
| Consulta | Obligatorio. Elige entre consultas comunes o selecciona Avanzado para crear tu propia consulta. |
Cadena de consulta
Esta es una consulta de ejemplo para obtener tarjetas de regalo que se actualizaron en el último día:
created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'La variable created_at es un filtro disponible en la gift cards query y se puede usar varias veces o combinar con otras variables. La variable de Liquid scheduledAt está disponible en flujos de trabajo que usan el Scheduled time trigger. La etiqueta de Liquid date_minus es una etiqueta especial de Flow que permite restar tiempo a una fecha.
Cuando consultas datos, es útil saber:
Las consultas deben seguir una certain syntax
Los valores de los campos de las consultas no siempre están documentados. En algunos casos, puedes encontrarlos consultando la API docs. También suele ser posible encontrar los valores de los campos en las URL del panel de control cuando aplicas filtros. Por ejemplo, para encontrar algunos valores de consulta de pedidos, filtra la página de Pedidos en el panel de control y luego revisa la URL.
Puedes ejecutar o probar una consulta en la tienda con la Shopify GraphiQL app.
Ten en cuenta lo que sucede si la consulta falla. A menudo, la API devuelve todos los resultados (en lugar de ninguno).
Datos devueltos
Todas las acciones de Obtener datos devuelven una lista de entre 0 y 100 recursos. Según el caso de uso, puedes usar estos datos de distintas formas:
- Si necesitas manejar cada elemento de la lista de manera individual, por ejemplo, agregar una etiqueta a cada uno, puedes usar la acción For each.
- Si necesitas hacer agregaciones, por ejemplo contar cuántos resultados se devolvieron, puedes usar las acciones Count o Sum.
- Si necesitas mostrar la lista, por ejemplo enviar un correo electrónico con todos los artículos, 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 tarjetas de regalo, que es una lista de tarjetas de regalo. Puedes usar esta variable tanto en condiciones como en acciones. Por ejemplo, puedes enviar la lista de tarjetas de regalo en una acción de Enviar correo electrónico interno así:
{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.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 empieza en la hora que especificaste, en lugar de hacerlo como resultado de un evento. Como no hay un evento específico en la tienda ni en una app que inicie el flujo de trabajo, no se incluye ningún dato automáticamente.