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

Αποστολή αιτήματος Admin API

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

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

Πεδία

Η ενέργεια «Αποστολή αιτήματος Admin API» περιέχει τα ακόλουθα πεδία.

Πεδία που χρησιμοποιούνται στην ενέργεια «Αποστολή αιτήματος Admin API».
ΠεδίοΠεριγραφή
ΜεταλλαγήΥποχρεωτικό. Η μεταλλαγή GraphQL Admin του Shopify που θέλετε να καλέσετε. Μια μεταλλαγή είναι ένα API που εκτελεί μια ενέργεια ή ενημερώνει δεδομένα.
Είσοδοι μεταλλαγήςΥποχρεωτικό. Τα δεδομένα (σε μορφή JSON) που πρέπει να στείλετε ως μέρος του αιτήματος μεταλλαγής σας. Κάθε μεταλλαγή απαιτεί ένα διαφορετικό σύνολο δεδομένων, το οποίο τεκμηριώνεται στον σύνδεσμο που παρέχεται για κάθε μεταλλαγή. Για να δημιουργήσετε το απαραίτητο JSON, μπορείτε να χρησιμοποιήσετε το Liquid ή μια ενέργεια «Εκτέλεση κώδικα».

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

Η ενέργεια «Αποστολή αιτήματος Admin API» μπορεί να χρησιμοποιηθεί σε οποιαδήποτε ροή εργασίας, με οποιοδήποτε στοιχείο ενεργοποίησης, εφόσον η ροή εργασίας παρέχει τα δεδομένα που είναι απαραίτητα για τη δημιουργία των εισόδων της μεταλλαγής.

Παραδείγματα

Παράδειγμα 1: Ενημέρωση του προτύπου που χρησιμοποιείται για ένα προϊόν

Σε αυτό το παράδειγμα, θα χρησιμοποιήσουμε την ενέργεια «Αποστολή αιτήματος Admin API» για να καλέσουμε τη μεταλλαγή productUpdate για να ενημερώσουμε το πρότυπο που χρησιμοποιείται για ένα προϊόν.

Το πεδίο id είναι υποχρεωτικό και πρέπει να είναι ένα έγκυρο GID προϊόντος. Εδώ, το ορίζουμε με τη μεταβλητή Liquid {{product.id}}. Αυτό προϋποθέτει ότι η ροή εργασίας σας έχει ένα στοιχείο ενεργοποίησης που παρέχει ένα αντικείμενο προϊόντος.

Το templateSuffix είναι το όνομα του προτύπου που θέλετε να εφαρμόσετε στο προϊόν. Για παράδειγμα, αν θέλετε να εφαρμόσετε το πρότυπο pre-order, θα ορίζατε το templateSuffix σε pre-order.

{
  "input": {
    "templateSuffix": "pre-order",
    "id": "{{product.id}}"
  }
}

Παράδειγμα 2: Ενημέρωση της κατάστασης φορολογικής απαλλαγής ενός πελάτη

Σε αυτό το παράδειγμα, θα χρησιμοποιήσουμε την ενέργεια «Αποστολή αιτήματος Admin API» για να καλέσουμε τη μεταλλαγή customerUpdate για να ενημερώσουμε την κατάσταση φορολογικής απαλλαγής ενός πελάτη.

Το πεδίο id είναι υποχρεωτικό και πρέπει να είναι ένα έγκυρο GID πελάτη. Εδώ, το ορίζουμε με τη μεταβλητή Liquid {{order.customer.id}}. Αυτό προϋποθέτει ότι η ροή εργασίας σας έχει ένα στοιχείο ενεργοποίησης που παρέχει ένα αντικείμενο παραγγελίας.

Το πεδίο taxExempt είναι μια τιμή boolean που υποδεικνύει αν ο πελάτης απαλλάσσεται από φόρους. Σε αυτό το παράδειγμα, το ορίζουμε σε true.

{
  "input": {
    "id": "{{order.customer.id}}",
    "taxExempt": true
  }
}

