Google ID – числовой или строковый идентификатор, который используется для привязки аккаунта к API, OAuth-токенам и сервисам Google. Его нельзя получить через стандартный интерфейс Gmail, но он доступен в служебных ответах API и в данных авторизации. Для поиска по адресу электронной почты чаще всего применяют Google People API, Admin SDK или данные, возвращаемые при входе через OAuth 2.0.
Самый прямой способ – запрос к people.searchContacts или people.get с параметром email. В ответе в поле resourceName или metadata содержится уникальный идентификатор пользователя. Например, формат может выглядеть как people/12345678901234567890, где числовая часть и есть нужный Google ID. Для выполнения запроса требуется токен доступа с правами contacts.readonly или шире.
Для доменных аккаунтов Google Workspace быстрее использовать Admin SDK Directory API. Запрос вида GET https://admin.googleapis.com/admin/directory/v1/users/{email} возвращает объект пользователя, где поле id содержит Google ID. Такой метод работает только при наличии прав администратора домена и включённого доступа к API в панели управления.
При отсутствии админских прав можно получить Google ID через процесс авторизации стороннего сервиса. После входа через Google OAuth сервер получает ID Token, внутри которого поле sub содержит стабильный идентификатор пользователя. Этот вариант подходит для сайтов и приложений, где уже подключена авторизация через Google.
Практический совет: для точности всегда проверяйте соответствие email и найденного ID через вторичный запрос API. Это исключает ошибки при совпадении псевдонимов и дополнительных адресов, привязанных к одному аккаунту.
Поиск Google ID через консоль разработчика Google при входе в аккаунт
Откройте любую страницу Google, где выполняется авторизация, например https://myaccount.google.com, и войдите в нужный аккаунт. После входа откройте инструменты разработчика браузера клавишей F12 или комбинацией Ctrl+Shift+I, затем перейдите во вкладку Application (в Firefox – Storage).
В разделе Cookies выберите домен accounts.google.com или google.com. Найдите cookie с именем LSID, SID или APISID. Эти значения напрямую не являются Google ID, но используются для получения ID через сетевые запросы в момент авторизации.
Переключитесь во вкладку Network и обновите страницу. Отфильтруйте запросы по ключевым словам userinfo, people или oauth2. Откройте запрос к URL вида /oauth2/v3/userinfo или /v1/people/me. В ответе сервера в формате JSON найдите поле sub или resourceName.
Значение поля sub – это стабильный Google ID аккаунта. Пример формата: «sub»: «12345678901234567890». Для People API идентификатор находится в resourceName, например people/12345678901234567890, где числовая часть является нужным ID.
Для ускорения поиска нажмите Ctrl+F внутри панели ответа и введите «sub» или «resourceName». Этот способ работает в Chrome, Edge и Firefox без установки расширений и сторонних сервисов.
Получение идентификатора пользователя через Google People API по email
Для поиска Google ID через Google People API требуется проект в Google Cloud Console с включённым People API и созданные учётные данные OAuth 2.0. Нужна область доступа https://www.googleapis.com/auth/contacts.readonly или profile.
Порядок подключения API:
- Создать проект в Google Cloud Console
- Включить API People API в библиотеке API
- Настроить экран согласия OAuth и добавить нужные области доступа
- Создать OAuth Client ID и получить токен доступа
Для поиска по электронной почте используется метод запроса контактов:
GET https://people.googleapis.com/v1/people:searchContacts?query=email@example.com&readMask=names,emailAddresses
После выполнения запроса сервер возвращает JSON-ответ. Для получения Google ID следует извлечь данные из следующих полей:
- resourceName – содержит идентификатор в формате people/XXXXXXXXXXXX
- metadata.sources.id – внутренний ID источника профиля
- emailAddresses.value – адрес, по которому был выполнен поиск
Числовая часть строки resourceName и есть Google ID. Пример обработки ответа:
- Найти объект persons[]
- Открыть поле resourceName
- Скопировать значение без префикса people/
Практические ограничения:
- Метод работает только для контактов, сохранённых в адресной книге аккаунта
- Чужие аккаунты без добавления в контакты не возвращаются в результатах
- Для доменных пользователей лучше применять Directory API
Использование Google Workspace Admin SDK для поиска User ID по почте
Метод подходит только для доменов Google Workspace. Требуются права администратора и включённый доступ к Admin SDK API в панели управления домена. Запрос выполняется от имени администратора или сервисного аккаунта с делегированием прав.
Перед выполнением запросов необходимо:
Включить Admin SDK API в Google Cloud Console и создать сервисный аккаунт.
Выдать полномочия в разделе Security → API controls → Domain-wide delegation с областью доступа https://www.googleapis.com/auth/admin.directory.user.readonly.
Для поиска используется запрос к Directory API по точному email:
GET https://admin.googleapis.com/admin/directory/v1/users/user@domain.com
Ответ возвращается в формате JSON. Google ID находится в поле id. Пример структуры:
«id»: «109876543210987654321»
Дополнительные поля для проверки соответствия аккаунта:
primaryEmail – основной email пользователя.
aliases – дополнительные адреса, привязанные к аккаунту.
Практические нюансы:
Запрос работает только для пользователей внутри домена.
Для внешних адресов возвращается ошибка 404 not found.
Для быстрого тестирования удобно использовать Google APIs Explorer с предварительной авторизацией под администратором.
Просмотр Google ID через токен доступа OAuth 2.0
Для получения Google ID используется не сам access token, а ID Token, возвращаемый при авторизации через OAuth 2.0 с типом ответа id_token или гибридным потоком. В настройках клиента указывают области доступа openid и email.
Типовой запрос авторизации:
https://accounts.google.com/o/oauth2/v2/auth?response_type=id_token&client_id=CLIENT_ID&scope=openid%20email&redirect_uri=REDIRECT_URI&nonce=RANDOM
После подтверждения входа сервер возвращает ID Token в формате JWT. Токен состоит из трёх частей: заголовок, полезная нагрузка и подпись. Для просмотра содержимого достаточно декодировать вторую часть в Base64.
Идентификатор пользователя находится в поле sub. Это стабильный Google ID, который не меняется при смене пароля или имени профиля.
| Поле | Назначение |
|---|---|
| sub | Уникальный Google ID пользователя |
| Адрес электронной почты аккаунта | |
| iss | Адрес сервера-издателя токена |
| aud | Идентификатор клиента приложения |
Практические рекомендации:
Проверять подпись токена через публичные ключи Google перед использованием значения sub.
Сопоставлять поле email с исходным адресом для исключения ошибок.
Хранить полученный Google ID отдельно от access token, так как срок действия у них разный.
Определение Google ID через ответ сервера при авторизации стороннего сервиса
При входе через «Войти с Google» сторонний сервис получает от Google код авторизации, который сервер приложения обменивает на токены через endpoint https://oauth2.googleapis.com/token. В ответе присутствует id_token, содержащий стабильный идентификатор пользователя.
Алгоритм получения Google ID на стороне сервера:
Отправить POST-запрос с параметрами code, client_id, client_secret и redirect_uri.
Получить JSON-ответ с полями access_token, expires_in и id_token.
ID Token декодируется как JWT. Внутри полезной нагрузки расположены ключевые поля:
sub – уникальный Google ID пользователя.
email – подтверждённый адрес электронной почты.
email_verified – статус проверки адреса.
Для анализа ответа можно использовать встроенные средства сервера или временно логировать полезную нагрузку токена. Запрещается сохранять полный токен в логах – достаточно извлекать значение sub.
Практический контроль корректности:
Сверять поле aud с идентификатором своего приложения.
Проверять значение iss – допустимы только accounts.google.com или https://accounts.google.com.
Сопоставлять поле email с исходным адресом для исключения подмены данных.
Поиск ID через экспорт данных профиля в Google Takeout
Google Takeout позволяет выгрузить полные данные аккаунта, включая профиль, контакты и настройки. Для получения Google ID необходимо экспортировать раздел Контакты или Профиль.
Последовательность действий:
- Перейти на https://takeout.google.com/
- Выбрать только нужные сервисы: Contacts и Profile
- Настроить формат архива (ZIP или TGZ) и способ доставки
- Запустить экспорт и дождаться уведомления о готовности файла
В скачанном архиве находятся JSON-файлы с информацией о пользователе. Идентификатор Google ID обычно хранится в полях:
- resourceName – формат people/XXXXXXXXXXXX
- metadata.sources.id – внутренний идентификатор источника
Для точного определения ID откройте JSON через текстовый редактор или инструмент просмотра структурированных данных и найдите совпадение email с нужным адресом. Числовая часть resourceName и есть Google ID.
Рекомендации:
- Использовать поиск по ключу «resourceName» для ускорения обработки больших файлов
- Сохранять только необходимые разделы профиля, чтобы минимизировать объём данных
- Проверять совпадение email и ID перед использованием в API или сторонних сервисах
Типовые ошибки при поиске Google ID по email и способы их устранения
При поиске Google ID часто возникают ошибки, связанные с ограничениями API, особенностями учетных записей и форматом запросов. Ниже перечислены наиболее частые проблемы и методы их решения.
- Ошибка 404 при запросе к Directory API
- Причина: email принадлежит аккаунту вне домена Google Workspace или сервис не имеет прав администратора.
- Решение: использовать People API для контактов или авторизацию через OAuth 2.0 для внешних аккаунтов.
- Несовпадение email и полученного ID
- Причина: учетная запись имеет псевдонимы или несколько связанных адресов.
- Решение: проверять все поля aliases и emailAddresses, сопоставляя их с исходным адресом.
- ID не возвращается через People API
- Причина: email отсутствует в контактной базе или не был добавлен в адресную книгу.
- Решение: добавить адрес в контакты аккаунта или использовать альтернативные методы (OAuth, Takeout).
- Некорректный формат JSON-ответа
- Причина: неверный readMask или фильтр запроса.
- Решение: проверять правильность параметров запроса, использовать resourceName для извлечения ID.
- Просроченные или недействительные токены
- Причина: access token или ID token истёк или использован без проверки подписи.
- Решение: обновлять токен через OAuth refresh token и проверять подпись перед использованием sub.
Практический совет: вести лог действий при поиске ID и сверять результаты через несколько методов, чтобы исключить ошибки и подмену данных.
Вопрос-ответ:
Можно ли найти Google ID только по адресу электронной почты без доступа к аккаунту?
Нет, прямой доступ к Google ID без авторизации невозможен. Для внешних адресов доступны только методы через OAuth 2.0 или People API при добавлении адреса в контакты. Для доменных аккаунтов Google Workspace идентификатор можно получить через Admin SDK при наличии прав администратора.
Как извлечь Google ID из токена OAuth 2.0?
При авторизации через OAuth 2.0 сервер получает ID Token в формате JWT. Внутри полезной нагрузки есть поле sub, которое содержит стабильный Google ID пользователя. Для извлечения необходимо декодировать вторую часть JWT и использовать значение sub без изменения.
Можно ли использовать Google Takeout для поиска Google ID по email?
Да, при экспорте данных через Google Takeout можно выгрузить разделы Контакты или Профиль. В JSON-файлах есть поле resourceName формата people/XXXXXXXXXXXX, где числовая часть соответствует Google ID. Для точного поиска нужно сопоставить email и resourceName.
Почему People API не возвращает ID для некоторых адресов?
People API возвращает идентификаторы только для контактов, сохранённых в аккаунте, или для email, доступных через авторизацию. Если адрес не добавлен в контакты, API не вернёт ID. Для внешних пользователей остаётся вариант авторизации через OAuth или использование Admin SDK для доменных аккаунтов.
Какие ошибки чаще всего встречаются при поиске Google ID и как их избежать?
Типовые ошибки включают: 404 при запросе к Directory API для внешнего email, несовпадение email с найденным ID из-за псевдонимов, отсутствие ID в People API, некорректный формат JSON, просроченные токены. Чтобы избежать ошибок, проверяйте права доступа, используйте правильные методы для типа аккаунта, сверяйте email с полями ответа и обновляйте токены перед использованием.
Можно ли найти Google ID по чужому адресу электронной почты без доступа к аккаунту?
Прямого способа получить Google ID чужого аккаунта нет. Для внешних адресов доступ возможен только через OAuth 2.0 при авторизации пользователя на стороннем сервисе или если адрес добавлен в контакты вашего аккаунта и используется People API. Для доменных пользователей Google Workspace ID можно получить через Admin SDK при наличии прав администратора.
Как определить Google ID через токен OAuth 2.0 и что делать, если токен недействителен?
Google ID содержится в поле sub внутри ID Token, полученного при авторизации OAuth 2.0. Токен декодируется как JWT, и его полезная нагрузка содержит идентификатор, email и другие данные. Если токен просрочен или недействителен, его необходимо обновить через refresh token или повторно пройти процесс авторизации, чтобы получить новый ID Token с корректным значением sub.
Загрузка...
