Как отправлять письма через API Gmail в WordPress: практическое руководство

Автор: Валерия Фролова | Опубликовано: 19.03.2026

Отправка писем из WordPress через стандартную функцию wp_mail() часто вызывает проблемы с доставкой и спам-фильтрами. Решением может стать отправка почты через официальный API Gmail, который обеспечивает надежную доставку и высокую скорость.

Почему стоит использовать API Gmail для отправки писем с WordPress

SMTP-серверы Gmail имеют ограничения по отправке писем и требуют сложной настройки. В отличие от SMTP, API Gmail позволяет безопасно отправлять почту напрямую через авторизацию OAuth 2.0, что повышает безопасность и надежность.

Преимущества использования API Gmail:

Отсутствие необходимости хранить пароль в коде или базе данных.
Высокая скорость обработки писем.
Поддержка разных форматов писем (текст, HTML, вложения).
Удобная интеграция с современными библиотеками Google API.

Настройка проекта в Google Cloud Console

Для работы с API Gmail нужно создать проект в Google Cloud Console, включить API Gmail и получить учетные данные OAuth 2.0.

Создайте новый проект или выберите существующий.
Перейдите в раздел API и сервисы и включите Gmail API.
В разделе Учетные данные создайте OAuth-клиент для типа приложения "Веб-приложение".
Укажите URL-адреса перенаправления (redirect URI) для авторизации, например, https://ваш-сайт.ru/oauth2callback/.
Сохраните Client ID и Client Secret.

Далее необходимо реализовать в WordPress получение и обновление токенов доступа.

Пример реализации отправки письма через API Gmail в WordPress

Для работы используем библиотеку Google API Client для PHP. Её можно установить через Composer или вручную загрузить в папку плагина.

require_once 'vendor/autoload.php';
unction wpmail_send_gmail_api($to, $subject, $body_html, $body_text = '') {
    $client = new Google_Client();
    $client->setClientId('ВАШ_CLIENT_ID');
    $client->setClientSecret('ВАШ_CLIENT_SECRET');
    $client->setRedirectUri('https://ваш-сайт.ru/oauth2callback/');
    $client->addScope(Google_Service_Gmail::GMAIL_SEND);

    // Загрузить сохраненный токен из базы данных или файла
    $accessToken = get_option('wpmail_gmail_access_token');
    if (!$accessToken) {
        // Нужно пройти OAuth процесс авторизации вручную один раз
        return new WP_Error('auth_required', 'Требуется авторизация через OAuth');
    }
    $client->setAccessToken($accessToken);

    if ($client->isAccessTokenExpired()) {
        $refreshToken = $client->getRefreshToken();
        if ($refreshToken) {
            $client->fetchAccessTokenWithRefreshToken($refreshToken);
            update_option('wpmail_gmail_access_token', $client->getAccessToken());
        } else {
            return new WP_Error('token_expired', 'Токен доступа истек, требуется повторная авторизация');
        }
    }

    $service = new Google_Service_Gmail($client);

    // Формируем MIME сообщение
    $rawMessageString = "From: Ваше Имя <ваш-email@gmail.com>\r\n" .
                        "To: $to\r\n" .
                        "Subject: $subject\r\n" .
                        "Content-Type: text/html; charset=UTF-8\r\n\r\n" .
                        $body_html;

    $rawMessage = base64_encode($rawMessageString);
    $rawMessage = str_replace(['+', '/', '='], ['-', '_', ''], $rawMessage); // URL-safe base64

    $message = new Google_Service_Gmail_Message();
    $message->setRaw($rawMessage);

    try {
        $result = $service->users_messages->send('me', $message);
        return $result;
    } catch (Exception $e) {
        return new WP_Error('gmail_send_error', $e->getMessage());
    }
}

В этом примере функция wpmail_send_gmail_api принимает адрес получателя, тему и тело письма в HTML. Она проверяет и обновляет токен доступа, формирует MIME-сообщение и отправляет его через API Gmail.

Обработка OAuth авторизации

Чтобы получить токены, нужно реализовать обработчик перенаправления OAuth, который сохранит токен в базе данных WordPress. Обычно для этого создают отдельный endpoint или страницу с обработчиком.

function wpmail_handle_oauth_callback() {
    if (!isset($_GET['code'])) return;

    $client = new Google_Client();
    $client->setClientId('ВАШ_CLIENT_ID');
    $client->setClientSecret('ВАШ_CLIENT_SECRET');
    $client->setRedirectUri('https://ваш-сайт.ru/oauth2callback/');

    $token = $client->fetchAccessTokenWithAuthCode($_GET['code']);

    if (isset($token['access_token'])) {
        update_option('wpmail_gmail_access_token', $token);
        wp_redirect(home_url());
        exit;
    } else {
        wp_die('Ошибка получения токена');
    }
}
add_action('init', 'wpmail_handle_oauth_callback');

Дополнительные советы по интеграции API Gmail в WordPress

1. Безопасность токенов: храните токены доступа и обновления в защищенном месте, лучше использовать шифрование или защищенные опции WordPress.

2. Обработка ошибок: всегда проверяйте ошибки API и корректно обрабатывайте случаи истечения токенов и отказов в отправке.

3. Логирование: ведите журнал отправленных писем и ошибок для отладки и мониторинга.

Плагины для упрощения работы с API Gmail

Если не хочется писать код с нуля, можно использовать готовые решения:

Clearfy Pro — позволяет оптимизировать и настроить отправку писем, есть расширенные функции интеграции.
WPRemark — плагин для кастомизации уведомлений и интеграции с почтовыми сервисами.

Выводы

Интеграция отправки писем через API Gmail в WordPress — это надежный и современный способ решить проблемы с доставкой и безопасностью почты. Хоть настройка требует первоначальных усилий и понимания работы OAuth, результат стоит потраченного времени.

Реализуйте авторизацию OAuth, храните и обновляйте токены грамотно, используйте примеры кода и готовые плагины для упрощения задач.