🟢 Foxentry funkce v Google Sheets
Kromě validace přes postranní panel nabízí doplněk Foxentry pro Google Sheets také možnost pracovat přímo s tabulkovými funkcemi (vzorci). Ty se dělí do dvou základních kategorií podle toho, zda odesílají dotaz na API, nebo pouze zpracovávají již stažená data.
Důležité upozornění pro práci s funkcemi
Při použití validací pomocí tabulkových funkcí je nutné získané výsledky vždy takzvaně přeuložit. Pokud tak neučiníte, při každé aktualizaci stránky (nebo úpravě tabulky) Google Sheets vzorce přepočítá a odešle nový požadavek na naše API. Zbytečně byste tak přicházeli o kredity. Vždy proto po validaci zkopírujte získané výsledky (Ctrl + C) a vložte je na to samé místo pouze jako hodnoty (Ctrl + Shift + V).
Funkce, které volají API (čerpají kredity)
Tyto funkce odesílají požadavky přímo na naše servery, zahajují samotnou validaci a spotřebovávají API kredity. Výsledkem je kompletní surová odpověď v textovém formátu (API Response).
| Funkce | Syntaxe | Popis |
|---|---|---|
=EMAIL_VALIDATE |
=EMAIL_VALIDATE(email, "extended/basic", true/false, true/false) |
Validuje e-mailovou adresu a vrací plnou odpověď z API.* |
=PHONE_VALIDATE |
=PHONE_VALIDATE(phone, "extended/basic") |
Validuje telefonní číslo a vrací plnou odpověď z API. |
=PHONE_VALIDATE_WITH_PREFIX |
=PHONE_VALIDATE_WITH_PREFIX(prefix, phone, "extended/basic") |
Validuje telefonní číslo a separátní předvolbu, následně vrací plnou odpověď z API. |
* Nastavení parametrů true/false u funkce EMAIL_VALIDATE určuje, zda má API považovat za platné dočasné e-maily (disposable) a freemaily. Toto nastavení je dostupné a funkční pouze pro rozšířenou validaci ("extended").
Funkce, které zpracovávají odpověď (nečerpají kredity)
Tyto funkce analyzují surovou odpověď (API Response), kterou jste získali z předchozích funkcí nebo přes postranní panel (sidebar). Slouží k vytažení konkrétních hodnot z kódu do samostatných buněk a nespotřebovávají žádné další API kredity.
| Funkce | Syntaxe | Popis |
|---|---|---|
=EMAIL_IS_FREEMAIL |
=EMAIL_IS_FREEMAIL(API_Response, "result/resultCorrected") |
Vrátí informaci, zda se jedná o freemailovou schránku. |
=EMAIL_IS_DISPOSABLE |
=EMAIL_IS_DISPOSABLE(API_Response, "result/resultCorrected") |
Vrátí informaci, zda se jedná o dočasnou e-mailovou schránku. |
=EMAIL_IS_CATCH_ALL_SERVER |
=EMAIL_IS_CATCH_ALL_SERVER(API_Response, "result/resultCorrected") |
Vrátí informaci, zda se jedná o catch-all server. |
=PHONE_GET_TYPE |
=PHONE_GET_TYPE(API_Response) |
Vrátí informaci, o jaký typ telefonní linky se jedná (mobilní, pevná apod.). |
=PHONE_GET_CARRIER |
=PHONE_GET_CARRIER(API_Response) |
Vrátí informaci o poskytovateli (operátorovi) telefonního čísla. |
=PHONE_GET_FORMAT |
=PHONE_GET_FORMAT(API_Response, "RAW/National/E.164/E.123", "result/resultCorrected/suggestion") |
Vrátí telefonní číslo naformátované v požadovaném mezinárodním či národním standardu. |
=GET_ERROR |
=GET_ERROR(API_Response) |
Vrátí informaci o případné chybě API nebo detailní stav vyhodnocení. |
=GET_PROPOSAL |
=GET_PROPOSAL(API_Response) |
Vrátí informaci o navržené opravě dat (pokud je k dispozici). |
=GET_CORRECTED |
=GET_CORRECTED(API_Response) |
Vrátí již automaticky opravená data. |
=GET_SUGGESTION |
=GET_SUGGESTION(API_Response) |
Vrátí pravděpodobnější alternativu nebo doporučenou opravu údaje. |
Jak funkce reálně použít?
Podrobný postup a ukázky, jak přesně tyto vzorce zadávat do buněk a jak na sebe navazují, najdete v našem navazujícím návodu.
Pořád nevíte? Ozvěte se nám