Opis problemu

Masz skonfigurowane konto Gmail w eM Client i przez długi czas kontakty z Google Contacts synchronizowały się prawidłowo. Pewnego dnia synchronizacja przestała działać:

• Nowe kontakty dodane w Google Contacts nie pojawiają się w eM Client
• Zmiany kontaktów w eM Client nie są synchronizowane z Google
• W dzienniku operacji widoczne są błędy synchronizacji kontaktów
• Komunikat błędu może zawierać frazy: „API deprecated", „resourceName", „410 Gone", „404 Not Found"
• Kontakty w eM Client są przestarzałe — nie odzwierciedlają aktualnego stanu Google Contacts

Problem dotyczy użytkowników starszych wersji eM Client (przed 8.2), którzy nie aktualizowali aplikacji od 2021 roku.

Wycofanie Contacts API v3 przez Google

Google przez wiele lat udostępniało dwa API do zarządzania kontaktami:

• Contacts API v3 — starsze API, używane przez wiele aplikacji od lat
• People API — nowe, bardziej rozbudowane API zastępujące Contacts API v3

Google ogłosiło deprecację (planowe wycofanie) Contacts API v3 i 15 czerwca 2021 roku całkowicie wyłączyło jego obsługę. Każda aplikacja, która próbuje korzystać z Contacts API v3 po tej dacie, otrzymuje błąd HTTP 410 (Gone) lub podobny komunikat o niedostępności API.

Starsze wersje eM Client (przed 8.2) używały właśnie Contacts API v3 do synchronizacji kontaktów Google. Po czerwcu 2021 roku synchronizacja w tych wersjach przestała działać i nie ma możliwości jej naprawienia bez aktualizacji eM Client, ponieważ stare API po prostu nie istnieje.

eM Client 8.2 (wydany w 2021 roku) zaktualizował obsługę kontaktów Google, migrując do nowego People API. Aktualizacja do tej wersji jest niezbędna.

Sprawdź wersję eM Client

Aby sprawdzić, której wersji eM Client używasz:

1. Otwórz eM Client
2. Przejdź do Menu → Pomoc → O eM Client (lub Help → About eM Client)
3. W oknie informacyjnym zobaczysz numer wersji

Jeśli numer wersji jest niższy niż 8.2 (np. 7.x, 8.0, 8.1), musisz zaktualizować eM Client, aby przywrócić synchronizację kontaktów Google.

Jeśli masz wersję 8.2 lub nowszą i synchronizacja nadal nie działa, problem może wynikać z potrzeby ponownej konfiguracji konta Google — patrz sekcja Rekonfiguracja poniżej.

Aktualizacja eM Client

Aby zaktualizować eM Client do najnowszej wersji:

1. Przejdź do Menu → Pomoc → Sprawdź aktualizacje
2. Jeśli dostępna jest aktualizacja, postępuj zgodnie z kreatorem, który pobierze i zainstaluje nową wersję
3. Ewentualnie pobierz najnowszą wersję bezpośrednio ze strony emclient.com
4. Zainstaluj pobraną wersję — aktualizacja zachowuje wszystkie dane, konta i ustawienia

Ważna uwaga dotycząca licencji: Aktualizacja z wersji 7.x do 8.x może wymagać nowej licencji. Licencje eM Client są zazwyczaj sprzedawane na konkretną wersję (np. licencja v7 nie obejmuje v8). Sprawdź warunki swojej licencji przed aktualizacją lub zakup nową licencję Pro.

Darmowa wersja eM Client (Free) obsługuje do 2 kont e-mail bez opłat — jeśli masz darmową wersję, aktualizacja jest bezpłatna.

Rekonfiguracja konta Google po aktualizacji

Nawet po aktualizacji do eM Client 8.2, jeśli konto Google było już skonfigurowane przed aktualizacją, może być konieczne ponowne dodanie konta, aby wymusić użycie nowego People API:

1. Przed usunięciem konta zrób kopię zapasową eM Client: Menu → Plik → Kopia zapasowa
2. Przejdź do Menu → Narzędzia → Konta
3. Wybierz konto Gmail/Google
4. Kliknij ikonę Usuń konto (minus)
5. Potwierdź usunięcie — wiadomości IMAP pozostaną na serwerze Google, nie zostaną utracone
6. Kliknij ikonę Dodaj konto (plus)
7. Wybierz Google / Gmail
8. Wprowadź adres e-mail i zaloguj się przez OAuth
9. eM Client skonfiguruje konto z nowym People API dla kontaktów

Po rekonfiguracji synchronizacja kontaktów powinna działać. Pierwsze pełne pobranie wszystkich kontaktów Google może chwilę zająć.

Synchronizacja ręczna i rozwiązywanie problemów

Jeśli po aktualizacji i rekonfiguracji synchronizacja nadal nie działa:

Wymuś synchronizację ręcznie

1. Kliknij prawym przyciskiem myszy na folder kontaktów Google w panelu bocznym
2. Wybierz Synchronizuj lub Odśwież
3. Poczekaj na zakończenie synchronizacji

Sprawdź dziennik operacji

1. Przejdź do Menu → Narzędzia → Dziennik operacji (Ctrl+Shift+O)
2. Poszukaj czerwonych komunikatów błędów związanych z kontaktami lub Google
3. Komunikaty błędów pomogą zidentyfikować dokładną przyczynę problemu

Sprawdź uprawnienia aplikacji w Google

1. Otwórz przeglądarkę i przejdź do myaccount.google.com → Bezpieczeństwo → Aplikacje z dostępem do konta
2. Sprawdź, czy eM Client ma dostęp do kontaktów Google (uprawnienie Contacts)
3. Jeśli nie, cofnij dostęp i ponownie autoryzuj eM Client

Podsumowanie

Google wyłączyło stare Contacts API v3 w czerwcu 2021 roku, co spowodowało przerwanie synchronizacji kontaktów Google w wersjach eM Client starszych niż 8.2. Jedynym rozwiązaniem jest aktualizacja eM Client do wersji 8.2 lub nowszej, która korzysta z nowego People API.

Po aktualizacji może być potrzebna rekonfiguracja konta Google: usuń konto z eM Client i dodaj je ponownie przez kreator Google/Gmail. Po ponownej konfiguracji synchronizacja kontaktów powinna działać prawidłowo.