Ξεκινήστε μια επεξεργασία αρχείου από τον πίνακα ελέγχου του λογαριασμού
Το εργαλείο αρχείων του GenderAPI διαβάζει ένα υπολογιστικό φύλλο, σας επιτρέπει να αντιστοιχίσετε μια στήλη με ονόματα, διευθύνσεις email ή ονόματα χρήστη και ετοιμάζει μια εμπλουτισμένη εξαγωγή CSV. Χρησιμοποιήστε το για επεξεργασία βασισμένη σε αρχεία όταν δεν χρειάζεται να δημιουργήσετε ενσωμάτωση API.
Αυτή η ροή εργασίας στον πίνακα ελέγχου του λογαριασμού είναι ξεχωριστή από τα αιτήματα παρτίδας του REST V2. Ένα αρχείο δεν είναι αίτημα JSON V2. Τα όρια ανά στοιχείο και οι διαδρομές απόκρισης του V2 δεν ισχύουν για αυτή την εγγενή επεξεργασία.
Χρησιμοποιήστε μια μορφή που δέχεται ο επιλογέας αρχείων
Ο τρέχων επιλογέας αρχείων δέχεται ένα αρχείο κάθε φορά. Σε ένα βιβλίο εργασίας με πολλά φύλλα, επιλέξτε το σωστό φύλλο και ελέγξτε τις τιμές που διαβάστηκαν. Αν το αρχείο είναι σε άλλη μορφή, εξαγάγετέ το σε μία από τις μορφές της λίστας πριν ξεκινήσετε.
Η επεξεργασία εξαρτάται από την πολυπλοκότητα του αρχείου, τον αριθμό των γραμμών, την επιλεγμένη μέθοδο, τις πιστώσεις του λογαριασμού και το φορτίο της υπηρεσίας. Κάντε μια δοκιμή με ένα αντιπροσωπευτικό αρχείο. Αυτός ο οδηγός δεν υπόσχεται ούτε σταθερό μέγιστο μέγεθος ούτε σταθερό χρόνο επεξεργασίας.
| Μορφή | Αποδεκτή επέκταση |
|---|---|
| CSV | .csv |
| Excel | .xls, .xlsx |
| Apple Numbers | .numbers |
| OpenDocument | .ods |
| Τιμές διαχωρισμένες με στηλοθέτη | .tsv |
| Κείμενο | .txt |
Ελέγξτε τις προτάσεις πριν ξεκινήσετε την επεξεργασία
- Δημιουργήστε ένα αντίγραφο που περιέχει μόνο τα απαραίτητα δεδομένα. Κρατήστε την είσοδο σε μια στήλη με σαφές όνομα και τυχόν αξιόπιστους διψήφιους κωδικούς χώρας σε ξεχωριστή στήλη.
- Συνδεθείτε, ανοίξτε το εργαλείο Excel και CSV, επιλέξτε το σωστό κλειδί και έπειτα το αρχείο και το φύλλο.
- Κατά τη ρύθμιση του φύλλου, το εργαλείο μπορεί να στείλει δείγματα κελιών για να προτείνει στήλες με τη βοήθεια του AI. Ελέγξτε μόνοι σας τον τύπο εισόδου και τις προτεινόμενες στήλες πριν συνεχίσετε.
- Επιλέξτε ανάλυση ονομάτων, διευθύνσεων email ή ονομάτων χρήστη, επιβεβαιώστε τη στήλη προέλευσης και την προαιρετική αντιστοίχιση χώρας και έπειτα ελέγξτε τις επιλογές AI και εξαγωγής που εμφανίζει το εργαλείο.
- Ξεκινήστε την επεξεργασία και παρακολουθήστε την πρόοδο. Μην ανεβάζετε το ίδιο αρχείο πολλές φορές μόνο και μόνο επειδή η επεξεργασία δεν έχει ολοκληρωθεί ακόμη.
- Όταν η εξαγωγή είναι έτοιμη, κατεβάστε το αρχείο CSV, ελέγξτε την ευθυγράμμιση των γραμμών και εξετάστε τις εγγραφές που προσδιορίστηκαν, τις εγγραφές unknown και όσες απέτυχαν. Κρατήστε το αρχείο προέλευσης για σύγκριση.
Ελέγξτε τις ρυθμίσεις της επεξεργασίας αρχείου
| Ρύθμιση | Τύπος | Περιγραφή |
|---|---|---|
| Κλειδί API | Διαπιστευτήριο λογαριασμού | Ο λογαριασμός του οποίου το υπόλοιπο χρησιμοποιείται για αυτή την επεξεργασία. |
| Αρχείο και φύλλο | Επιλογή αρχείου | Ένα αποδεκτό αρχείο και το σωστό φύλλο. |
| Μέθοδος | Επιλογή | name, email ή username. Ελέγξτε την τιμή που προτείνεται αυτόματα. |
| Στήλη προέλευσης | Αντιστοίχιση στήλης | Η είσοδος που θα αναλυθεί σε κάθε γραμμή. Ελέγξτε τη γραμμή κεφαλίδων και τις τιμές του δείγματος. |
| Πλαίσιο χώρας | Προαιρετική στήλη ή ρύθμιση | Γνωστοί διψήφιοι κωδικοί χώρας, όταν είναι σχετικοί. |
| Επιλογές AI και εξαγωγής | Τρέχουσες ρυθμίσεις του εργαλείου | Ελέγξτε τις ρυθμίσεις που εμφανίζονται πριν από την επεξεργασία. Δεν είναι παράμετροι ai_mode του V2. |
Διαβάστε τις στήλες αποτελέσματος
Το εξαγόμενο αρχείο CSV προσθέτει τα εγγενή πεδία αποτελεσμάτων gender, country, probability και found_name. Βεβαιωθείτε ότι οι γραμμές αντιστοιχούν στο πρωτότυπο και ελέγξτε τις κεφαλίδες στηλών πριν εισαγάγετε το αρχείο σε άλλο σύστημα. Το αποτέλεσμα παρέχεται σε μορφή CSV ακόμη κι αν η είσοδος ήταν βιβλίο εργασίας Excel.
Οι προβλέψεις είναι συναγόμενες συσχετίσεις. Κρατήστε τις χωριστά από το φύλο που δηλώνει το ίδιο το άτομο και από επαληθευμένες πληροφορίες για τη χώρα.
- Ελέγξτε ένα συνηθισμένο αποτέλεσμα, μια αμφίσημη είσοδο και μια αποτυχημένη εκτέλεση πριν επεξεργαστείτε ολόκληρο το σύνολο δεδομένων.
- Ένα κενό κελί, το κείμενο null και ένα σφάλμα τύπου είναι διαφορετικές τιμές. Κανονικοποιήστε τα αποτελέσματα unknown συνειδητά, χωρίς να αποκρύπτετε τα σφάλματα.
- Χρησιμοποιήστε ουδέτερη διατύπωση για τις περιπτώσεις unknown ή αβέβαιες και κρατήστε τις πληροφορίες που δίνει το ίδιο το άτομο χωριστά από τις προβλέψεις.
| Αποτέλεσμα | Τύπος | Χρήση |
|---|---|---|
| Gender | Κείμενο ή μη επιλυμένη τιμή | Κρατήστε male ή female μόνο όταν το αποτέλεσμα είναι επιτυχές. Αποθηκεύστε μια μη επιλυμένη τιμή ως unknown και ελέγξτε χωριστά τα μηνύματα σφάλματος. |
| Probability | Αριθμός, όταν είναι διαθέσιμος | Ένας παλαιότερος δείκτης βεβαιότητας. Δεν αντιστοιχεί ούτε στο πεδίο confidence της V2 ούτε σε ακρίβεια μετρημένη στα δικά σας δεδομένα. |
| Country | Κείμενο, όταν είναι διαθέσιμο | Πλαίσιο που επιστρέφει η αναζήτηση. Κρατήστε το χωριστά από την επαληθευμένη χώρα του πελάτη. |
| Found / normalized name | Κείμενο, όταν είναι διαθέσιμο | Το όνομα που χρησιμοποιήθηκε ή εξήχθη κατά την επεξεργασία. Ελέγξτε το όταν μια διεύθυνση email ή ένα όνομα χρήστη είναι αμφίσημο. |
Σχεδιάστε πιστώσεις, όρια και νέες εκτελέσεις
Ένας εγγεγραμμένος δωρεάν λογαριασμός GenderAPI περιλαμβάνει 200 πιστώσεις την ημέρα. Πρόκειται για υπόλοιπο λογαριασμού, όχι για υπόσχεση 200 αναγνωρισμένων αποτελεσμάτων σε κάθε ροή εργασίας. Πριν ξεκινήσετε, ελέγξτε το υπόλοιπο του επιλεγμένου κλειδιού και τις τρέχουσες επιλογές επεξεργασίας του εργαλείου.
Τα πρόσθετα και η επεξεργασία αρχείων ακολουθούν δικές τους διαδρομές επεξεργασίας. Το όριο παρτίδας του REST API V2, οι επιλογές AI και τα πεδία χρέωσης ανά αίτημα δεν εφαρμόζονται αυτόματα σε αυτά τα εργαλεία. Μια νέα εκτέλεση ή ένας επανυπολογισμός μπορεί να στείλει νέα αιτήματα και να καταναλώσει πιστώσεις. Μην θεωρείτε δεδομένο ότι είναι δωρεάν.
Ξεκινήστε με ένα μικρό δείγμα, αποθηκεύστε τα αποτελέσματα που λάβατε και ελέγξτε τις γραμμές που απέτυχαν πριν επαναλάβετε την εκτέλεση. Αν χρειάζεται μόνο να διορθώσετε μια εξαγωγή ή μια ενημέρωση στον προορισμό, χρησιμοποιήστε ξανά τα αποτελέσματα που ήδη έχετε.
Λάβετε υπόψη την προκαταρκτική ανάλυση και τη διατήρηση του αρχείου
Η επιλογή του φύλλου μπορεί να στείλει δείγματα κελιών για αντιστοίχιση στηλών με τη βοήθεια του AI πριν ξεκινήσει το τελικό στάδιο της επεξεργασίας. Μη θεωρείτε δεδομένο ότι όλα τα δεδομένα μένουν στη συσκευή σας μέχρι να ξεκινήσετε την επεξεργασία. Αφαιρέστε τις περιττές στήλες και διαβάστε την πολιτική απορρήτου πριν επιλέξετε αρχείο με προσωπικά δεδομένα.
Μετά την εξαγωγή, χρησιμοποιήστε τη διαθέσιμη ενέργεια διαγραφής όταν δεν χρειάζεστε πλέον το αντίγραφο στον χώρο εργασίας. Η δημοσιευμένη πολιτική περιγράφει την προγραμματισμένη αφαίρεση από τα ενεργά συστήματα και τη διατήρηση στα αντίγραφα ασφαλείας. Ένα χρονοδιάγραμμα διαγραφής δεν αποδεικνύει ότι όλα τα αντίγραφα έχουν ήδη αφαιρεθεί.
Πότε να χρησιμοποιήσετε απευθείας το API V2
Ρυθμίστε μια ξεχωριστή ενσωμάτωση HTTP αν η εφαρμογή σας χρειάζεται ρητές επιλογές AI και τις πληροφορίες status, source, confidence_kind και usage της V2 για κάθε στοιχείο. Ακολουθήστε τη σύμβαση αιτήματος και απόκρισης της V2. Η προσθήκη ονομάτων πεδίων της V2 σε έναν εγγενή τύπο ή σε ένα υπάρχον πρόσθετο δεν αλλάζει τη συμπεριφορά του.
Συχνές ερωτήσεις
Δέχεται το εργαλείο αρχεία XLSM;
Ο τρέχων επιλογέας αρχείων περιλαμβάνει CSV, XLS, XLSX, Numbers, ODS, TSV και TXT. Εξαγάγετε ένα βιβλίο εργασίας XLSM σε μία από αυτές τις μορφές και ελέγξτε τις τιμές που προκύπτουν πριν το ανεβάσετε.
Είναι πάντα σωστές οι προτάσεις στηλών;
Όχι. Ελέγξτε τον τύπο εισόδου, τον χειρισμό της γραμμής κεφαλίδων, τη στήλη προέλευσης και την αντιστοίχιση χώρας. Κατά τη ρύθμιση μπορεί να σταλούν δείγματα δεδομένων για προτάσεις με τη βοήθεια του AI.
Θα λάβω πίσω το αρχικό βιβλίο εργασίας Excel;
Η τεκμηριωμένη επεξεργασία εξάγει τα αποτελέσματα σε μορφή CSV. Ελέγξτε τις στήλες που εξήχθησαν και την ευθυγράμμιση των γραμμών πριν τις μεταφέρετε στο αρχικό βιβλίο εργασίας ή σε άλλο εργαλείο.
Είναι το ίδιο με ένα αίτημα παρτίδας V2;
Όχι. Είναι μια επεξεργασία αρχείου στον πίνακα ελέγχου του λογαριασμού με δικές της επιλογές και ροή. Χρησιμοποιήστε την τεκμηρίωση V2 για τις παρτίδες όταν δημιουργείτε αιτήματα JSON στη δική σας ενσωμάτωση.
Τεκμηρίωση αναφοράς
Ο οδηγός ελέγχθηκε τελευταία φορά στις . Ελέγξτε την εγκατάσταση στην τεκμηρίωση της πλατφόρμας και χρησιμοποιήστε τη συνδεδεμένη τεκμηρίωση API για μια ξεχωριστή ενσωμάτωση V2.