Παράδειγμα 3: Ενημέρωση των τοπικών ρυθμίσεων ενός πελάτη

Σε αυτό το παράδειγμα, θα χρησιμοποιήσουμε την ενέργεια «Αποστολή αιτήματος Admin API» για να καλέσουμε τη μεταλλαγή customerUpdate για να ενημερώσουμε τις τοπικές ρυθμίσεις ενός πελάτη.

Το πεδίο id είναι υποχρεωτικό και πρέπει να είναι ένα έγκυρο GID πελάτη. Εδώ, το ορίζουμε με τη μεταβλητή Liquid {{customer.id}}. Αυτό προϋποθέτει ότι η ροή εργασίας σας έχει ένα στοιχείο ενεργοποίησης που παρέχει ένα αντικείμενο πελάτη.

Το πεδίο locale είναι μια συμβολοσειρά που αντιπροσωπεύει τις τοπικές ρυθμίσεις του πελάτη. Σε αυτό το παράδειγμα, το ορίζουμε σε en.

{
  "input": {
    "id": "{{customer.id}}",
    "locale": "en"
  }
}

Συμβουλές για το Liquid

Το Flow υποστηρίζει ένα φίλτρο json του Liquid, το οποίο μπορεί να είναι χρήσιμο για τη δημιουργία της εισόδου. Όλα τα παρακάτω παραδείγματα χρησιμοποιούν τη μεταλλαγή customerUpdate και προϋποθέτουν ότι η ροή εργασίας σας έχει ένα στοιχείο ενεργοποίησης που παρέχει ένα αντικείμενο πελάτη.

Εργασία με συμβολοσειρές

Το παρακάτω παράδειγμα ενημερώνει τη σημείωση σε έναν πελάτη:

{% assign revisedNote = customer.note | append: " Hello from Flow!" %}

{
  "input": {
    "id": "{{ customer.id }}",
    "note": {{ revisedNote | json }},
  }
}

Το φίλτρο json κάνει escape τη συμβολοσειρά για να διασφαλίσει τη σωστή μορφή JSON. Αυτό έχει ως αποτέλεσμα το ακόλουθο JSON μετά την εκτέλεση της ροής εργασίας:

{
  "input": {
    "id": "gid://shopify/Customer/1234",
    "note": "Had a \"great experience\" with their latest order. Hello from Flow!",
  }
}

Εργασία με πίνακες

Παράδειγμα πίνακα

Το φίλτρο json μετατρέπει έναν πίνακα liquid σε έναν πίνακα JSON. Το παρακάτω παράδειγμα εξάγει έναν πίνακα JSON όταν του παρέχεται ένας πίνακας liquid:

{% assign tags = "tag1,tag2,tag3" | split: "," %}

{
  "input": {
    "id": "{{ customer.id }}",
    "tags": {{ tags | json }}
  }
}

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

{
  "input": {
    "id": "gid://shopify/Customer/1234",
    "tags": ["tag1","tag2","tag3"]
  }
}

Παράδειγμα βρόχου for

Το παρακάτω παράδειγμα χρησιμοποιεί έναν βρόχο για την εξαγωγή των στοιχείων ενός πίνακα, διαχωρισμένων με κόμματα:

{% assign tags = "tag1,tag2,tag3" | split: "," %}

{
  "input": {
    "id": "{{ customer.id }}",
    "tags": [
      {% for tag in tags %}
        "{{ tag }}"{% unless forloop.last %},{% endunless %}
      {% endfor %}
    ]
  }
}

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

{
  "input": {
    "id": "gid://shopify/Customer/1234",
    "tags": [
        "tag1",
        "tag2",
        "tag3"
    ]
  }
}

Παράδειγμα map

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

{
  "input": {
    "id": "{{ customer.id }}",
    "tags": {{ customer.addresses | map: "city" | json }}
  }
}

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

{
  "input": {
    "id": "gid://shopify/Customer/1234",
    "tags": ["Ottawa","Toronto"]
  }
}

Περιορισμοί

