Επεξεργαστείτε τις επιλεγμένες γραμμές από την πλαϊνή στήλη
Το πρόσθετο GenderAPI for Google Sheets διαβάζει μια στήλη με ονόματα, διευθύνσεις email ή ονόματα χρήστη και γράφει στο φύλλο τα πεδία αποτελέσματος που έχετε επιλέξει. Από την πλαϊνή στήλη μπορείτε να επεξεργαστείτε ένα συγκεκριμένο εύρος και να αποθηκεύσετε τις τιμές χωρίς να διατηρείτε έναν τύπο σε κάθε κελί.
Αυτή είναι η εγγενής ροή εργασίας του πρόσθετου. Οι στήλες αποτελέσματος και η επεξεργασία των παρτίδων του είναι ανεξάρτητες από τη δημόσια μορφή απόκρισης του REST API V2.
Εγκαταστήστε, συνδέστε και δοκιμάστε με ένα μικρό δείγμα
- Εγκαταστήστε το πρόσθετο από την καταχώρισή του στο Google Workspace Marketplace και ελέγξτε τις άδειες που ζητά. Στο Google Sheets ανοίξτε Επεκτάσεις (Extensions) → GenderAPI → Determine Gender.
- Επιλέξτε ένα κλειδί GenderAPI ή εισαγάγετέ το στην πλαϊνή στήλη. Βεβαιωθείτε ότι ο επιλεγμένος λογαριασμός έχει διαθέσιμες πιστώσεις.
- Επιλέξτε το φύλλο και τη μέθοδο name, email ή username. Ορίστε την αντίστοιχη στήλη προέλευσης και ένα μικρό εύρος γραμμών χωρίς τη γραμμή κεφαλίδων.
- Επιλέξτε μια ξεχωριστή στήλη για το φύλο και, αν χρειάζεται, στήλες για πιθανότητα, χώρα και όνομα που βρέθηκε. Μην αντικαθιστάτε τις αρχικές τιμές.
- Αν διαθέτετε αξιόπιστο γεωγραφικό πλαίσιο, χρησιμοποιήστε τη ρύθμιση χώρας ή μια στήλη με κωδικούς χώρας. Μην συνάγετε αυτό το πλαίσιο από την πρόβλεψη που πρόκειται να ζητήσετε.
- Ελέγξτε την επιλογή παράλειψης των υπαρχόντων αποτελεσμάτων, ξεκινήστε την επεξεργασία και εξετάστε τις επιλεγμένες γραμμές πριν διευρύνετε το εύρος.
Αντιστοιχίστε δεδομένα εισόδου και προορισμούς
| Ρύθμιση | Τύπος | Επιλογή και περιγραφή |
|---|---|---|
| Κλειδί API | Αναγνωριστικό λογαριασμού | Χρησιμοποιήστε το κλειδί που έχει επιλεγεί στο πρόσθετο και ελέγξτε ότι είναι έγκυρο και έχει υπόλοιπο. |
| Μέθοδος | Επιλογή | name, email ή username, ανάλογα με τη στήλη προέλευσης. |
| Φύλλο και εύρος γραμμών | Φύλλο και αριθμοί γραμμών | Επιλέξτε μόνο τις γραμμές προς επεξεργασία και εξαιρέστε τη γραμμή κεφαλίδων. |
| Στήλη προέλευσης | Αναφορά στήλης | Η μοναδική στήλη εισόδου για την επιλεγμένη μέθοδο. |
| Γεωγραφικό πλαίσιο | Προαιρετική ρύθμιση ή στήλη | Χρησιμοποιήστε αξιόπιστους διψήφιους κωδικούς χώρας, όταν υπάρχουν. |
| Στήλες αποτελέσματος | Αναφορές στηλών | Το φύλο είναι ο κύριος προορισμός. Η πιθανότητα, η χώρα και το όνομα που βρέθηκε είναι προαιρετικά. |
| Παράλειψη υπαρχόντων αποτελεσμάτων | Πλαίσιο ελέγχου | Ελέγξτε αυτή τη ρύθμιση ώστε μια νέα εκτέλεση να μην αντικαταστήσει κατά λάθος γραμμές που έχουν ήδη συμπληρωθεί. |
Διαβάστε τις στήλες αποτελέσματος
Κρατήστε την αρχική τιμή δίπλα στο αποτέλεσμα. Μια συσχέτιση που βασίζεται στο όνομα δεν καθορίζει το φύλο που δηλώνει το ίδιο το άτομο, και μια χώρα που επιστρέφεται δεν αποδεικνύει ούτε τόπο κατοικίας ούτε υπηκοότητα.
- Ελέγξτε ένα συνηθισμένο αποτέλεσμα, μια αμφίσημη είσοδο και μια αποτυχημένη εκτέλεση πριν επεξεργαστείτε ολόκληρο το σύνολο δεδομένων.
- Ένα κενό κελί, το κείμενο 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 σε έναν εγγενή τύπο ή σε ένα υπάρχον πρόσθετο δεν αλλάζει τη συμπεριφορά του.
Συχνές ερωτήσεις
Χρειάζεται να γράψω κώδικα για να χρησιμοποιήσω την πλαϊνή στήλη;
Όχι. Εγκαταστήστε το πρόσθετο, συνδέστε το κλειδί και αντιστοιχίστε τη στήλη προέλευσης και τις στήλες αποτελέσματος. Μια απευθείας ενσωμάτωση με το API V2 είναι ξεχωριστή επιλογή για προσαρμοσμένες εφαρμογές.
Μπορώ να επεξεργαστώ υπάρχουσες γραμμές;
Ναι. Χρησιμοποιήστε τις ρυθμίσεις φύλλου και εύρους γραμμών στην πλαϊνή στήλη. Πριν ξεκινήσετε την επεξεργασία, ελέγξτε τη γραμμή κεφαλίδων, τον τύπο εισόδου, τις στήλες προορισμού και την επιλογή για τα υπάρχοντα αποτελέσματα.
Αντιστοιχούν οι στήλες αποτελέσματος στην απόκριση JSON της V2;
Όχι. Η εγγενής επεξεργασία του πρόσθετου γράφει στο φύλλο τα πεδία που υποστηρίζει. Τα αντικείμενα data και meta και τα πεδία source και confidence_kind ανήκουν στη σύμβαση του απευθείας REST API V2.
Πώς χειρίζομαι ένα αποτέλεσμα unknown;
Αποθηκεύστε το ως unknown και διακρίνετέ το από μια αποτυχημένη εκτέλεση. Ελέγξτε τις αμφίσημες εισόδους και χρησιμοποιήστε ουδέτερη διατύπωση αντί να αποδίδετε αυτόματα ένα φύλο.
Τεκμηρίωση αναφοράς
Ο οδηγός ελέγχθηκε τελευταία φορά στις . Ελέγξτε την εγκατάσταση στην τεκμηρίωση της πλατφόρμας και χρησιμοποιήστε τη συνδεδεμένη τεκμηρίωση API για μια ξεχωριστή ενσωμάτωση V2.