Πρόσβαση σε λεπτομερή δεδομένα στον διαχειριστή Shopify με χρήση JSON

Το JSON, συντομογραφία του JavaScript Object Notation, είναι μια μορφή αποθήκευσης και μεταφοράς δεδομένων, που χρησιμοποιείται συχνά όταν αποστέλλονται δεδομένα από διακομιστές σε ιστοσελίδες. Στις περισσότερες σελίδες πόρων στον Διαχειριστή Shopify, όπως οι σελίδες Παραγγελίες, Προϊόντα ή Πελάτες, μπορείτε να έχετε πρόσβαση σε πιο λεπτομερή δεδομένα χρησιμοποιώντας JSON.

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

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

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

Επαναμορφοποίηση αρχείου JSON

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

Για να κάνετε τη μορφοποίηση JSON πιο ευανάγνωστη, εξετάστε οποιαδήποτε από τις παρακάτω επιλογές:

Εγκαταστήστε μια επέκταση προβολής JSON στο πρόγραμμα περιήγησής σας.
Χρησιμοποιήστε τη δυνατότητα pretty-print που διαθέτουν τα περισσότερα σύγχρονα προγράμματα περιήγησης ιστού από προεπιλογή:

Στιγμιότυπο οθόνης ενός αρχείου JSON προϊόντος με παράδειγμα πληροφοριών προϊόντος. Η ρύθμιση του πλαισίου ελέγχου «pretty-print» είναι ενεργή και επισημασμένη στην επάνω αριστερή γωνία της σελίδας.

Πρόσβαση σε αρχεία JSON στον διαχειριστή Shopify

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

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

Παράδειγμα: Πρόσβαση στο αρχείο JSON μιας παραγγελίας

Σε αυτό το παράδειγμα, θα αποκτήσετε πρόσβαση στο αρχείο JSON μιας παραγγελίας στον διαχειριστή Shopify.

Βήματα:

Από τον Διαχειριστή Shopify, μεταβείτε στις Παραγγελίες.
Κάντε κλικ σε οποιαδήποτε παραγγελία στη λίστα Παραγγελίες.
Στη γραμμή διευθύνσεων του προγράμματος περιήγησης, προσθέστε το .json στο τέλος της διεύθυνσης URL. Θα είναι παρόμοιο με αυτό το παράδειγμα:

https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json

Πατήστε Enter για να φορτώσετε ξανά τη σελίδα σε μορφοποίηση JSON.
Προαιρετικά: Αν δεν έχετε εγκατεστημένη μια επέκταση προβολής JSON στο πρόγραμμα περιήγησής σας, ενεργοποιήστε τη ρύθμιση Pretty-print στο πρόγραμμα περιήγησής σας για να κάνετε το αρχείο JSON πιο φιλικό προς τον χρήστη. Μάθετε περισσότερα σχετικά με την επαναμορφοποίηση ενός αρχείου JSON.

Θα παρατηρήσετε ότι εμφανίζονται πολλές αναμενόμενες πληροφορίες σχετικά με την παραγγελία, όπως το "currency" και τα "line_items" που σχετίζονται με την παραγγελία, αλλά περιλαμβάνονται επίσης και πολλές άλλες λεπτομερείς πληροφορίες, όπως τα "client_details" από την περίοδο σύνδεσης του προγράμματος περιήγησης του πελάτη όταν υπέβαλε την παραγγελία. Αυτό το είδος πληροφοριών είναι χρήσιμο για τη συνολική παρακολούθηση της περιόδου σύνδεσης και τα στοιχεία ανάλυσης της πλατφόρμας μάρκετινγκ, αλλά δεν είναι απαραίτητο για την επεξεργασία και τη διεκπεραίωση της παραγγελίας.

Εμφάνιση συγκεκριμένων πεδίων σε ένα αρχείο JSON

Μπορείτε να εξαναγκάσετε τα αρχεία JSON να εμφανίζουν μόνο συγκεκριμένα πεδία, γεγονός που μπορεί να διευκολύνει την ερμηνεία των πληροφοριών όταν γνωρίζετε τις συγκεκριμένες ιδιότητες που θέλετε να συμπεριλάβετε. Στο τέλος οποιασδήποτε διεύθυνσης URL αρχείου JSON στη γραμμή διευθύνσεων του προγράμματος περιήγησης, προσθέστε ?fields= και, στη συνέχεια, συμπεριλάβετε τα ονόματα των ιδιοτήτων που θέλετε να εμφανίζονται, με οποιαδήποτε σειρά, χωρισμένα με κόμμα.

