Βοήθεια
Σύνδεση

Λήψη δεδομένων δωροκάρτας

Σε ροές εργασίας που απαιτούν δεδομένα δωροκάρτας, μπορείτε να χρησιμοποιήσετε την ενέργεια Λήψη δεδομένων δωροκάρτας για να ανακτήσετε πληροφορίες δωροκάρτας από το κατάστημά σας.

Είναι σημαντικό ότι το κατάστημά σας διαθέτει τόσο προϊόντα δωροκάρτας, τα οποία χρησιμοποιούνται για τη δημιουργία δωροκαρτών, όσο και τις ίδιες τις δωροκάρτες, οι οποίες είναι οι πραγματικές δωροκάρτες που μπορούν να χρησιμοποιήσουν οι πελάτες για να κάνουν αγορές. Η ενέργεια Λήψη δεδομένων δωροκάρτας ανακτά πληροφορίες σχετικά με τις ίδιες τις δωροκάρτες. Για να λάβετε πληροφορίες σχετικά με τα προϊόντα δωροκάρτας, χρησιμοποιήστε τις ενέργειες Λήψη δεδομένων προϊόντος ή Λήψη δεδομένων παραλλαγής προϊόντος.

Σε αυτήν τη σελίδα

Διαμόρφωση

Πεδία

Η ενέργεια Λήψη δεδομένων δωροκάρτας περιέχει τα παρακάτω πεδία, τα οποία χρησιμοποιούνται για τη δημιουργία του ερωτήματος:

Πεδία που χρησιμοποιούνται στις ενέργειες Λήψης δεδομένων.
ΠεδίοΠεριγραφή
Ταξινόμηση δεδομένων κατάΥποχρεωτικό. Οι παράμετροι βάσει των οποίων ταξινομούνται τα δεδομένα που επιστρέφονται από το ερώτημα αναζήτησης.
Μέγιστος αριθμός αποτελεσμάτωνΥποχρεωτικό. Ο μέγιστος αριθμός αποτελεσμάτων που μπορούν να επιστραφούν από το ερώτημα αναζήτησης που επιλέγετε. Μπορείτε να επιστρέψετε έως 100 κάθε φορά.
ΕρώτημαΥποχρεωτικό. Επιλέξτε από κοινά ερωτήματα ή επιλέξτε Για προχωρημένους για να δημιουργήσετε το δικό σας.

Συμβολοσειρά ερωτήματος

Αυτό είναι ένα παράδειγμα ερωτήματος για τη λήψη δωροκαρτών που ενημερώθηκαν την τελευταία ημέρα:

created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Η μεταβλητή created_at είναι ένα φίλτρο που διατίθεται στο ερώτημα δωροκαρτών και μπορεί να χρησιμοποιηθεί πολλές φορές ή να συνδυαστεί με άλλες μεταβλητές. Η μεταβλητή Liquid scheduledAt είναι διαθέσιμη σε ροές εργασίας που χρησιμοποίησαν το στοιχείο ενεργοποίησης «Προγραμματισμένη ώρα». Η ετικέτα Liquid date_minus είναι μια ειδική ετικέτα του Flow που σας επιτρέπει να αφαιρείτε χρόνο από μια ημερομηνία.

Κατά την υποβολή ερωτημάτων για δεδομένα, είναι χρήσιμο να γνωρίζετε τα εξής:

  • Λίστα με τα διαθέσιμα φίλτρα δωροκάρτας

  • Τα ερωτήματα πρέπει να ακολουθούν μια συγκεκριμένη σύνταξη

  • Οι τιμές των πεδίων ερωτημάτων δεν τεκμηριώνονται πάντα. Σε ορισμένες περιπτώσεις, μπορείτε να βρείτε τις τιμές ανατρέχοντας στα έγγραφα του API. Εναλλακτικά, μπορείτε συχνά να βρείτε τις τιμές των πεδίων στα URL του πίνακα διαχειριστή όταν εφαρμόζετε φίλτρα. Για παράδειγμα, για να βρείτε ορισμένες τιμές ερωτήματος Παραγγελίας, φιλτράρετε τη σελίδα «Παραγγελίες» στον πίνακα διαχειριστή και, στη συνέχεια, ελέγξτε το URL.

  • Μπορείτε να εκτελέσετε ή να δοκιμάσετε ένα ερώτημα στο κατάστημά σας χρησιμοποιώντας την εφαρμογή Shopify GraphiQL.

  • Προσέξτε τι συμβαίνει αν το ερώτημά σας αποτύχει. Συχνά, το API θα επιστρέψει όλα τα αποτελέσματα (αντί για κανένα).

Επιστρεφόμενα δεδομένα

Όλες οι ενέργειες Λήψη δεδομένων επιστρέφουν μια λίστα από 0 έως 100 πόρους. Ανάλογα με την περίπτωση χρήσης σας, μπορεί να θέλετε να χρησιμοποιήσετε αυτά τα δεδομένα με διάφορους τρόπους:

  • Αν χρειάζεται να διαχειριστείτε κάθε στοιχείο της λίστας ξεχωριστά, όπως για να προσθέσετε μια ετικέτα σε καθένα, τότε μπορείτε να χρησιμοποιήσετε την ενέργεια Για κάθε.
  • Αν χρειάζεται να συγκεντρώσετε δεδομένα, όπως να μετρήσετε πόσα αποτελέσματα επιστράφηκαν, τότε μπορείτε να χρησιμοποιήσετε τις ενέργειες Καταμέτρηση ή Άθροισμα.
  • Αν χρειάζεται να εξάγετε τη λίστα, όπως για να στείλετε ένα email με όλα τα στοιχεία, τότε μπορείτε να χρησιμοποιήσετε τα επιστρεφόμενα δεδομένα απευθείας σε επόμενες ενέργειες.

Για να αποκτήσετε πρόσβαση στα επιστρεφόμενα δεδομένα σε βήματα που ακολουθούν αυτήν την ενέργεια, χρησιμοποιήστε τη μεταβλητή με το όνομα Λήψη δεδομένων δωροκάρτας, η οποία είναι μια λίστα με δωροκάρτες. Μπορείτε να χρησιμοποιήσετε αυτήν τη μεταβλητή τόσο σε συνθήκες όσο και σε ενέργειες. Για παράδειγμα, μπορείτε να στείλετε τη λίστα με τις δωροκάρτες σε μια ενέργεια Αποστολή εσωτερικού email ως εξής:

{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.name }}
{% endfor %}

Στοιχεία ενεργοποίησης

Μπορείτε να χρησιμοποιήσετε αυτήν την ενέργεια σε οποιαδήποτε ροή εργασίας, συμπεριλαμβανομένου του στοιχείου ενεργοποίησης Προγραμματισμένη ώρα. Σε μια ροή εργασίας που χρησιμοποιεί το στοιχείο ενεργοποίησης Προγραμματισμένη ώρα, η ροή εργασίας ξεκινά σε μια ώρα που έχετε καθορίσει, και όχι ως αποτέλεσμα ενός συμβάντος. Επειδή δεν υπάρχει κάποιο συγκεκριμένο συμβάν στο κατάστημά σας ή από μια εφαρμογή που ξεκινά τη ροή εργασίας, δεν συμπεριλαμβάνονται αυτόματα δεδομένα.

Λεπτομέρειες API