Poradnik Google Sheets

Weryfikacja numerów IBAN w Google Sheets za pomocą Apps Script

Sprawdź wybraną kolumnę IBAN z menu arkusza i otrzymaj osobny raport z czasem sprawdzenia, statusem weryfikacji, nazwą banku i BIC. Pobierz szablon, zapisz token API i uruchamiaj sprawdzanie wtedy, gdy go potrzebujesz.

Pobierz pakiet startowy Arkuszy Google

Plik ZIP zawiera Code.gs, manifest Apps Script, instrukcje konfiguracji i testy lokalne. Nie wymaga bibliotek, wdrożenia ani dodatków do arkusza. Potrzebujesz konta Google z prawem edycji oraz tokena API IBAN-Test.

Pobierz pakiet startowy (ZIP)

Apps Script · Przewodnik konfiguracji · Testowanie offline

Stan testów: Pobrany plik przechodzi 46 lokalnych testów Node.js z symulowanymi usługami Apps Script. Sprawdzane jest czyszczenie duplikatów, granice, obsługa odpowiedzi, przechowywanie tokenów, przerwane zapisy i maskowanie formuł. Nie przeprowadzono żadnych testów na prawdziwym koncie Arkuszy Google ani przy użyciu uwierzytelnionego interfejsu API. Przed użyciem danych operacyjnych zacznij od małej tabeli testowej.

Co sprawdza ta tabela

API sprawdza format IBAN i sumę kontrolną oraz uzupełnia dostępne dane w katalogu bankowym. Prawidłowy wynik nie potwierdza własności konta, jego istnienia, możliwości realizacji płatności ani dostępnych środków. Aktualny zakres badań opisano w dokumentacja API IBAN-Test.

Szablon wykorzystuje jawne polecenie menu pod adresem IBAN-Test. Edycja komórki nie powoduje wygenerowania płatnego żądania. Każdy karnet akceptuje ciągły zakres kolumn składający się z maksymalnie 500 wierszy i maksymalnie 10 różnych, niepustych numerów IBAN. Są to limity szablonu, a nie Twój plan konta.

W przypadku zapytań i wykrywania duplikatów spacje są usuwane, a litery pisane wielkimi literami. Oryginalne komórki pozostają niezmienione. Powtarzające się numery IBAN udostępniają zapytanie w ramach jednego przebiegu, ale każda linia źródłowa pojawia się w raporcie. Puste komórki są pomijane; Nagłówki i formuły muszą zostać wykluczone z selekcji.

1. Zainstaluj szablon w arkuszu kalkulacyjnym

Na potrzeby pierwszego testu utwórz prywatny arkusz kalkulacyjny Google. Pobierz plik ZIP i rozpakuj go.
W Google Sheets otwórz Rozszerzenia → Apps Script. Zastąp domyślną zawartość Code.gs pobranym plikiem. Jeśli projekt zawiera już wymagane skrypty, użyj nowej tabeli do tej konfiguracji.
W Apps Script otwórz Ustawienia projektu i włącz wyświetlanie pliku appsscript.json w edytorze. Wróć do edytora i zastąp ten plik dołączonym manifestem.
Zapisz projekt i ponownie załaduj arkusz kalkulacyjny. Funkcja onOpen skryptu dodaje menu IBAN-Test. Google wyjaśnia ten mechanizm w Przewodnik po menu niestandardowym.
Wybierz IBAN-Test → Save my API token (token API sklepu). Przejdź przez autoryzację Google dla bieżącej tabeli i żądań zewnętrznych; w razie potrzeby uruchom ponownie polecenie. Przed zezwoleniem na dostęp przejrzyj skrypt i poproś o uprawnienia. Zasady Workspace mogą wymagać pomocy administratora; patrz Dokumentacja autoryzacyjna Google.
Wklej token API z konta IBAN-Test w oknie dialogowym. Wpisz sam token, bez Bearer. Wpisywane znaki są widoczne: nie udostępniaj w tym czasie ekranu.

2. Wybierz i sprawdź numery IBAN

Wprowadź nagłówek, np. IBAN, w komórce A1. Sformatuj komórki wejściowe jako zwykły tekst i wprowadź poniżej numery IBAN. Do pierwszej demonstracji użyj udokumentowanego przykładu DE89370400440532013000, wariantu ze spacjami DE89 3704 0044 0532 0130 00 i celowo zmienioną sumą kontrolną, np. DE00370400440532013000.