Για παράδειγμα, για να εμφανίσετε το αναγνωριστικό μιας παραγγελίας, τις πληροφορίες πελάτη, τη συνολική τιμή και τις ετικέτες, προσθέστε ?fields=id,customer,total_price,tags στο τέλος της διεύθυνσης URL του αρχείου JSON, όπως στο παρακάτω παράδειγμα:

https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json?fields=id,customer,total_price,tags

Χρήση άλλων πόρων JSON

Μπορείτε να χρησιμοποιήσετε τους παρακάτω πόρους JSON για να εμφανίσετε συγκεκριμένες πληροφορίες στον διαχειριστή Shopify:

Πλήθος προϊόντων: Προσθέστε το /count.json στο τέλος της διεύθυνσης URL της λίστας Προϊόντων για να εμφανιστεί ο συνολικός αριθμός προϊόντων. Η πλήρης διεύθυνση URL θα πρέπει να είναι:

https://admin.shopify.com/store/{example-shop-name}/products/count.json

Συναλλαγές: Προσθέστε το /transactions.json στο τέλος της διεύθυνσης URL μιας σελίδας παραγγελίας για να εμφανίσετε μόνο τις πληροφορίες συναλλαγών της παραγγελίας. Μάθετε περισσότερα για τον πόρο Συναλλαγές.
Διεκπεραιώσεις: Προσθέστε το /fulfillments.json στο τέλος της διεύθυνσης URL μιας σελίδας παραγγελίας για να εμφανίσετε μόνο τις πληροφορίες διεκπεραίωσης της παραγγελίας. Μάθετε περισσότερα για τον πόρο Διεκπεραίωση.
Εγκαταλελειμμένες ολοκληρώσεις αγοράς: Προσθέστε το .json στο τέλος μιας διεύθυνσης URL εγκαταλελειμμένης ολοκλήρωσης αγοράς για να εμφανίσετε λεπτομερείς πληροφορίες σχετικά με την εγκαταλελειμμένη ολοκλήρωση αγοράς. Μάθετε περισσότερα για τον πόρο Εγκαταλελειμμένη ολοκλήρωση αγοράς.

Κοινές ιδιότητες JSON για την αντιμετώπιση προβλημάτων

Ο παρακάτω πίνακας παραθέτει ιδιότητες JSON στις οποίες μπορεί να θέλετε να ανατρέξετε για βοήθεια στην αντιμετώπιση προβλημάτων με διαφορετικούς τύπους πόρων. Για παράδειγμα, αν θέλετε να επιβεβαιώσετε πότε δημοσιεύτηκε ένα συγκεκριμένο προϊόν, τότε μπορείτε να ελέγξετε το αρχείο JSON του προϊόντος για την ιδιότητα published_at, η οποία εμφανίζει την ημερομηνία και την ώρα σε μορφή ISO 8601.

Αυτός ο πίνακας δεν περιλαμβάνει κάθε πιθανό πόρο ή ιδιότητα JSON που είναι αποθηκευμένη στον Διαχειριστή Shopify, επομένως ανατρέξτε στην Τεκμηρίωση για προγραμματιστές του Shopify για ορισμούς οποιουδήποτε πόρου ή ιδιότητας που δεν περιλαμβάνεται εδώ.

Παραθέτει ορισμένα παραδείγματα πόρων διαχειριστή και κοινές ιδιότητες που σχετίζονται με αυτούς, συμπεριλαμβανομένων ορισμών για το πώς θα μπορούσαν να χρησιμοποιηθούν κατά την αντιμετώπιση προβλημάτων.
Πόρος	Ιδιότητα JSON	Ορισμός
Προϊόν	`"product": { "created_at"`	Η ημερομηνία και η ώρα που δημιουργήθηκε αρχικά το προϊόν.
	`"product": { "published_at"`	Η ημερομηνία και η ώρα που η κατάσταση του προϊόντος ορίστηκε σε Ενεργό.
	`"product": { "updated_at"`	Η πιο πρόσφατη ημερομηνία και ώρα ενημέρωσης του προϊόντος. Αυτό μπορεί να περιλαμβάνει αλλαγές στην περιγραφή του προϊόντος, τον τίτλο ή τις πληροφορίες SEO, καθώς και αυτόματες ενημερώσεις, όπως αλλαγές στο απόθεμα όταν αγοράζεται ένα προϊόν.
