Shopify Flow και GraphQL Admin API

Το Flow χρησιμοποιεί το Shopify GraphQL Admin API για τη δημιουργία αυτοματοποιήσεων και ενσωματώσεων που επεκτείνουν και βελτιώνουν τον Διαχειριστή Shopify. Το Flow χρησιμοποιεί την έκδοση 2026-01 του API για να αξιολογεί συνθήκες και μεταβλητές σε ροές εργασίας, καθώς και για να εκτελεί ενέργειες στο κατάστημά σας Shopify. Επειδή το Flow αποκτά πρόσβαση στα δεδομένα του καταστήματος καλώντας το API, έχετε πρόσβαση σε σχεδόν όλα τα πεδία που είναι διαθέσιμα στο API μέσω του Flow.

Επειδή το Shopify κυκλοφορεί νέες εκδόσεις API κάθε 3 μήνες, ορισμένες ροές εργασίας μπορεί να χρειαστεί να ενημερωθούν όταν τα πεδία αλλάζουν ή καταργούνται.

Χρήση του GraphQL Admin API σε ροές εργασίας

Οι περισσότερες ενέργειες στο Flow χρησιμοποιούν το GraphQL Admin API για να κάνουν αλλαγές στο κατάστημά σας Shopify. Για παράδειγμα, η ενέργεια Προσθήκη ετικετών παραγγελίας χρησιμοποιεί τη μεταλλαγή tagsAdd. Η ενέργεια Αποστολή αιτήματος Admin API μπορεί να χρησιμοποιήσει τις περισσότερες μεταλλαγές, συμπεριλαμβανομένων εκείνων που δεν είναι ακόμη διαθέσιμες ως ενέργειες στο Flow.

Καθώς δημιουργείτε ροές εργασίας, θα συναντάτε συχνά ονόματα πεδίων και περιγραφές που βασίζονται στη σύνταξη του GraphQL Admin API. Για παράδειγμα, για να προσδιορίσετε τη συνολική πωλήσιμη ποσότητα μιας παραλλαγής σε μια ροή εργασίας, θα χρησιμοποιούσατε τη μεταβλητή variants_item.inventoryQuantity. Επίσης, για να προσδιορίσετε την τοποθεσία από την οποία ένας πελάτης έκανε εγγραφή στο ενημερωτικό δελτίο σας μέσω email, θα χρησιμοποιούσατε τη μεταβλητή emailSubscriptionMethod.

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

Δεδομένα καταστήματος και GraphQL Admin API

Οι ροές εργασίας χρησιμοποιούν δεδομένα από το κατάστημά σας σε συνθήκες και ενέργειες. Το Flow αποκτά πρόσβαση στα δεδομένα του καταστήματος χρησιμοποιώντας το GraphQL Admin API, πράγμα που σημαίνει ότι έχετε πρόσβαση σε σχεδόν όλα τα πεδία του API. Αν μια ενέργεια δεν διαθέτει τα απαραίτητα δεδομένα που παρέχονται από το στοιχείο ενεργοποίησης ή μια ενέργεια Λήψη δεδομένων, τότε η ροή εργασίας δεν εκτελείται και εμφανίζεται ένα μήνυμα σφάλματος.

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

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

Ορίσματα πεδίου και το GraphQL Admin API

Ορισμένα πεδία του GraphQL Admin API απαιτούν ορίσματα, δηλαδή πρόσθετες παραμέτρους που περιορίζουν τα δεδομένα που επιστρέφονται. Για παράδειγμα, το πεδίο product.inCollection χρειάζεται ένα όρισμα id συλλογής για να γνωρίζει ποια συλλογή πρέπει να ελέγξει. Χωρίς αυτό, το πεδίο δεν μπορεί να επιστρέψει αποτέλεσμα.

Στο Flow, μπορείτε να δημιουργήσετε μεταβλητές από αυτά τα πεδία παρέχοντας την απαιτούμενη τιμή του ορίσματος, η οποία μπορεί στη συνέχεια να χρησιμοποιηθεί στη ροή εργασίας. Μπορείτε, επίσης, να εκχωρήσετε ένα προσαρμοσμένο όνομα στη μεταβλητή, ώστε να είναι πιο εύκολη η αναφορά της στα επόμενα βήματα, για παράδειγμα, ονομάζοντας το product.inCollection(id: "gid://shopify/Collection/123456") ως product.inSummerBestsellers.

Μάθετε περισσότερα σχετικά με τη δημιουργία μεταβλητών από πεδία με ορίσματα.

Η δημιουργία μεταβλητών από μετα-πεδία απαιτεί πρόσθετες πληροφορίες στο Flow, επειδή ορίζετε εσείς τον χώρο ονομάτων και το κλειδί κάθε μετα-πεδίου, επομένως τα ορίσματα είναι πάντα μοναδικά για το κατάστημά σας. Μάθετε περισσότερα για τα μετα-πεδία στο Flow.

Εκδόσεις API

Το Shopify κυκλοφορεί νέες εκδόσεις API κάθε 3 μήνες και το Flow υιοθετεί τις νέες εκδόσεις το συντομότερο δυνατό, αλλά ενδέχεται να μην είναι ενημερωμένο με την πιο πρόσφατη έκδοση. Όταν είναι δυνατό, οι αλλαγές μεταξύ των εκδόσεων επιλύονται αυτόματα, αλλά ορισμένες αλλαγές μπορεί να μην είναι απλές, συμπεριλαμβανομένων οποιωνδήποτε από τις ακόλουθες περιπτώσεις:

• Όταν καταργούνται πεδία χωρίς να παρέχεται αντικατάστασή τους, γεγονός που μπορεί να επηρεάσει τον τρόπο αξιολόγησης των συνθηκών ή του Liquid.
• Όταν τα πεδία γίνονται nullable, γεγονός που μπορεί να επηρεάσει την αξιολόγηση των συνθηκών ή του Liquid.
• Όταν αλλάζουν οι τιμές enum ή προστίθενται νέοι τύποι union ή interface, γεγονός που μπορεί να επηρεάσει το Liquid ή τον κώδικα.
• Όταν αλλάζουν τα ορίσματα μεταλλαγής, γεγονός που μπορεί να επηρεάσει τη διαμόρφωση των ενεργειών «Αποστολή αιτήματος Admin API».

Ορισμένες ροές εργασίας μπορεί να χρειάζονται μη αυτόματη ενημέρωση. Σε αυτές τις περιπτώσεις, οι ροές εργασίας ενδέχεται να εμφανίζουν ένα σφάλμα Απαιτείται ενημέρωση ή Μη υποστηριζόμενο API και να σας καθοδηγούν στη σχετική τεκμηρίωση API για να κάνετε τις απαραίτητες αλλαγές στο πρόγραμμα επεξεργασίας ροής εργασίας. Όταν αυτές οι ενημερώσεις ολοκληρωθούν και αποθηκευτούν, η ροή εργασίας ενημερώνεται αυτόματα ώστε να χρησιμοποιεί την πιο πρόσφατη έκδοση API που είναι διαθέσιμη στο Flow.

Μπορείτε να επιλέξετε να αγνοήσετε προσωρινά τα ζητήματα για να κάνετε επείγουσες αλλαγές σε μια ροή εργασίας με σφάλματα συμβατότητας έκδοσης API. Αν αυτά τα ζητήματα δεν αντιμετωπιστούν, τότε η ροή εργασίας ενδέχεται να σταματήσει να εκτελείται ή να προκαλέσει σφάλματα όταν η παλαιότερη έκδοση API δεν υποστηρίζεται πλέον από το Shopify.