Wybierz tylko wypełniony zakres wejściowy, np. A2:A4, a następnie IBAN-Test → Validate selected IBANs (sprawdź wybrane numery IBAN). Ten wybór zawiera dwie różne znormalizowane wartości, więc szablon próbuje wykonać dwa żądania. Nie zaznaczaj całej kolumny, nagłówków ani wielu oddzielnych sekcji. Nie edytuj wybranych komórek podczas przebiegu.

Gdy wszystkie zapytania zwrócą rozpoznane wyniki, skrypt tworzy nowy arkusz kalkulacyjny. Jego nazwa zaczyna się od IBAN check, po którym następuje znacznik czasu UTC i krótki identyfikator. Otwórz go i sprawdź znak COMPLETE w A1. Stare raporty pozostają historycznymi migawkami i nigdy nie są aktualizowane automatycznie.

3. Przeczytaj raport

Raport zawiera dziewięć kolumn: arkusz źródłowy, wiersz źródłowy, oryginalny IBAN, znormalizowany IBAN, status, kod API, nazwa banku, BIC i czas weryfikacji w formacie UTC. Puste pola bankowe oznaczają, że nie dostarczono żadnej wartości; nie unieważniają ważnego numeru IBAN.

Ten skrócony przykład pokazuje oczekiwane mapowanie stanu, gdy interfejs API udostępnia określone kody. Służy on celom ilustracyjnym i nie jest uwierzytelnionym testem na żywo:

Linia źródłowa	Wejście	Kod API	stan
2	DE89370400440532013000	2100	VALID
3	DE89 3704 0044 0532 0130 00	2100	VALID
4	DE00370400440532013000	3100	INVALID

Szablon akceptuje tylko VALID przy HTTP 200, kod 2100 i error: false. INVALID dotyczy wyłącznie kodów 3100, 3101 lub 3102 z error: true. Uwierzytelnianie, limity, błędy sieciowe i nieoczekiwane odpowiedzi zatrzymują proces. Zobacz udokumentowane kody wyników.

Zachowaj prywatność tokenów i danych tabeli

Twój token jest przechowywany we właściwościach skryptu bieżącego użytkownika, oddzielnie od komórek i kodu źródłowego. Każdy współtwórca musi zdeponować swój własny token. Google dokumentuje ten zakres pod adresem PropertiesService.

Właściwości użytkownika nie chronią przed złośliwymi zmianami skryptów. Edytorzy tabel mogą również edytować powiązany skrypt; zmodyfikowany kod może uzyskać dostęp do Twojego tokena przy następnym uruchomieniu. Używaj szablonu tylko z zaufanymi redaktorami lub w osobnej tabeli prywatnej. Google opisuje te relacje dostępu w Przewodnik po powiązanych skryptach.

Skrypt wysyła znormalizowane numery IBAN do IBAN-Test poprzez HTTPS. Raporty zawierają oryginalne numery IBAN i podlegają prawom dostępu do skoroszytu. Ogranicz udostępnianie i przechowuj raporty tylko tak długo, jak to konieczne. Remove my API token usuwa lokalnie przechowywany token; Dodatkowo unieważnij przejęty token na swoim koncie IBAN-Test.

Limity, błędy i ponowne próby

Nie ma automatycznych ponownych prób ani pamięci podręcznej podczas wielu przebiegów. W nowym przebiegu ponownie sprawdza się każdą inną wartość. Żądania zrealizowane przed wystąpieniem błędu mogły już wyczerpać limit. Skrypt używa Google URL Fetch ; obowiązują również limity i ograniczenia czasu wykonania Apps Script.

Błąd tokena lub dostępu: Przed ponownym uruchomieniem sprawdź stan tokena i konta.
Limit wykorzystania API lub częstotliwości żądań: Poczekaj, aż żądania będą ponownie dozwolone. Zwróć uwagę na określone interwały powtórzeń i nie klikaj w sposób ciągły poleceń menu.
Błąd sieci, serwera lub nieczytelna odpowiedź: Poczekaj i ponów mały wybór ręcznie. Należy zbadać trwałe błędy.
Brak menu lub odmowa dostępu: Zapisz skrypt, załaduj ponownie arkusze i sprawdź uprawnienia do edycji i ograniczenia przestrzeni roboczej.

Przerwana weryfikacja nie powoduje wygenerowania nowego, pełnego raportu. Przerwany zapis może spowodować pozostawienie niekompletnego arkusza kalkulacyjnego: wyrzuć go i nigdy nie używaj starszego raportu w celu zastąpienia nieudanego uruchomienia. Skrypt zabezpiecza przed nadpisywaniem danych wejściowych, jednoczesnym wykonywaniem skryptów oraz wstrzykiwaniem formuł w tekstach wyjściowych.