Λήψη δεδομένων άρθρου

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

Σημείωση

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

Διαμόρφωση

Πεδία

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

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

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

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

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

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

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

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

• Λίστα διαθέσιμων φίλτρων άρθρων

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

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

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

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

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

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

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

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

{% for single_article in GetArticleData %}
    * {{ single_article.title }}
    {% endfor %}

Σημείωση

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

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

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

Αναφορά API

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