Uzupełniaj wiersze Excela z poziomu panelu bocznego
Dodatek GenderAPI dla Excela pozwala wybrać kolumnę z imionami, adresami e-mail lub nazwami użytkowników i zapisać wyniki w zmapowanych kolumnach arkusza. Użyj panelu bocznego dla kontrolowanego zakresu wierszy albo funkcji GENDER.FROM_* do obliczeń powiązanych z komórkami.
Natywny klient Excela korzysta z pól starszego API. Nie zwraca obiektów data i meta z REST V2; dopasuj istniejące mapowania w skoroszycie do rzeczywistych danych wyjściowych dodatku.
Najpierw skonfiguruj mały zakres wierszy
- Zainstaluj GenderAPI z jego strony w katalogu Microsoft i otwórz panel dodatku w skoroszycie. Sprawdź uprawnienia dostępu do dokumentu i ewentualne ograniczenia organizacji.
- Zapisz klucz GenderAPI w dodatku i sprawdź, czy wybrane konto ma dostępne kredyty.
- Wybierz metodę name, email lub username oraz odpowiadającą jej kolumnę źródłową. Ustaw mały zakres wierszy, bez nagłówka.
- Zmapuj kolumnę docelową dla płci oraz, w razie potrzeby, kolumny prawdopodobieństwa, kraju i znalezionego imienia. Trzymaj każdy wynik oddzielnie od danych źródłowych.
- Ustawiaj kontekst kraju tylko wtedy, gdy jest wiarygodny dla przetwarzanych danych. Sprawdź wybrane ustawienia i uruchom próbkę.
- Przejrzyj wiersze rozpoznane, nierozstrzygnięte i zakończone błędem, zanim rozszerzysz zakres. Przechowuj kopię oryginalnych danych skoroszytu.
Wybierz dane wejściowe, kontekst i kolumny wyników
| Ustawienie | Typ | Opis |
|---|---|---|
| Klucz API | Dane uwierzytelniające konta | Zapisywany za pomocą kontrolki klucza w dodatku; nie umieszczaj go w zwykłych komórkach skoroszytu. |
| Metoda i źródło | Wybór i kolumna | name, email lub username w parze z kolumną źródłową. |
| Zakres wierszy | Numery wierszy | Zacznij od małego zakresu bez wiersza nagłówka. |
| Filtr kraju | Opcjonalny kraj lub kolumna | Podaj znany kontekst kraju; to pole nie ustala zweryfikowanej lokalizacji osoby. |
| Kolumny wyników | Odwołania do kolumn | Kolumna docelowa dla płci oraz opcjonalne kolumny docelowe dla prawdopodobieństwa, kraju i znalezionego imienia. |
Odczytaj kolumny wyników
Przechowuj oryginalną wartość obok wyniku. Powiązanie oparte na imieniu nie ustala płci zadeklarowanej przez daną osobę, a zwrócony kraj nie potwierdza jej miejsca zamieszkania ani obywatelstwa.
- Zanim przetworzysz cały zbiór danych, sprawdź zwykły wynik, niejednoznaczne dane wejściowe i nieudaną operację.
- Pusta komórka, tekst null i błąd formuły to różne wartości. Normalizuj wyniki unknown świadomie, nie ukrywając błędów.
- W przypadkach unknown lub niepewnych używaj neutralnych sformułowań, a informacje podane przez samą osobę przechowuj osobno od prognoz.
| Wynik | Typ | Jak z niego korzystać |
|---|---|---|
| Gender | Tekst lub nierozstrzygnięta wartość | Zachowuj male lub female tylko dla udanego wyniku. Nierozstrzygniętą wartość zachowaj jako unknown, a komunikaty o błędach sprawdzaj osobno. |
| Probability | Liczba, jeśli jest dostępna | Historyczny wskaźnik pewności; nie odpowiada polu confidence z V2 ani zmierzonej dokładności na Twoich danych. |
| Country | Tekst, jeśli jest dostępny | Kontekst zwrócony przez wyszukiwanie. Przechowuj go osobno od zweryfikowanego kraju klienta. |
| Found / normalized name | Tekst, jeśli jest dostępny | Imię użyte lub wyodrębnione podczas przetwarzania. Sprawdź je, gdy adres e-mail lub nazwa użytkownika są niejednoznaczne. |
Zaplanuj kredyty, limity i ponowne uruchomienia
Zarejestrowane bezpłatne konto GenderAPI obejmuje 200 kredytów dziennie. To saldo konta, a nie obietnica 200 zidentyfikowanych wyników w każdym przepływie pracy. Przed rozpoczęciem sprawdź saldo wybranego klucza i aktualne opcje przetwarzania narzędzia.
Natywne dodatki i przetwarzanie plików mają własne ścieżki przetwarzania. Limit partii REST V2, opcje AI i pola rozliczeniowe poszczególnych zapytań nie mają do nich automatycznie zastosowania. Ponowne uruchomienie lub przeliczenie może wysłać nowe zapytania i zużyć kredyty: nie zakładaj, że jest bezpłatne.
Zacznij od małej próbki, zachowaj uzyskane wyniki i przed ponownym uruchomieniem przejrzyj nieudane wiersze. Jeśli musisz tylko poprawić eksport lub aktualizację w miejscu docelowym, użyj ponownie wyników, które już masz.
Wybierz dane, które udostępniasz
Integracje z arkuszami kalkulacyjnymi przesyłają wartości potrzebne do wyszukiwania i wymagają uprawnień do pracy z wybranym dokumentem. Przed przetwarzaniem danych osobowych sprawdź, kto ma dostęp do skoroszytu, jakie konto jest połączone i jakie są kolumny docelowe.
Przechowuj klucz API w ustawieniach dodatku, a nie w zwykłych komórkach, na zrzutach ekranu czy w udostępnianych przykładach. Opublikowana polityka prywatności opisuje przetwarzanie danych wejściowych, ich przechowywanie i logi; integracja z arkuszem kalkulacyjnym nie oznacza, że dane pozostają wyłącznie na Twoim urządzeniu.
Kiedy korzystać bezpośrednio z API V2
Skonfiguruj osobną integrację HTTP, gdy Twoja aplikacja potrzebuje jawnych opcji AI oraz, dla każdego elementu, informacji status, source, confidence_kind i usage z V2. Stosuj kontrakt zapytań i odpowiedzi V2: dodanie nazw pól V2 do natywnej formuły lub istniejącego dodatku nie zmienia ich działania.
Najczęstsze pytania
Czy w Excelu mogę analizować adresy e-mail i nazwy użytkowników?
Tak. Wybierz odpowiednią metodę w panelu bocznym i zmapuj właściwą kolumnę wejściową. Przed użyciem wyników sprawdź zwrócone imię i przypadki nierozstrzygnięte.
Czy lepiej użyć panelu bocznego, czy formuły?
Użyj panelu bocznego, aby przetworzyć wybrany zakres i zapisać wartości w zmapowanych kolumnach. Wybierz formuły GENDER.FROM_*, gdy potrzebujesz obliczeń powiązanych z komórkami i uwzględniasz skutki ponownego przeliczania.
Czy nazwa functions_v2.js oznacza, że dodatek korzysta z REST V2?
Nie. To nazwa pliku klienta Excela. Opublikowany plik formuł, sprawdzony na potrzeby tego przewodnika, wywołuje endpointy starszego API i odczytuje ich pola odpowiedzi.
Czy prognozy są zweryfikowanymi atrybutami klientów?
Nie. Przechowuj je oddzielnie od informacji podanych przez klienta i stosuj neutralne sformułowania dla przypadków unknown lub niepewnych.
Dokumentacja źródłowa
Ostatnia weryfikacja tego poradnika: . Instalację sprawdź w dokumentacji platformy, a przy osobnej integracji V2 skorzystaj z podlinkowanej dokumentacji API.