Produktdaten abrufen
In Workflows, die Produktdaten verwenden, kannst du die Aktion Produktdaten abrufen verwenden, um Produktinformationen aus deinem Shop abzurufen.
Auf dieser Seite
Konfiguration
Felder
Die Aktion Produktdaten abrufen enthält die folgenden Felder, die zur Erstellung der Abfrage verwendet werden:
| Feld | Beschreibung |
|---|---|
| Daten sortieren nach | Erforderlich. Der Parameter, gemäß dem die von der Suchabfrage zurückgegebenen Daten sortiert werden. |
| Maximale Anzahl von Ergebnissen | Erforderlich. Die maximale Anzahl an Ergebnissen, die von der von dir ausgewählten Suchabfrage zurückgegeben werden können. Du kannst bis zu 100 Ergebnisse gleichzeitig zurückgeben. |
| Abfrage | Erforderlich. Wähle eine der üblichen Abfragen oder Erweitert aus, um deine eigene Abfrage zu erstellen. |
Abfrage-String
Es folgt eine Beispielabfrage zum Abrufen von Produkten, die innerhalb des letzten Tages aktualisiert wurden:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Die Variable updated_at ist ein Filter, der für die Abfrage von Produkten verfügbar ist und mehrfach verwendet oder mit anderen Variablen kombiniert werden kann. Die Liquid-Variable scheduledAt ist für Workflows mit dem Trigger Geplanter Zeitpunkt verfügbar. Das Liquid-Tag date_minus ist ein spezielles Flow-Tag, mit dem du Zeit von einem Datum abziehen kannst.
Bei der Abfrage von Daten ist Folgendes hilfreich:
- Liste der verfügbaren Filter für Produkte - Abfragen müssen einer bestimmten Syntax folgen.
- Abfragefeldwerte werden nicht immer dokumentiert. In einigen Fällen können die Werte in den API-Dokumenten ausfindig gemacht werden. Alternativ dazu findest du die Feldwerte häufig in den URLs im Adminbereich, wenn du Filter anwendest. Um zum Beispiel nach einigen Abfragewerten für Bestellungen zu suchen, filtere die Seite "Bestellungen" im Adminbereich und überprüfe anschließend die URL.
- Mit der Shopify GraphQL-App kannst du eine Abfrage in deinem Shop ausführen oder testen.
- Achte darauf, was passiert, wenn deine Abfrage einen Fehler verursacht. Häufig gibt die API dann alle Ergebnisse zurück (anstelle von keinen Ergebnissen).
Zurückgegebene Daten
Alle Aktionen vom Typ Daten abrufen geben eine Liste von 0 bis 100 Ressourcen zurück. Je nach Anwendungsfall kannst du diese Daten auf verschiedene Weise nutzen:
- Wenn du jedes Listenelement einzeln bearbeiten musst, z. B. um jedem Element ein Tag hinzuzufügen, kannst du die Aktion Für jeden verwenden.
- Wenn du Daten aggregieren musst, z. B. um zu zählen, wie viele Ergebnisse zurückgegeben wurden, kannst die Aktionen Anzahl oder Summe verwenden.
- Wenn du die Liste ausgeben musst, z. B. um eine E-Mail mit allen Elementen zu senden, kannst du die zurückgegebenen Daten direkt in den nachfolgenden Aktionen verwenden.
Verwende die Variable mit der Bezeichnung Produktdaten abrufen, um in den darauf folgenden Schritten auf die zurückgegebenen Daten zuzugreifen. Bei der Variable handelt es sich um eine Produktliste. Du kannst diese Variable sowohl in Bedingungen als auch für Aktionen verwenden. Du kannst zum Beispiel die Liste der Produkte mit der Aktion Interne E-Mail senden wie folgt senden:
{% for single_product in GetProductData %}
- {{ single_product.name }}
{% endfor %}Trigger
Du kannst diese Aktion in jedem beliebigen Workflow mit dem Trigger Geplanter Zeitpunkt verwenden. In einem Workflow, der den Trigger Geplanter Zeitpunkt verwendet, wird der Workflow nicht als Ergebnis eines Ereignisses gestartet, sondern zu einem von dir angegebenen Zeitpunkt. Da es kein bestimmtes Ereignis in deinem Shop oder von einer App gibt, das den Workflow startet, enthält dieser nicht automatisch Daten.
API-Details
Vorlagen
Produkte mit einem Tag in der Zukunft zu einer Kollektion hinzufügen
Rufe an einem Datum in der Zukunft Produkte mit einem bestimmten Tag ab und füge sie anschließend einer Kollektion hinzu. Vorlage anzeigen
Inaktive Produkte deaktivieren
Lösche Produkte ohne Inventar, die ein Jahr lang nicht aktualisiert wurden. Vorlage anzeigen
Produkte mit einem bestimmten Tag in der Zukunft veröffentlichen
Rufe an einem Datum in der Zukunft Produkte mit einem bestimmten Tag ab und veröffentliche sie. Verwende dazu die Aktionen "Geplanter Zeitpunkt" und "Produktdaten abrufen". Vorlage anzeigen
"Neues Produkt"-Tag 90 Tage nach der Erstellung des Produkts entfernen
Jeden Tag gibt es bis zu 100 Produkte, deren Erstellung mehr als 90 Tage zurück liegt und die immer noch das "Neu"-Tag haben. Durch den Workflow werden diese Tags dann für jedes Produkt entfernt. Vorlage anzeigen
Produkte planen, die an einem bestimmten Datum und zu einer bestimmten Uhrzeit aus dem Onlineshop entfernt werden sollen
Entferne an einem Datum in der Zukunft Produkte über ein Tag, über ihre ID oder über die SKU aus deinem Onlineshop. Verwende dazu die Aktionen "Geplanter Zeitpunkt" und "Produktdaten abrufen" und die Schleife "Für jeden". Vorlage anzeigen
Tägliche E-Mail-Übersicht der nicht vorrätigen Produkte senden
Ruft jeden Tag alle Produkte mit einem Inventar von 0 ab und sendet eine E-Mail-Übersicht. Verwendet die Trigger "Produktdaten abrufen" und "Geplanter Zeitpunkt". Vorlage anzeigen
E-Mail-Benachrichtigung senden, wenn eine Variante mit einer duplizierten SKU hinzugefügt wird
Überprüft, wenn eine Variante hinzugefügt wird, ob es andere Varianten mit derselben SKU gibt. Wenn ja, wird eine interne E-Mail mit Links zu den betroffenen Produkten und Varianten gesendet. Vorlage anzeigen
Nachverfolgung von Produktvarianten, die im Sale sind, mithilfe eines Metafelds für Produkte
Legt ein Metafeld für ein Produkt fest, wenn mindestens eine seiner Varianten im Sale ist. Dies kann nützlich sein, um zu verfolgen, welche Produkte derzeit im Sale sind. Vorlage anzeigen