Λήψη δεδομένων σελίδας

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

Σημείωση

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

Διαμόρφωση

Πεδία

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

Πεδία που χρησιμοποιούνται στις ενέργειες λήψης δεδομένων.

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

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

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

published_status:published

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

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

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

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

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

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

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

Δεδομένα που επιστρέφονται

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

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

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

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

Σημείωση

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

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

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

Αναφορά API

Για περισσότερες πληροφορίες σχετικά με το API που χρησιμοποιείται σε αυτήν την ενέργεια, δείτε το ερώτημα σελίδων.