Co to jest błąd resourceName

Błąd „resourceName" pojawia się w Dzienniku operacji eM Client podczas próby synchronizacji kontaktów z Google Contacts. Typowy komunikat może wyglądać tak: „Error synchronizing contacts: Invalid resourceName" lub „Google Contacts: resourceName field is required".

Błąd ten nie jest związany z błędem użytkownika — nie wynika z pomyłki w haśle czy ustawieniach serwera. Jest to problem techniczny związany ze zmianą API po stronie Google, która wprowadza nowy format identyfikatorów kontaktów.

Ważne: błąd resourceName nie powoduje utraty kontaktów. Twoje kontakty są bezpieczne na serwerach Google. Problem dotyczy jedynie procesu synchronizacji między eM Client a Google.

Przyczyna: zmiana API Google

Google przez lata udostępniał synchronizację kontaktów przez stare Google Contacts API v2/v3, w którym każdy kontakt był identyfikowany za pomocą numerycznego ID (np. 1234567890).

Google zastąpiło to stare API nowym Google People API, w którym kontakty są identyfikowane za pomocą tzw. resourceName — ciągu znaków w formacie people/c1234567890 (z prefiksem „people/" i literą „c" przed numerem).

Stare Contacts API Google zostało oficjalnie wycofane w 2021 roku. Aplikacje, które nadal używały starego formatu identyfikatorów, zaczęły otrzymywać błędy synchronizacji. eM Client musiał zaktualizować swój kod, aby obsługiwać nowy format resourceName z People API.

Jeśli widzisz błąd resourceName, oznacza to, że korzystasz ze zbyt starej wersji eM Client, która nie została jeszcze zaktualizowana do obsługi nowego People API.

Aktualizacja eM Client do nowej wersji

Głównym rozwiązaniem problemu z resourceName jest aktualizacja eM Client do najnowszej wersji:

1. Przejdź do Menu > Pomoc > Sprawdź aktualizacje
2. Jeśli jest dostępna aktualizacja, pobierz i zainstaluj ją
3. Uruchom ponownie eM Client po aktualizacji
4. Sprawdź, czy synchronizacja kontaktów Google działa poprawnie

eM Client w wersji 8.2 i nowszej powinien obsługiwać nowe Google People API. Jeśli używasz starszej wersji (np. 7.x lub wcześniejszej 8.x), aktualizacja do 8.2+ powinna rozwiązać problem.

Przed aktualizacją warto wykonać kopię zapasową danych przez Menu > Plik > Kopia zapasowa — to dobra praktyka przed każdą dużą aktualizacją.

Ponowna autoryzacja konta Google

Nawet po aktualizacji może być konieczna ponowna autoryzacja OAuth konta Google:

1. Przejdź do Menu > Narzędzia > Konta
2. Wybierz konto Google z problemem
3. Kliknij przycisk Autoryzuj ponownie lub Zaloguj ponownie
4. Zaloguj się do konta Google w oknie, które się otworzy
5. Udziel eM Client żądanych uprawnień (w tym dostępu do kontaktów)
6. Zamknij okno i poczekaj na synchronizację

Ponowna autoryzacja jest ważna, ponieważ token OAuth wydany dla starego API może nie mieć uprawnień do nowego People API. Nowy token uzyskany po ponownej autoryzacji będzie zawierał odpowiednie uprawnienia.

Ręczna rekonfiguracja konta

Jeśli ponowna autoryzacja nie wystarczy, spróbuj usunąć i ponownie dodać konto Google:

1. Zanotuj ustawienia konta (adres email)
2. W Menu > Narzędzia > Konta zaznacz konto Google i kliknij Usuń
3. Potwierdź usunięcie (wiadomości IMAP są bezpieczne na serwerze)
4. Kliknij + Dodaj konto i wybierz Google/Gmail
5. Zaloguj się do konta Google
6. Udziel wszystkich wymaganych uprawnień, w tym dostępu do kontaktów
7. Poczekaj na pełną synchronizację

To podejście wyczyści wszelkie stare tokeny i konfiguracje i zaczyna od czystego stanu. Jest to najskuteczniejsze rozwiązanie przy głębokich problemach z synchronizacją Google.

Weryfikacja synchronizacji po naprawie

Po zastosowaniu poprawki sprawdź, czy synchronizacja działa poprawnie:

1. Otwórz Dziennik operacji (Ctrl+Shift+O)
2. Wymusz synchronizację klikając prawym przyciskiem na konto i wybierając Synchronizuj teraz
3. Obserwuj wpisy w dzienniku — nie powinny pojawiać się błędy związane z resourceName
4. Sprawdź w module Kontakty, czy kontakty Google są widoczne i aktualne
5. Dla pewności dodaj lub edytuj kontakt na google.com i sprawdź, czy zmiana zsynchronizowała się z eM Client

Jeśli synchronizacja działa w obu kierunkach (dodanie kontaktu w eM Client pojawia się na google.com i vice versa), problem jest rozwiązany.

Najczęstsze pytania

Co oznacza błąd „resourceName" przy synchronizacji Google Contacts?

Błąd resourceName wskazuje na niezgodność z nowym Google People API. Google zastąpiło stare Contacts API nowym, które używa innego formatu identyfikatorów. Starsze wersje eM Client mogą nie obsługiwać nowego formatu.

Jak naprawić błąd synchronizacji Google Contacts w eM Client?

Zaktualizuj eM Client do najnowszej wersji (min. 8.2). Możesz też usunąć i ponownie dodać konto Google, co wymusi nową autoryzację OAuth.

Czy błąd resourceName powoduje utratę kontaktów?

Nie. Kontakty są bezpiecznie przechowywane na serwerach Google. Błąd dotyczy procesu synchronizacji, nie danych.

Która wersja eM Client obsługuje nowe Google People API?

eM Client w wersji 8.2 i nowszych obsługuje Google People API. Zaktualizuj aplikację do najnowszej wersji.