Artykuły w kategorii

🟢 Funkcje Foxentry w Arkuszach Google

Zaktualizowano miesiąc temu

Oprócz walidacji przez panel boczny, dodatek Foxentry do Google Sheets oferuje również możliwość pracy bezpośrednio z funkcjami (formułami) arkusza kalkulacyjnego. Dzielą się one na dwie podstawowe kategorie w zależności od tego, czy wysyłają zapytanie do API, czy tylko przetwarzają już pobrane dane.

⚠️ Ważne ostrzeżenie dotyczące pracy z funkcjami

Podczas korzystania z walidacji za pomocą funkcji arkusza kalkulacyjnego, należy zawsze "nadpisać" uzyskane wyniki jako wartości statyczne. Jeśli tego nie zrobisz, przy każdym odświeżeniu strony (lub edycji arkusza) Google Sheets ponownie przeliczy formuły i wyśle nowe żądanie do naszego API. W ten sposób niepotrzebnie stracisz kredity. Dlatego zawsze po walidacji skopiuj uzyskane wyniki (Ctrl + C) i wklej je w to samo miejsce tylko jako wartości (Ctrl + Shift + V).

Funkcje wywołujące API (zużywające kredyty)

Funkcje te wysyłają żądania bezpośrednio do naszych serwerów, inicjują samą walidację i zużywają kredyty API. Wynikiem jest kompletna surowa odpowiedź w formacie tekstowym (API Response).

Funkcja Składnia Opis
=EMAIL_VALIDATE =EMAIL_VALIDATE(email, "extended/basic", true/false, true/false) Waliduje adres e-mail i zwraca pełną odpowiedź z API.*
=PHONE_VALIDATE =PHONE_VALIDATE(phone, "extended/basic") Waliduje numer telefonu i zwraca pełną odpowiedź z API.
=PHONE_VALIDATE_WITH_PREFIX =PHONE_VALIDATE_WITH_PREFIX(prefix, phone, "extended/basic") Waliduje numer telefonu i oddzielny numer kierunkowy, a następnie zwraca pełną odpowiedź z API.

* Ustawienie parametrów true/false w funkcji =EMAIL_VALIDATE określa, czy API ma uznać tymczasowe adresy e-mail (disposable) i darmowe konta (freemail) za ważne. To ustawienie jest dostępne i działa tylko dla walidacji rozszerzonej ("extended").

Funkce przetwarzające odpowiedź (niezużywające kredytów)

Te funkcje analizują surową odpowiedź (API Response) uzyskaną z poprzednich funkcji lub przez panel boczny (sidebar). Służą do wyodrębniania konkretnych wartości z kodu do oddzielnych komórek i nie zużywają żadnych dodatkowych kredytów API.

Funkcja Składnia Opis
=EMAIL_IS_FREEMAIL =EMAIL_IS_FREEMAIL(API_Response, "result/resultCorrected") Zwraca informację, czy jest to darmowa skrzynka pocztowa (np. Gmail, WP).
=EMAIL_IS_DISPOSABLE =EMAIL_IS_DISPOSABLE(API_Response, "result/resultCorrected") Zwraca informację, czy jest to tymczasowa skrzynka e-mail.
=EMAIL_IS_CATCH_ALL_SERVER =EMAIL_IS_CATCH_ALL_SERVER(API_Response, "result/resultCorrected") Zwraca informację, czy jest to serwer typu catch-all.
=PHONE_GET_TYPE =PHONE_GET_TYPE(API_Response) Zwraca informację o typie linii telefonicznej (komórkowa, stacjonarna itp.).
=PHONE_GET_CARRIER =PHONE_GET_CARRIER(API_Response) Zwraca informacje o dostawcy (operatorze) numeru telefonu.
=PHONE_GET_FORMAT =PHONE_GET_FORMAT(API_Response, "RAW/National/E.164/E.123", "result/resultCorrected/suggestion") Zwraca numer telefonu sformatowany w żądanym standardzie międzynarodowym lub krajowym.
=GET_ERROR =GET_ERROR(API_Response) Zwraca informacje o ewentualnym błędzie API lub szczegółowy status oceny.
=GET_PROPOSAL =GET_PROPOSAL(API_Response) Zwraca informacje o proponowanej korekcie danych (jeśli jest dostępna).
=GET_CORRECTED =GET_CORRECTED(API_Response) Zwraca dane już automatycznie poprawione.
=GET_SUGGESTION =GET_SUGGESTION(API_Response) Zwraca bardziej prawdopodobną alternatywę lub zalecaną korektę danych.

Jak w praktyce używać tych funkcji?

Szczegółowe instrukcje i przykłady, jak dokładnie wprowadzać te formuły do komórek i jak się ze sobą łączą, znajdziesz w naszym kolejnym poradniku.

Nadal nie wiesz? Napisz do nas.