Παραλλαγή	`"product": { "variants": [ { "created_at"`	Η ημερομηνία και η ώρα αρχικής δημιουργίας της παραλλαγής. Μπορεί να διαφέρει από την ημερομηνία και την ώρα δημιουργίας του συνολικού προϊόντος.
	`"product": { "variants": [ { "updated_at"`	Η πιο πρόσφατη ημερομηνία και ώρα ενημέρωσης της παραλλαγής. Μπορεί να διαφέρει από την ημερομηνία και την ώρα της τελευταίας ενημέρωσης του συνολικού προϊόντος.
	`"product": { "variants": [ { "inventory_quantity"`	Η τρέχουσα τιμή της βάσης δεδομένων και αυτό που είναι διαθέσιμο στους πελάτες για αγορά. Μπορεί να είναι αρνητική τιμή εάν δεν παρακολουθείται το απόθεμα της παραλλαγής ή εάν έχει οριστεί για ακάλυπτες πωλήσεις.
	`"product": { "variants": [ { "old_inventory_quantity"`	Η τιμή της βάσης δεδομένων πριν από την τελευταία ημερομηνία `updated_at` της παραλλαγής.
Παραγγελία	`"order": { "line_items": [ { "requires_shipping"`	Εμφανίζεται ως `true` ή `false`. Υποδεικνύει τις ρυθμίσεις αποστολής του προϊόντος ή της παραλλαγής κατά τη στιγμή της υποβολής της παραγγελίας.
	`"order": { "line_items": [ { "taxable"`	Εμφανίζεται ως `true` ή `false`. Υποδεικνύει τον τρόπο με τον οποίο το προϊόν ή η παραλλαγή είχε ρυθμιστεί για τη χρέωση φόρων κατά τη στιγμή της υποβολής της παραγγελίας.
	`"order": { "line_items": [ { "variant_inventory_management"`	Εμφανίζεται ως `shopify`, `amazon_marketplace_web`, `null` ή ως τιμή τρίτου, ανάλογα με την υπηρεσία διεκπεραίωσης παραγγελιών που έχει οριστεί για την παρακολούθηση του αποθέματος του προϊόντος. Η τιμή `null` σημαίνει ότι το προϊόν δεν παρακολουθούνταν κατά τη στιγμή της παραγγελίας.
	`"order": { "line_items": [ { "fulfillable_quantity"`	Εμφανίζει πόσο απόθεμα εξακολουθεί να είναι δεσμευμένο από το σύστημα για την ολοκλήρωση της παραγγελίας. Δεν ισούται με το τρέχον απόθεμα της παραλλαγής.
	`"order": { "line_items": [ { "quantity"`	Αριθμός προϊόντων ή παραλλαγών που αγοράστηκαν.
	`"order": { "line_items": [ { "tax_lines"`	Στις Ηνωμένες Πολιτείες, εμφανίζει τιμές πολιτείας, κομητείας και δήμου. Εάν δεν εμφανίζονται γραμμές φόρου, αλλά χρεώθηκε φόρος στην παραγγελία, αυτό σημαίνει ότι ο φόρος χρεώθηκε στο κόστος αποστολής.
Πελάτης	`"customer": { "created_at"`	Η ημερομηνία και η ώρα που δημιουργήθηκε αρχικά ο πελάτης.
Πελάτης	`"customer": { "updated_at"`	Η πιο πρόσφατη ημερομηνία και ώρα ενημέρωσης του προφίλ πελάτη.

Μετα-πεδία σε JSON

Τα μετα-πεδία είναι ένας ευέλικτος τρόπος για την επισύναψη πρόσθετων προσαρμοσμένων πληροφοριών σε έναν πόρο του Shopify, όπως προϊόντα ή συλλογές. Ορισμένα παραδείγματα δεδομένων που αποθηκεύονται με τη χρήση μετα-πεδίων περιλαμβάνουν προδιαγραφές προϊόντων, πίνακες μεγεθών, έγγραφα με δυνατότητα λήψης, ημερομηνίες κυκλοφορίας, εικόνες ή αριθμούς εξαρτημάτων. Μάθετε περισσότερα σχετικά με τη χρήση μετα-πεδίων.

