Λάβετε ένα αποτέλεσμα από ένα μόνο κελί
Αφού εγκαταστήσετε το πρόσθετο GenderAPI for Google Sheets και αποθηκεύσετε το κλειδί στις ρυθμίσεις Formula του, γράψτε =GENDER(A2) για να αναλύσετε το όνομα στο κελί A2. Με τα προαιρετικά ορίσματα επιλέγετε ως είσοδο μια διεύθυνση email ή ένα όνομα χρήστη, γεωγραφικό πλαίσιο και πρόσθετες στήλες αποτελέσματος.
Ο GENDER είναι εγγενής τύπος του πρόσθετου. Δεν δέχεται αντικείμενο JSON αιτήματος V2 και δεν επιστρέφει τη δομή απόκρισης της V2.
Αποθηκεύστε το κλειδί πριν γράψετε τύπους
- Ανοίξτε Επεκτάσεις (Extensions) → GenderAPI → Determine Gender και έπειτα μεταβείτε στη σελίδα Formula από το μενού της πλαϊνής στήλης.
- Επιλέξτε ένα αποθηκευμένο κλειδί API ή εισαγάγετε το δικό σας και αποθηκεύστε το. Κρατήστε τα διαπιστευτήρια στην πλαϊνή στήλη και όχι σε κοινόχρηστα κελιά.
- Εισαγάγετε μια αντιπροσωπευτική τιμή στο A2 και βάλτε τον τύπο σε άλλο κελί. Αφήστε χώρο στα δεξιά αν ζητάτε πρόσθετες πληροφορίες.
- Ελέγξτε το αποτέλεσμα και την τρέχουσα βοήθεια στην πλαϊνή στήλη πριν αντιγράψετε τον τύπο σε άλλες γραμμές.
Τα ορίσματα ακολουθούν αυτή τη σειρά
| Όρισμα | Τύπος | Προεπιλεγμένη τιμή | Περιγραφή |
|---|---|---|---|
input | Κείμενο ή αναφορά κελιού | Υποχρεωτικό | Ένα όνομα, μια διεύθυνση email ή ένα όνομα χρήστη, για παράδειγμα A2. |
method | Κείμενο | name | name, email ή username, ανάλογα με την είσοδο. |
country_filter | Κείμενο | Χωρίς φίλτρο χώρας | Προαιρετικός διψήφιος κωδικός χώρας. Χρησιμοποιήστε κενή συμβολοσειρά για να παραλείψετε αυτό το όρισμα πριν από το additional_info. |
additional_info | Λογική τιμή | FALSE | Το TRUE επιστρέφει πρόσθετα πεδία στις γειτονικές στήλες. Το FALSE επιστρέφει μόνο το φύλο. |
Κάθε γραμμή είναι ξεχωριστός τύπος. Επιλέξτε τη μέθοδο που ταιριάζει στην τιμή του A2. Τα παραδείγματα δείχνουν τη σύνταξη και δεν εγγυώνται συγκεκριμένο αποτέλεσμα. Ανάλογα με τις τοπικές ρυθμίσεις του υπολογιστικού φύλλου, το διαχωριστικό ορισμάτων μπορεί να είναι το ερωτηματικό αντί για το κόμμα.
=GENDER(A2)
=GENDER(A2, "email")
=GENDER(A2, "username")
=GENDER(A2, "name", "IT", TRUE)
=GENDER(A2, "email", "", TRUE)Αφήστε χώρο για τα εκτεταμένα αποτελέσματα
Με ενεργοποιημένο το additional_info, η τρέχουσα βοήθεια στην πλαϊνή στήλη του Google Sheets αναφέρει τέσσερις τιμές με αυτή τη σειρά: φύλο, χώρα, πιθανότητα και κανονικοποιημένο όνομα. Η σειρά αυτή διαφέρει από εκείνη των τύπων του Excel. Ελέγξτε τη βοήθεια του εγκατεστημένου πρόσθετου όταν δημιουργείτε τις κεφαλίδες των στηλών.
Αφήστε κενά όλα τα κελιά προορισμού ώστε ο πίνακας να μπορεί να επεκταθεί. Ένας μπλοκαρισμένος πίνακας, ένα κλειδί που λείπει ή ένα σφάλμα της πλατφόρμας χρειάζονται ξεχωριστή αντιμετώπιση. Δεν είναι προβλέψεις με αποτέλεσμα unknown.
| Θέση | Τρέχουσα βοήθεια του Sheets | Χειρισμός |
|---|---|---|
| 1 | Gender | Αποθηκεύστε τα μη επιλυμένα αποτελέσματα ως unknown και διακρίνετέ τα από τα μηνύματα σφάλματος. |
| 2 | Country | Πλαίσιο που επιστρέφει η αναζήτηση, όχι επαληθευμένη τοποθεσία. |
| 3 | Probability | Κρατήστε αυτή την παλαιότερη τιμή μαζί με το αποτέλεσμα. Μην τη μετονομάζετε σε confidence της V2. |
| 4 | Normalized name | Ελέγξτε το όνομα που προκύπτει από την είσοδό σας πριν το χρησιμοποιήσετε αλλού. |
Κατανοήστε τους επανυπολογισμούς και τις σημειώσεις cache
Ο τύπος είναι δυναμικός. Μια αλλαγή στην είσοδό του ή ένας επανυπολογισμός του φύλλου μπορεί να απαιτήσει νέα επεξεργασία. Το πρόσθετο μπορεί να προσθέσει μια σημείωση με τον τύπο και το αποτέλεσμα που έχει αποθηκευτεί στην cache, αλλά η σημείωση δεν εγγυάται ότι κάθε επόμενος επανυπολογισμός θα γίνει χωρίς νέο αίτημα ή χωρίς κατανάλωση πιστώσεων.
Η Google εφαρμόζει όρια εκτέλεσης για τις προσαρμοσμένες συναρτήσεις και για το URL Fetch ανεξάρτητα από τις πιστώσεις GenderAPI. Σύμφωνα με την τρέχουσα τεκμηρίωση της Google, κάθε εκτέλεση προσαρμοσμένης συνάρτησης περιορίζεται στα 30 δευτερόλεπτα. Πάρα πολλοί ταυτόχρονοι τύποι ή αργά αιτήματα μπορεί να προκαλέσουν σφάλματα ακόμη κι αν ο λογαριασμός σας έχει ακόμη πιστώσεις.
Για ένα σταθερό στιγμιότυπο, αντιγράψτε τα συμπληρωμένα αποτελέσματα και επικολλήστε τα ως τιμές σε άλλο εύρος. Αυτό το αντίγραφο δεν εξαρτάται πλέον από τον τύπο. Κρατήστε επίσης την αρχική είσοδο και την ημερομηνία του ελέγχου.
Σχεδιάστε πιστώσεις, όρια και νέες εκτελέσεις
Ένας εγγεγραμμένος δωρεάν λογαριασμός GenderAPI περιλαμβάνει 200 πιστώσεις την ημέρα. Πρόκειται για υπόλοιπο λογαριασμού, όχι για υπόσχεση 200 αναγνωρισμένων αποτελεσμάτων σε κάθε ροή εργασίας. Πριν ξεκινήσετε, ελέγξτε το υπόλοιπο του επιλεγμένου κλειδιού και τις τρέχουσες επιλογές επεξεργασίας του εργαλείου.
Τα πρόσθετα και η επεξεργασία αρχείων ακολουθούν δικές τους διαδρομές επεξεργασίας. Το όριο παρτίδας του REST API V2, οι επιλογές AI και τα πεδία χρέωσης ανά αίτημα δεν εφαρμόζονται αυτόματα σε αυτά τα εργαλεία. Μια νέα εκτέλεση ή ένας επανυπολογισμός μπορεί να στείλει νέα αιτήματα και να καταναλώσει πιστώσεις. Μην θεωρείτε δεδομένο ότι είναι δωρεάν.
Ξεκινήστε με ένα μικρό δείγμα, αποθηκεύστε τα αποτελέσματα που λάβατε και ελέγξτε τις γραμμές που απέτυχαν πριν επαναλάβετε την εκτέλεση. Αν χρειάζεται μόνο να διορθώσετε μια εξαγωγή ή μια ενημέρωση στον προορισμό, χρησιμοποιήστε ξανά τα αποτελέσματα που ήδη έχετε.
Πότε να χρησιμοποιήσετε απευθείας το API V2
Ρυθμίστε μια ξεχωριστή ενσωμάτωση HTTP αν η εφαρμογή σας χρειάζεται ρητές επιλογές AI και τις πληροφορίες status, source, confidence_kind και usage της V2 για κάθε στοιχείο. Ακολουθήστε τη σύμβαση αιτήματος και απόκρισης της V2. Η προσθήκη ονομάτων πεδίων της V2 σε έναν εγγενή τύπο ή σε ένα υπάρχον πρόσθετο δεν αλλάζει τη συμπεριφορά του.
Συχνές ερωτήσεις
Ο τύπος ονομάζεται GENDER_API;
Όχι. Το πρόσθετο για το Google Sheets τεκμηριώνει τον =GENDER(input, method, country_filter, additional_info). Το Microsoft Excel χρησιμοποιεί διαφορετικά ονόματα: GENDER.FROM_NAME, GENDER.FROM_EMAIL και GENDER.FROM_USERNAME.
Μπορώ να ζητήσω πρόσθετα πεδία χωρίς φίλτρο χώρας;
Ναι. Αφήστε κενό το τρίτο όρισμα, για παράδειγμα =GENDER(A2, "email", "", TRUE). Τα πρόσθετα πεδία επεκτείνονται τότε στα γειτονικά κελιά.
Κάνει η σημείωση cache δωρεάν τους επανυπολογισμούς;
Ένα αποθηκευμένο αποτέλεσμα μπορεί να χρησιμοποιηθεί ξανά, αλλά η σημείωση δεν εγγυάται ότι κάθε μελλοντική εκτέλεση θα γίνει χωρίς νέο αίτημα. Παρακολουθείτε τις πιστώσεις και αποθηκεύστε σταθερές τιμές όταν δεν χρειάζεται δυναμικός επανυπολογισμός.
Έχουν όλοι όσοι επεξεργάζονται το υπολογιστικό φύλλο αυτόματα πρόσβαση στον τύπο;
Μην το θεωρείτε δεδομένο. Βεβαιωθείτε ότι το πρόσθετο είναι διαθέσιμο και εξουσιοδοτημένο για τους σχετικούς χρήστες και το σχετικό έγγραφο. Κοινοποιήστε ένα αντίγραφο μόνο με τιμές αν οι παραλήπτες χρειάζονται μόνο τα συμπληρωμένα αποτελέσματα.
Τεκμηρίωση αναφοράς
Ο οδηγός ελέγχθηκε τελευταία φορά στις . Ελέγξτε την εγκατάσταση στην τεκμηρίωση της πλατφόρμας και χρησιμοποιήστε τη συνδεδεμένη τεκμηρίωση API για μια ξεχωριστή ενσωμάτωση V2.