Λήψη δεδομένων προϊόντος
Σε ροές εργασίας που χρησιμοποιούν δεδομένα προϊόντων, μπορείτε να χρησιμοποιήσετε την ενέργεια Λήψη δεδομένων προϊόντος για να ανακτήσετε πληροφορίες προϊόντων από το κατάστημά σας.
Διαμόρφωση
Πεδία
Η ενέργεια Λήψη δεδομένων προϊόντος περιέχει τα ακόλουθα πεδία, τα οποία χρησιμοποιούνται για τη δημιουργία του ερωτήματος:
| Πεδίο | Περιγραφή |
|---|---|
| Ταξινόμηση δεδομένων κατά | Απαιτείται. Οι παράμετροι με βάση τις οποίες ταξινομούνται τα δεδομένα που επιστρέφονται από το ερώτημα αναζήτησης. |
| Μέγιστος αριθμός αποτελεσμάτων | Απαιτείται. Ο μέγιστος αριθμός αποτελεσμάτων που μπορεί να επιστραφεί από το ερώτημα αναζήτησης που επιλέγετε. Μπορείτε να επιστρέψετε έως και 100 κάθε φορά. |
| Ερώτημα | Απαιτείται. Επιλέξτε από κοινά ερωτήματα ή επιλέξτε Για προχωρημένους για να δημιουργήσετε το δικό σας. |
Συμβολοσειρά ερωτήματος
Αυτό είναι ένα παράδειγμα ερωτήματος για τη λήψη προϊόντων που ενημερώθηκαν την τελευταία ημέρα:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Η μεταβλητή updated_at είναι ένα φίλτρο διαθέσιμο στο ερώτημα Products και μπορεί να χρησιμοποιηθεί πολλές φορές ή να συνδυαστεί με άλλες μεταβλητές. Η μεταβλητή Liquid scheduledAt είναι διαθέσιμη σε ροές εργασίας που χρησιμοποιούν το στοιχείο ενεργοποίησης «Προγραμματισμένη ώρα». Η ετικέτα Liquid date_minus είναι μια ειδική ετικέτα του Flow που σας επιτρέπει να αφαιρείτε χρόνο από μια ημερομηνία.
Κατά την υποβολή ερωτημάτων για δεδομένα, είναι χρήσιμο να γνωρίζετε τα εξής:
- Λίστα διαθέσιμων φίλτρων προϊόντων
- Τα ερωτήματα πρέπει να ακολουθούν μια συγκεκριμένη σύνταξη
- Οι τιμές των πεδίων ερωτημάτων δεν τεκμηριώνονται πάντα. Σε ορισμένες περιπτώσεις, μπορείτε να βρείτε τις τιμές ανατρέχοντας στην τεκμηρίωση του API. Εναλλακτικά, μπορείτε συχνά να βρείτε τις τιμές των πεδίων στα URL του πίνακα διαχειριστή όταν εφαρμόζετε φίλτρα. Για παράδειγμα, για να βρείτε ορισμένες τιμές ερωτημάτων παραγγελίας, φιλτράρετε τη σελίδα «Παραγγελίες» στον πίνακα διαχειριστή και, στη συνέχεια, ελέγξτε το URL.
- Μπορείτε να εκτελέσετε ή να δοκιμάσετε ένα ερώτημα στο κατάστημά σας χρησιμοποιώντας την εφαρμογή Shopify GraphiQL.
- Να είστε προσεκτικοί σχετικά με το τι συμβαίνει εάν το ερώτημά σας αποτύχει. Συχνά, το API θα επιστρέψει όλα τα αποτελέσματα (αντί για κανένα).
Επιστρεφόμενα δεδομένα
Όλες οι ενέργειες Λήψη δεδομένων επιστρέφουν μια λίστα από 0 έως 100 πόρους. Ανάλογα με την περίπτωση χρήσης σας, μπορεί να θέλετε να χρησιμοποιήσετε αυτά τα δεδομένα με διάφορους τρόπους:
- Αν χρειάζεται να διαχειριστείτε κάθε στοιχείο της λίστας ξεχωριστά, όπως για να προσθέσετε μια ετικέτα σε καθένα από αυτά, τότε μπορείτε να χρησιμοποιήσετε την ενέργεια For each.
- Αν χρειάζεται να συγκεντρώσετε δεδομένα, όπως να μετρήσετε πόσα αποτελέσματα επιστράφηκαν, τότε μπορείτε να χρησιμοποιήσετε τις ενέργειες Καταμέτρηση ή Άθροισμα.
- Αν χρειάζεται να εξάγετε τη λίστα, όπως για να στείλετε ένα email με όλα τα στοιχεία, τότε μπορείτε να χρησιμοποιήσετε τα επιστρεφόμενα δεδομένα απευθείας σε επόμενες ενέργειες.
Για να αποκτήσετε πρόσβαση στα επιστρεφόμενα δεδομένα σε βήματα που ακολουθούν αυτήν την ενέργεια, χρησιμοποιήστε τη μεταβλητή με το όνομα Λήψη δεδομένων προϊόντος, η οποία είναι μια λίστα προϊόντων. Μπορείτε να χρησιμοποιήσετε αυτήν τη μεταβλητή τόσο σε συνθήκες όσο και σε ενέργειες. Για παράδειγμα, μπορείτε να στείλετε τη λίστα των προϊόντων σε μια ενέργεια Αποστολή εσωτερικού email ως εξής:
{% for single_product in GetProductData %}
* {{ single_product.name }}
{% endfor %}Στοιχεία ενεργοποίησης
Μπορείτε να χρησιμοποιήσετε αυτήν την ενέργεια σε οποιαδήποτε ροή εργασίας, συμπεριλαμβανομένου του στοιχείου ενεργοποίησης Προγραμματισμένη ώρα. Σε μια ροή εργασίας που χρησιμοποιεί το στοιχείο ενεργοποίησης Προγραμματισμένη ώρα, η ροή εργασίας ξεκινά σε μια χρονική στιγμή που έχετε καθορίσει, αντί ως αποτέλεσμα ενός συμβάντος. Επειδή δεν υπάρχει κάποιο συγκεκριμένο συμβάν στο κατάστημά σας ή από μια εφαρμογή που ξεκινά τη ροή εργασίας, δεν συμπεριλαμβάνονται αυτόματα δεδομένα.
Λεπτομέρειες API
Πρότυπα
Προσθήκη προϊόντων με ετικέτα σε μια συλλογή στο μέλλον
Σε μια μελλοντική χρονική στιγμή, ανακτήστε όλα τα προϊόντα με μια συγκεκριμένη ετικέτα και, στη συνέχεια, προσθέστε τα σε μια συλλογή. Προβολή προτύπου
Διαγραφή ανενεργών προϊόντων
Διαγραφή προϊόντων χωρίς απόθεμα που δεν έχουν ενημερωθεί για ένα έτος. Προβολή προτύπου
Δημοσίευση προϊόντων με συγκεκριμένη ετικέτα στο μέλλον
Σε μια μελλοντική ημερομηνία, ανακτήστε προϊόντα με συγκεκριμένη ετικέτα και δημοσιεύστε τα. Χρησιμοποιεί το στοιχείο ενεργοποίησης «Προγραμματισμένη ώρα» και την ενέργεια «Λήψη δεδομένων προϊόντος». Προβολή προτύπου
Κατάργηση της ετικέτας «νέο» 90 ημέρες μετά τη δημιουργία του προϊόντος
Κάθε μέρα, ανακτά έως 100 προϊόντα που δημιουργήθηκαν πριν από περισσότερες από 90 ημέρες και τα οποία εξακολουθούν να φέρουν την ετικέτα «νέο». Στη συνέχεια, η ροή εργασίας καταργεί αυτές τις ετικέτες για κάθε προϊόν. Προβολή προτύπου
Προγραμματισμός κατάργησης προϊόντων από το Ηλεκτρονικό κατάστημα στη συγκεκριμένη ημερομηνία και ώρα
Σε μια μεμονωμένη μελλοντική ημερομηνία, καταργήστε προϊόντα από το διαδικτυακό κατάστημα βάσει ετικέτας, αναγνωριστικού ή κωδικού SKU. Χρησιμοποιεί το στοιχείο ενεργοποίησης «Προγραμματισμένη ώρα», την ενέργεια «Λήψη δεδομένων προϊόντος» και τον βρόχο «For Each». Προβολή προτύπου
Αποστολή ημερήσιας σύνοψης μέσω email με προϊόντα που είναι εκτός αποθέματος
Κάθε μέρα, ανακτά όλα τα προϊόντα που έχουν απόθεμα 0 και στέλνει μια σύνοψη μέσω email. Χρησιμοποιεί την ενέργεια «Λήψη δεδομένων προϊόντος» και το στοιχείο ενεργοποίησης «Προγραμματισμένη ώρα». Προβολή προτύπου
Αποστολή ειδοποίησης μέσω email όταν προστίθεται παραλλαγή με διπλότυπο κωδικό SKU
Όταν προστίθεται μια νέα παραλλαγή, ελέγχει αν άλλες παραλλαγές χρησιμοποιούν τον ίδιο κωδικό SKU. Εάν ναι, στέλνει ένα εσωτερικό email με συνδέσμους προς τα επηρεαζόμενα προϊόντα και τις παραλλαγές. Προβολή προτύπου
Παρακολούθηση παραλλαγών προϊόντων που είναι σε προσφορά με τη χρήση μετα-πεδίου προϊόντος
Ορίζει ένα μετα-πεδίο σε ένα προϊόν, εάν τουλάχιστον μία από τις παραλλαγές του είναι σε προσφορά. Αυτό μπορεί να είναι χρήσιμο για την παρακολούθηση των προϊόντων που βρίσκονται σε προσφορά τη δεδομένη στιγμή. Προβολή προτύπου