Как отправлять письма через Gmail в WordPress без SMTP

Автор: Алина Тарасова | Опубликовано: 04.01.2026

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

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

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

В этой статье мы подробно рассмотрим, как настроить отправку писем через Gmail API в WordPress без использования SMTP, с примерами кода, а также разберем возможные ошибки и способы их устранения.

Настройка проекта в Google Cloud и получение учетных данных для Gmail API

Первым шагом необходимо создать проект в Google Cloud Console и получить OAuth 2.0 учетные данные:

Перейдите в Google Cloud Console и создайте новый проект.
В разделе API и сервисы активируйте Gmail API.
В разделе «Учетные данные» создайте OAuth клиент типа "Веб-приложение".
Укажите URI перенаправления — для локальной разработки это может быть http://localhost, для рабочего сайта — URL вашего сайта с добавлением пути для обработки OAuth, например https://ваш-сайт.ru/oauth2callback.
Скачайте файл с учетными данными (credentials.json).

Эти учетные данные понадобятся для авторизации вашего WordPress-сайта при отправке писем через Gmail API.

Установка и настройка PHP-библиотеки Google API Client в WordPress

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

Если у вас есть доступ к серверу и установлен Composer, выполните команду composer require google/apiclient:^2.0 в корне сайта.
Если Composer не доступен, скачайте библиотеку с GitHub и подключите её вручную через require_once в functions.php.

Далее создадим функцию wpmail_send_gmail_api(), которая будет отправлять письмо через Gmail API.

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

function wpmail_send_gmail_api($to, $subject, $message) {
    require_once __DIR__ . '/vendor/autoload.php'; // путь к Google API Client

    $client = new Google_Client();
    $client->setApplicationName('WP Mail Gmail API');
    $client->setScopes(Google_Service_Gmail::GMAIL_SEND);
    $client->setAuthConfig(__DIR__ . '/credentials.json');
    $client->setAccessType('offline');

    // Здесь нужно реализовать получение и обновление токенов OAuth 2.0
    // Для упрощения примера предполагается, что токен сохранен в option
    $accessToken = get_option('wpmail_gmail_access_token');
    if ($accessToken) {
        $client->setAccessToken($accessToken);
    }

    if ($client->isAccessTokenExpired()) {
        // Обновление токена
        $refreshTokenSaved = $client->getRefreshToken();
        if ($refreshTokenSaved) {
            $client->fetchAccessTokenWithRefreshToken($refreshTokenSaved);
            update_option('wpmail_gmail_access_token', $client->getAccessToken());
        } else {
            // Нужно повторно авторизовать пользователя
            return new WP_Error('auth_error', 'Требуется повторная авторизация Gmail API');
        }
    }

    $gmail = new Google_Service_Gmail($client);

    $strRawMessage = "To: {$to}\r\n" .
                     "Subject: =?utf-8?B?" . base64_encode($subject) . "?=\r\n" .
                     "MIME-Version: 1.0\r\n" .
                     "Content-Type: text/html; charset=utf-8\r\n\r\n" .
                     $message;

    // Кодируем сообщение в формат base64url
    $mime = rtrim(strtr(base64_encode($strRawMessage), '+/', '-_'), '=');

    $msg = new Google_Service_Gmail_Message();
    $msg->setRaw($mime);

    try {
        $gmail->users_messages->send('me', $msg);
        return true;
    } catch (Exception $e) {
        return new WP_Error('send_error', $e->getMessage());
    }
}

Эта функция отправляет письмо с указанной темой и HTML-сообщением. Для работы нужно реализовать получение и обновление OAuth токенов — это отдельный процесс, который стоит автоматизировать на сайте.

Как реализовать OAuth 2.0 авторизацию для Gmail API в WordPress

Для полноценной работы с Gmail API необходимо получить и сохранить токены доступа. Процесс состоит из нескольких шагов:

Переадресация пользователя на страницу согласия Google для получения кода авторизации.
Обмен кода на access_token и refresh_token.
Сохранение токенов в базе WordPress (например, в опциях).
Автоматическое обновление access_token при его истечении с помощью refresh_token.

Пример функции для получения URL авторизации:

function wpmail_get_gmail_auth_url() {
    require_once __DIR__ . '/vendor/autoload.php';

    $client = new Google_Client();
    $client->setApplicationName('WP Mail Gmail API');
    $client->setScopes(Google_Service_Gmail::GMAIL_SEND);
    $client->setAuthConfig(__DIR__ . '/credentials.json');
    $client->setRedirectUri(site_url('/oauth2callback'));
    $client->setAccessType('offline');
    $client->setPrompt('consent');

    return $client->createAuthUrl();
}

После получения кода от Google в URL /oauth2callback нужно вызвать обмен кода на токены и сохранить их.

Обработка ошибок и отладка при отправке писем через Gmail API

При работе с Gmail API могут возникать ошибки:

401 Unauthorized — неверные или просроченные токены. Нужно обновить токен или повторно авторизовать приложение.
403 Forbidden — недостаточно прав для отправки письма. Проверьте настройки OAuth и права.
429 Rate Limit Exceeded — превышен лимит отправки. Google ограничивает количество писем в сутки.

Для отладки можно включить логирование ошибок PHP и отслеживать ответы API. В случае ошибок лучше всего выводить понятные сообщения и предлагать повторную авторизацию.

Заключение

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

Если вы хотите автоматизировать процесс или расширить функционал, обратите внимание на плагины и решения, которые упрощают работу с Gmail API, например, WPGPT для интеллектуальной настройки и расширения почтовой логики.