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