Η ενέργεια «Αποστολή αιτήματος Admin API» έχει τους ακόλουθους περιορισμούς:

  • Η ενέργεια θα εμφανίσει μια λίστα με μεταλλαγές και είσοδοι μεταλλαγών από την έκδοση του Admin API που χρησιμοποιείται από το Flow.
  • Όταν κυκλοφορούν νέες εκδόσεις API, αυτή η ενέργεια ενδέχεται να αποτύχει αν χρησιμοποιεί μια μεταλλαγή ή ένα πεδίο που έχει αλλάξει ή καταργηθεί.
  • Η ενέργεια δεν υποστηρίζει ερωτήματα GraphQL, μόνο μεταλλαγές.
  • Η ενέργεια δεν υποστηρίζει μεταλλαγές που έχουν καταργηθεί.
  • Η ενέργεια δεν υποστηρίζει ορισμένες μεταλλαγές που αφορούν συγκεκριμένες εφαρμογές, συμπεριλαμβανομένων ορισμένων μεταλλαγών συνδρομής, δραστηριότητας μάρκετινγκ και έκπτωσης.
  • Η ενέργεια δεν υποστηρίζει ασύγχρονες μεταλλαγές ή μεταλλαγές που επιστρέφουν έναν τύπο Job.
  • Η ενέργεια δεν υποστηρίζει μεταλλαγές που δεν υλοποιούν τη διεπαφή Node.

Πρότυπα

Προσθήκη δωρεάν κομματιού (με έκπτωση 100%) σε νέες παραγγελίες

Αυτό το πρότυπο προσθέτει ένα δωρεάν κομμάτι με έκπτωση σε νέες παραγγελίες, αν το κομμάτι είναι σε απόθεμα. Ελέγχει το απόθεμα, εφαρμόζει έκπτωση 100% και ενημερώνει την παραγγελία χωρίς να ειδοποιεί τον πελάτη. Αυτή η αυτοματοποίηση θα ήταν χρήσιμη για (1) την ενίσχυση της ικανοποίησης των πελατών, συμπεριλαμβάνοντας ένα δωρεάν κομμάτι-έκπληξη στην παραγγελία τους, (2) την προώθηση νέων ή λιγότερο γνωστών προϊόντων, προσθέτοντάς τα ως δωρεάν δείγματα σε παραγγελίες, ή (3) τον εξορθολογισμό των προωθητικών ενεργειών, αυτοματοποιώντας τη συμπερίληψη και την έκπτωση των δωρεάν κομματιών. Προβολή προτύπου

Ενεργοποίηση παραγγελιών για εταιρείες που δημιουργήθηκαν από αιτήματα λογαριασμού εταιρείας

Αντιστοιχίστε μια άδεια παραγγελίας όταν δημιουργείται μια εταιρεία από ένα αίτημα λογαριασμού εταιρείας. Προβολή προτύπου

Αλλαγή προτύπου προϊόντος όταν οι παραλλαγές είναι εκτός αποθέματος ή πάλι σε απόθεμα

Ενημερώστε ένα πρότυπο προϊόντος με βάση το απόθεμα για τις παραλλαγές του προϊόντος. Η ροή εργασίας σάς επιτρέπει να κάνετε εναλλαγή μεταξύ των προτύπων για προϊόντα σε απόθεμα (το προεπιλεγμένο πρότυπο του καταστήματος), εκτός αποθέματος και όταν μία ή περισσότερες παραλλαγές είναι εκτός αποθέματος. Προβολή προτύπου

Διεκπεραιώστε οποιαδήποτε ψηφιακά κομμάτια σε μια παραγγελία

Διεκπεραιώνει οποιαδήποτε κομμάτια για τα οποία δεν απαιτείται φυσική παράδοση, όπως ψηφιακά κομμάτια ή που αντιστοιχούν σε μια λίστα κωδικών SKU. Εκτελείται μία φορά για κάθε τοποθεσία διεκπεραίωσης (η «παραγγελία διεκπεραίωσης») για μια νέα παραγγελία. Προβολή προτύπου