Μπορείτε να προσθέσετε το /metafields.json στο τέλος του URL μιας σελίδας υποστηριζόμενου πόρου για να εμφανίσετε τα μετα-πεδία που σχετίζονται με τον συγκεκριμένο πόρο. Ανατρέξτε στον παρακάτω πίνακα για ορισμένα παραδείγματα πόρων και μορφών URL που μπορείτε να χρησιμοποιήσετε για την εμφάνιση πληροφοριών μετα-πεδίων με χρήση JSON.

Λίστα με ορισμένα παραδείγματα πόρων διαχειριστή μαζί με ένα παράδειγμα URL αρχείου μετα-πεδίων JSON.
Παράδειγμα τύπου πόρου	Παράδειγμα URL
Έξυπνη συλλογή	`https://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json`
Πελάτης	`https://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json`
Παραγγελία	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json`
Σελίδα	`https://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json`
Προϊόν	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/metafields.json`
Παραλλαγή	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/variants/{variant-id}/metafields.json`
Εικόνα προϊόντος	`https://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image` Σημείωση: Τα μετα-πεδία εικόνας προϊόντος μπορούν να προστεθούν μόνο μέσω του API. Αντικαταστήστε το `{id}` και άλλα σύμβολα υποκατάστασης στη διεύθυνση URL με τις πραγματικές τιμές από τα ερωτήματά σας στο API.
Κατάστημα	`https://admin.shopify.com/store/{your-store-name}/metafields.json`

Για μια πλήρη λίστα πόρων που μπορούν να έχουν μετα-πεδία και τους συγκεκριμένους τύπους ιδιοτήτων που αποθηκεύονται για κάθε τύπο πόρου, ανατρέξτε στον πόρο JSON Μετα-πεδίο στην Τεκμηρίωση για προγραμματιστές του Shopify.

Συμβάντα σε JSON

Τα συμβάντα δημιουργούνται από ορισμένους πόρους του Shopify όταν ολοκληρώνονται συγκεκριμένες ενέργειες, όπως η δημιουργία μιας ανάρτησης ιστολογίου, η διεκπεραίωση μιας παραγγελίας ή η προσθήκη ενός προϊόντος.

Μπορείτε να προσθέσετε το /events.json στο τέλος του URL μιας σελίδας υποστηριζόμενου πόρου για να εμφανίσετε τα συμβάντα που σχετίζονται με τον συγκεκριμένο πόρο. Ανατρέξτε στον παρακάτω πίνακα για ορισμένα παραδείγματα πόρων και μορφών URL που μπορείτε να χρησιμοποιήσετε για την εμφάνιση πληροφοριών συμβάντων με χρήση JSON.

Λίστα με ορισμένα παραδείγματα πόρων διαχειριστή μαζί με ένα παράδειγμα URL αρχείου συμβάντων JSON.
Παράδειγμα τύπου πόρου	Παράδειγμα URL
Παραγγελία	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json` Αυτό το αρχείο παραθέτει τον `author` των συμβάντων, ενημερώνοντάς σας για το ποιοι χρήστες ολοκλήρωσαν συγκεκριμένες ενέργειες, όπως το ποιος ή τι δημοσίευσε ένα προϊόν.
Προϊόν	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json` Αυτό το αρχείο παραθέτει τον `author` των συμβάντων, ενημερώνοντάς σας για το ποιοι χρήστες ολοκλήρωσαν συγκεκριμένες ενέργειες, όπως το ποιος ή τι σήμανε μια πληρωμή ως εξοφλημένη.
Κατάστημα	`https://admin.shopify.com/store/{your-store-name}/events.json?limit=250` Αυτή η μορφή URL εμφανίζει τα 250 πιο πρόσφατα συμβάντα που πραγματοποιήθηκαν στο κατάστημά σας. Τα συμβάντα μπορεί να περιλαμβάνουν, μεταξύ άλλων, τη δημιουργία ή την ενημέρωση προϊόντων, τη διαγραφή σελίδων και την ενημέρωση παραλλαγών.

Για μια πλήρη λίστα πόρων που μπορούν να δημιουργήσουν συμβάντα, και τα συγκεκριμένα συμβάντα που δημιουργούνται για κάθε τύπο πόρου, ανατρέξτε στον πόρο JSON Συμβάν στην Τεκμηρίωση για προγραμματιστές του Shopify.