Mapuj nowe rekordy na kolumny wyników
Dodatek GenderAPI oferuje ekran Workflows, który mapuje nowe rekordy arkusza na kolumnę płci i inne opcjonalne kolumny wyników. Skonfiguruj go dla właściwego arkusza, a następnie sprawdź rzeczywiście przychodzący rekord, zanim zaczniesz polegać na automatyzacji.
Natywny przepływ pracy jest oddzielony od bezpośredniej akcji HTTP V2. Jego wyzwalanie, opóźnienie i pola wyjściowe zależą od zainstalowanego dodatku i konta Google; natychmiastowa aktualizacja nie jest gwarantowana dla każdego źródła nowych wierszy.
Utwórz i przetestuj przepływ pracy
- Zainstaluj i otwórz dodatek GenderAPI, a następnie otwórz Workflows z menu panelu bocznego.
- Wybierz arkusz i swój klucz API. Wybierz analizę name, email lub username zgodnie z kolumną źródłową.
- Zmapuj kolumnę źródłową na osobną kolumnę płci. Miejsca docelowe dla prawdopodobieństwa, kraju i znalezionego imienia dodawaj tylko wtedy, gdy ich potrzebujesz.
- Przed utworzeniem przepływu pracy sprawdź wszystkie mapowania. Interfejs zapobiega konfliktom kolumn i może zgłosić istniejący przepływ pracy lub osiągnięty limit.
- Dodaj reprezentatywny rekord tym samym mechanizmem, którego używają Twoje dane produkcyjne. Sprawdź, czy wartości pojawiają się we właściwym wierszu i czy żadne istniejące pole nie zostało nadpisane.
- Przetestuj nierozstrzygniętą wartość i błąd operacyjny, a następnie zdecyduj, jak będziesz wykrywać i sprawdzać brakujące lub nieudane wiersze.
Skonfiguruj pola natywnego przepływu pracy
| Ustawienie | Typ | Zastosowanie |
|---|---|---|
| Klucz API | Dane uwierzytelniające | Wybierz właściwe konto i sprawdź dostępne kredyty. |
| Arkusz | Wybór arkusza | Arkusz, którego rekordy ma przetwarzać ten przepływ pracy. |
| Metoda | Wybór | name, email lub username; wybrana metoda określa sposób interpretacji danych wejściowych. |
| Kolumna źródłowa | Odwołanie do kolumny | Wartość do przeanalizowania w każdym rekordzie. |
| Kolumna płci | Odwołanie do kolumny | Miejsce docelowe odrębne od danych wejściowych i pozostałych wyników. |
| Prawdopodobieństwo, kraj, znalezione imię | Opcjonalne miejsca docelowe | Osobne kolumny na dodatkowe natywne wyniki. |
Sprawdź, jak wiersze faktycznie trafiają do arkusza
Wpisanie wartości, przesłanie formularza i import rekordów z CRM to różne zdarzenia. Zgodnie z dokumentacją Google wykonania skryptów i zapytania API zazwyczaj nie uruchamiają wyzwalaczy instalowanych. Publiczna karta dodatku nie pozwala ustalić jego dokładnej implementacji: przetestuj źródło danych, którego zamierzasz używać.
Nie zakładaj, że nowy przepływ pracy przetworzy wstecznie istniejące wiersze. Dla takich rekordów zaznacz zakres w panelu przetwarzania zbiorczego i prowadź rejestr już przetworzonych wierszy.
Jeśli oczekiwana aktualizacja się nie pojawi, sprawdź przepływ pracy, uprawnienia, saldo klucza, mapowania kolumn i błędy platformy, zanim ponownie wyślesz te same rekordy.
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.
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 każdy import z CRM uruchamia natywny przepływ pracy?
Nie zakładaj tego. Przetestuj rekord pochodzący z rzeczywiście używanego CRM lub automatyzacji. Google rozróżnia ręczne edycje, przesłania formularzy i aktualizacje przez API; sprawdź zachowanie zainstalowanego dodatku.
Czy mogę przetworzyć wiersze, które już są w arkuszu?
Zaznacz zakres w panelu przetwarzania zbiorczego. Utworzenie przepływu pracy dla nowych wierszy nie oznacza przetworzenia istniejących rekordów.
Ile przepływów pracy mogę utworzyć?
Interfejs może zgłosić limit, ale ten przewodnik nie podaje niezweryfikowanej liczby. Sprawdź zainstalowaną wersję i w razie potrzeby usuń niepotrzebne już przepływy pracy.
Jak uzyskać pola source i usage z V2?
Utwórz osobną integrację HTTP V2, na przykład według udokumentowanej instrukcji dla Make lub Zapier. Nie zakładaj, że kolumny dodatku zawierają strukturę odpowiedzi V2.
Dokumentacja źródłowa
Ostatnia weryfikacja tego poradnika: . Instalację sprawdź w dokumentacji platformy, a przy osobnej integracji V2 skorzystaj z podlinkowanej dokumentacji API.