Εμπλουτίστε γραμμές του Excel από την πλαϊνή στήλη
Με το πρόσθετο GenderAPI για Excel επιλέγετε μια στήλη με ονόματα, διευθύνσεις email ή ονόματα χρήστη και γράφετε τα αποτελέσματα σε αντιστοιχισμένες στήλες του φύλλου εργασίας. Χρησιμοποιήστε την πλαϊνή στήλη για ένα ελεγχόμενο εύρος γραμμών ή τις συναρτήσεις GENDER.FROM_* για υπολογισμούς που βασίζονται σε κελιά.
Ο εγγενής πελάτης του Excel χρησιμοποιεί τα πεδία του παλαιού API. Δεν επιστρέφει τα αντικείμενα data και meta του REST V2. Διατηρήστε τις υπάρχουσες αντιστοιχίσεις του βιβλίου εργασίας ευθυγραμμισμένες με την πραγματική έξοδο του πρόσθετου.
Ρυθμίστε πρώτα ένα μικρό εύρος γραμμών
- Εγκαταστήστε το GenderAPI από την καταχώρισή του στον κατάλογο της Microsoft και ανοίξτε την πλαϊνή στήλη του πρόσθετου στο βιβλίο εργασίας. Ελέγξτε τα δικαιώματα πρόσβασης στο έγγραφο και τυχόν περιορισμούς του οργανισμού σας.
- Αποθηκεύστε το κλειδί GenderAPI στο πρόσθετο και βεβαιωθείτε ότι ο επιλεγμένος λογαριασμός διαθέτει πιστώσεις.
- Επιλέξτε τη μέθοδο name, email ή username και την αντίστοιχη στήλη προέλευσης. Ορίστε ένα μικρό εύρος γραμμών χωρίς τη γραμμή κεφαλίδων.
- Αντιστοιχίστε τη στήλη προορισμού για το φύλο και, αν χρειάζεται, στήλες για probability, χώρα και όνομα που εντοπίστηκε. Κρατήστε κάθε αποτέλεσμα χωριστά από τα δεδομένα προέλευσης.
- Ορίστε πλαίσιο χώρας μόνο όταν είναι αξιόπιστο για τα δεδομένα που επεξεργάζεστε. Ελέγξτε τις ρυθμίσεις που επιλέξατε και εκτελέστε το δείγμα.
- Εξετάστε τις γραμμές που προσδιορίστηκαν, δεν επιλύθηκαν ή απέτυχαν πριν επεκτείνετε το εύρος. Κρατήστε ένα αντίγραφο των αρχικών δεδομένων του βιβλίου εργασίας.
Επιλέξτε είσοδο, πλαίσιο και στήλες αποτελεσμάτων
| Ρύθμιση | Τύπος | Περιγραφή |
|---|---|---|
| Κλειδί API | Διαπιστευτήριο λογαριασμού | Αποθηκεύεται μέσω του πεδίου κλειδιού στο πρόσθετο. Μην το καταχωρίζετε σε συνηθισμένα κελιά του βιβλίου εργασίας. |
| Μέθοδος και προέλευση | Επιλογή και στήλη | name, email ή username μαζί με την αντίστοιχη στήλη προέλευσης. |
| Εύρος γραμμών | Αριθμοί γραμμών | Ξεκινήστε με ένα μικρό εύρος χωρίς τη γραμμή κεφαλίδων. |
| Φίλτρο χώρας | Προαιρετική χώρα ή στήλη | Δηλώνει ένα γνωστό πλαίσιο χώρας. Το πεδίο δεν πιστοποιεί την επαληθευμένη τοποθεσία του ατόμου. |
| Στήλες αποτελεσμάτων | Αναφορές στηλών | Μια στήλη προορισμού για το φύλο και προαιρετικοί προορισμοί για probability, χώρα και όνομα που εντοπίστηκε. |
Διαβάστε τις στήλες αποτελέσματος
Κρατήστε την αρχική τιμή δίπλα στο αποτέλεσμα. Μια συσχέτιση που βασίζεται στο όνομα δεν καθορίζει το φύλο που δηλώνει το ίδιο το άτομο, και μια χώρα που επιστρέφεται δεν αποδεικνύει ούτε τόπο κατοικίας ούτε υπηκοότητα.
- Ελέγξτε ένα συνηθισμένο αποτέλεσμα, μια αμφίσημη είσοδο και μια αποτυχημένη εκτέλεση πριν επεξεργαστείτε ολόκληρο το σύνολο δεδομένων.
- Ένα κενό κελί, το κείμενο null και ένα σφάλμα τύπου είναι διαφορετικές τιμές. Κανονικοποιήστε τα αποτελέσματα unknown συνειδητά, χωρίς να αποκρύπτετε τα σφάλματα.
- Χρησιμοποιήστε ουδέτερη διατύπωση για τις περιπτώσεις unknown ή αβέβαιες και κρατήστε τις πληροφορίες που δίνει το ίδιο το άτομο χωριστά από τις προβλέψεις.
| Αποτέλεσμα | Τύπος | Χρήση |
|---|---|---|
| Gender | Κείμενο ή μη επιλυμένη τιμή | Κρατήστε male ή female μόνο όταν το αποτέλεσμα είναι επιτυχές. Αποθηκεύστε μια μη επιλυμένη τιμή ως unknown και ελέγξτε χωριστά τα μηνύματα σφάλματος. |
| Probability | Αριθμός, όταν είναι διαθέσιμος | Ένας παλαιότερος δείκτης βεβαιότητας. Δεν αντιστοιχεί ούτε στο πεδίο confidence της V2 ούτε σε ακρίβεια μετρημένη στα δικά σας δεδομένα. |
| Country | Κείμενο, όταν είναι διαθέσιμο | Πλαίσιο που επιστρέφει η αναζήτηση. Κρατήστε το χωριστά από την επαληθευμένη χώρα του πελάτη. |
| Found / normalized name | Κείμενο, όταν είναι διαθέσιμο | Το όνομα που χρησιμοποιήθηκε ή εξήχθη κατά την επεξεργασία. Ελέγξτε το όταν μια διεύθυνση email ή ένα όνομα χρήστη είναι αμφίσημο. |
Σχεδιάστε πιστώσεις, όρια και νέες εκτελέσεις
Ένας εγγεγραμμένος δωρεάν λογαριασμός GenderAPI περιλαμβάνει 200 πιστώσεις την ημέρα. Πρόκειται για υπόλοιπο λογαριασμού, όχι για υπόσχεση 200 αναγνωρισμένων αποτελεσμάτων σε κάθε ροή εργασίας. Πριν ξεκινήσετε, ελέγξτε το υπόλοιπο του επιλεγμένου κλειδιού και τις τρέχουσες επιλογές επεξεργασίας του εργαλείου.
Τα πρόσθετα και η επεξεργασία αρχείων ακολουθούν δικές τους διαδρομές επεξεργασίας. Το όριο παρτίδας του REST API V2, οι επιλογές AI και τα πεδία χρέωσης ανά αίτημα δεν εφαρμόζονται αυτόματα σε αυτά τα εργαλεία. Μια νέα εκτέλεση ή ένας επανυπολογισμός μπορεί να στείλει νέα αιτήματα και να καταναλώσει πιστώσεις. Μην θεωρείτε δεδομένο ότι είναι δωρεάν.
Ξεκινήστε με ένα μικρό δείγμα, αποθηκεύστε τα αποτελέσματα που λάβατε και ελέγξτε τις γραμμές που απέτυχαν πριν επαναλάβετε την εκτέλεση. Αν χρειάζεται μόνο να διορθώσετε μια εξαγωγή ή μια ενημέρωση στον προορισμό, χρησιμοποιήστε ξανά τα αποτελέσματα που ήδη έχετε.
Επιλέξτε ποια δεδομένα θα κοινοποιήσετε
Οι ενσωματώσεις για υπολογιστικά φύλλα στέλνουν τις τιμές που απαιτούνται για την αναζήτηση και ζητούν άδειες για το επιλεγμένο έγγραφο. Πριν επεξεργαστείτε προσωπικά δεδομένα, ελέγξτε ποιος έχει πρόσβαση στο υπολογιστικό φύλλο, ποιος λογαριασμός είναι συνδεδεμένος και ποιες στήλες προορισμού χρησιμοποιούνται.
Κρατήστε το κλειδί API στις ρυθμίσεις του πρόσθετου και όχι σε κανονικά κελιά, στιγμιότυπα οθόνης ή κοινόχρηστα παραδείγματα. Η δημοσιευμένη πολιτική απορρήτου περιγράφει πώς γίνεται η επεξεργασία, η διατήρηση και η καταγραφή των δεδομένων εισόδου. Μια ενσωμάτωση για υπολογιστικά φύλλα δεν σημαίνει ότι τα δεδομένα παραμένουν αποκλειστικά στη συσκευή σας.
Πότε να χρησιμοποιήσετε απευθείας το API V2
Ρυθμίστε μια ξεχωριστή ενσωμάτωση HTTP αν η εφαρμογή σας χρειάζεται ρητές επιλογές AI και τις πληροφορίες status, source, confidence_kind και usage της V2 για κάθε στοιχείο. Ακολουθήστε τη σύμβαση αιτήματος και απόκρισης της V2. Η προσθήκη ονομάτων πεδίων της V2 σε έναν εγγενή τύπο ή σε ένα υπάρχον πρόσθετο δεν αλλάζει τη συμπεριφορά του.
Συχνές ερωτήσεις
Μπορώ να αναλύσω διευθύνσεις email και ονόματα χρήστη στο Excel;
Ναι. Επιλέξτε την αντίστοιχη μέθοδο στην πλαϊνή στήλη και αντιστοιχίστε τη σωστή στήλη εισόδου. Ελέγξτε το όνομα που επιστρέφεται και τις περιπτώσεις που δεν επιλύθηκαν πριν χρησιμοποιήσετε τα αποτελέσματα.
Να χρησιμοποιήσω την πλαϊνή στήλη ή έναν τύπο;
Χρησιμοποιήστε την πλαϊνή στήλη για να επεξεργαστείτε ένα επιλεγμένο εύρος και να γράψετε τις τιμές στις αντιστοιχισμένες στήλες. Επιλέξτε τους τύπους GENDER.FROM_* όταν χρειάζεστε υπολογισμούς που βασίζονται σε κελιά και λάβετε υπόψη τι συνεπάγεται ο επανυπολογισμός.
Σημαίνει το όνομα αρχείου functions_v2.js ότι το πρόσθετο χρησιμοποιεί το REST V2;
Όχι. Πρόκειται για όνομα αρχείου του πελάτη Excel. Το δημόσιο αρχείο τύπων που εξετάστηκε για αυτόν τον οδηγό καλεί endpoints του παλαιού API και διαβάζει τα πεδία απόκρισής τους.
Είναι οι προβλέψεις επαληθευμένα χαρακτηριστικά του πελάτη;
Όχι. Κρατήστε τις χωριστά από τις πληροφορίες που δίνει ο ίδιος ο πελάτης και χρησιμοποιήστε μια ουδέτερη εναλλακτική για τα αποτελέσματα unknown ή τις αβέβαιες περιπτώσεις.
Τεκμηρίωση αναφοράς
Ο οδηγός ελέγχθηκε τελευταία φορά στις . Ελέγξτε την εγκατάσταση στην τεκμηρίωση της πλατφόρμας και χρησιμοποιήστε τη συνδεδεμένη τεκμηρίωση API για μια ξεχωριστή ενσωμάτωση V2.