Συνιστώμενη ροή εργασίας

Χρησιμοποιήστε αυτή τη ροή εργασίας πριν τη δημιουργία, επεξεργασία ή δημοσίευση προσφορών.

Ο στόχος είναι να αποφευχθούν διπλότυπες προσφορές, μη έγκυρα payloads, ελλιπείς μεταφράσεις και μη ασφαλής δημοσίευση.

Τυπική ροή εργασίας καταλόγου

1. Αναγνώριση πιστοποιημένης εταιρείας
   Καλέστε whoami για να επιβεβαιώσετε την εταιρεία και τα διαθέσιμα scopes.

2. Ανάγνωση οδηγιών καταλόγου
   Καλέστε catalog-readme πριν μεταβάλετε δεδομένα καταλόγου.

3. Έλεγχος υποστηριζόμενων γλωσσών
   Καλέστε get-supported-languages πριν τη δημιουργία μεταφράσεων.

4. Αναζήτηση πριν τη δημιουργία
   Καλέστε list-offerings χρησιμοποιώντας οποιοδήποτε διαθέσιμο τίτλο, SKU, brand, URL ή αναγνωριστικό.

5. Δημιουργία ή επιλογή προσφοράς
   Δημιουργήστε νέο πρόχειρο μόνο όταν καμία υπάρχουσα προσφορά δεν αποτελεί καλή αντιστοιχία.

6. Εγγραφή βασικών πεδίων
   Χρησιμοποιήστε new-offering για αρχική δημιουργία ή update-offering-core για scalar πεδία κύριας γλώσσας.

7. Εγγραφή μεταφράσεων προσφοράς
   Χρησιμοποιήστε upsert-offering-translations για υποστηριζόμενες μη κύριες γλώσσες.

8. Εγγραφή βάσεων χαρακτηριστικών
   Χρησιμοποιήστε upsert-offering-attributes για πραγματικά χαρακτηριστικά σύγκρισης αγοραστών.

9. Εγγραφή μεταφράσεων χαρακτηριστικών
   Χρησιμοποιήστε upsert-offering-attribute-translations για κάθε χαρακτηριστικό που χρειάζεται μεταφρασμένες ετικέτες, περιγραφές ή ετικέτες τιμών.

10. Έλεγχος ετοιμότητας δημοσίευσης
    Πάντα καλέστε check-offering-publish-readiness πριν τη δημοσίευση.

11. Δημοσίευση μόνο εάν είναι έτοιμο
    Καλέστε publish-offering μόνο όταν η ετοιμότητα επιστρέψει publishable: true.

12. Διόρθωση και επανάληψη εάν χρειαστεί
    Εάν η ετοιμότητα επιστρέψει σφάλματα, διορθώστε το πρόχειρο και ελέγξτε ξανά την ετοιμότητα.

Ροή εργασίας δημιουργίας προσφοράς

whoami
catalog-readme
get-supported-languages
list-offerings
new-offering
upsert-offering-translations
upsert-offering-attributes
upsert-offering-attribute-translations
check-offering-publish-readiness
publish-offering

Καλέστε publish-offering μόνο όταν ζητήθηκε δημοσίευση και η ετοιμότητα πέρασε.

Ροή εργασίας αναθεώρησης προσφοράς

whoami
catalog-readme
list-offerings or get-offering
update-offering-core
upsert-offering-translations
upsert-offering-attributes
upsert-offering-attribute-translations
check-offering-publish-readiness
publish-offering

Όταν πολλές προσφορές μπορεί να αντιστοιχούν στο αίτημα, μην μεταβάλετε τίποτα. Ζητήστε από τον χρήστη να επιλέξει τη σωστή προσφορά.

Κανόνες μεταφράσεων

• Μην συμπεριλαμβάνετε την κύρια γλώσσα της προσφοράς στα payloads μεταφράσεων.
• Χρησιμοποιείτε μόνο υποστηριζόμενους κωδικούς γλωσσών.
• Οι μεταφράσεις προσφορών είναι προσθετικές: οι γλώσσες που περιλαμβάνονται σε μια κλήση αντικαθίστανται, και οι γλώσσες που δεν περιλαμβάνονται διατηρούνται.
• Πριν τη δημοσίευση, πρέπει να υπάρχουν όλες οι υποστηριζόμενες μη κύριες γλώσσες.

Κανόνες χαρακτηριστικών

• Το name χαρακτηριστικού είναι σταθερό κλειδί μηχανής.
• Χρησιμοποιήστε το ίδιο name για να ενημερώσετε ένα υπάρχον χαρακτηριστικό.
• Εάν ένα χαρακτηριστικό έχει unit, η value πρέπει να είναι αριθμός.
• Εάν ένα χαρακτηριστικό έχει valueLabel, η value πρέπει να είναι string.
• Εάν ένα χαρακτηριστικό έχει description, απαιτούνται μεταφρασμένες περιγραφές για τη δημοσίευση.
• Εάν ένα χαρακτηριστικό έχει valueLabel, απαιτούνται μεταφρασμένες ετικέτες τιμών για τη δημοσίευση.

Ασφαλής συμπεριφορά

Μην επινοείτε γεγονότα προϊόντων, κωδικούς κατηγοριών, κωδικούς HS, προέλευση, πιστοποιήσεις, ποσότητες, τιμές ή τεχνικές προδιαγραφές.

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