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

Λήψη δεδομένων προσπάθειας χρέωσης συνδρομής

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

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

Διαμόρφωση

Πεδία

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

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

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

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

created_at:>'{{ createdAt | date_minus: "3 day" }}'

Η μεταβλητή created_at είναι ένα φίλτρο διαθέσιμο στο ερώτημα προσπάθειας χρέωσης συνδρομής και μπορεί να χρησιμοποιηθεί για την επιλογή συγκεκριμένου μηνύματος σφάλματος για τις προσπάθειες χρέωσης συνδρομής.

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

  • Λίστα διαθέσιμων φίλτρων προσπάθειας χρέωσης συνδρομής
  • Τα ερωτήματα πρέπει να ακολουθούν μια συγκεκριμένη σύνταξη
  • Οι τιμές των πεδίων ερωτήματος δεν είναι πάντα τεκμηριωμένες. Σε ορισμένες περιπτώσεις, μπορείτε να βρείτε τις τιμές ανατρέχοντας στα έγγραφα του API. Εναλλακτικά, μπορείτε συχνά να βρείτε τις τιμές των πεδίων στα URL στον πίνακα διαχειριστή όταν εφαρμόζετε φίλτρα. Για παράδειγμα, για να βρείτε ορισμένες τιμές ερωτήματος παραγγελίας, φιλτράρετε τη σελίδα «Παραγγελίες» στον πίνακα διαχειριστή και, στη συνέχεια, ελέγξτε το URL.
  • Μπορείτε να εκτελέσετε ή να δοκιμάσετε ένα ερώτημα στο κατάστημά σας χρησιμοποιώντας την εφαρμογή Shopify GraphiQL.
  • Να είστε προσεκτικοί σχετικά με το τι συμβαίνει εάν το ερώτημά σας αποτύχει. Συχνά το API θα επιστρέψει όλα τα αποτελέσματα (αντί για κανένα).

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

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

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

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

{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
  {{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}

Παράδειγμα

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

Αναφορά API