Руководство по переносу идентификатора клиента

Обзор

Выполните следующие действия.

  1. Как проверить использование текущего идентификатора клиента
  2. Подготовка ключей API
  3. Как посмотреть настройки квот
  4. Как обновить код
  5. Как отслеживать трафик по идентификатору клиента
  6. Как приостановить действие идентификатора клиента
  7. Временная повторная активация идентификатора клиента

Как проверить использование текущего идентификатора клиента

Прежде чем начать процесс переноса, составьте список следующих элементов:

  • Сервисы Maps Platform, которые вы используете с идентификатором клиента.
  • Приложения, сайты или системы, в которых вы используете идентификатор клиента.

В мае 2025 года Google отправила затронутым клиентам уведомление по электронной почте о прекращении поддержки идентификатора клиента. Эта информация также есть в уведомлении по электронной почте.

В Cloud Console можно проверить текущий статус использования идентификатора клиента на странице показателей Google Карт.

Список сервисов платформы Google Карт

  1. Откройте страницу Показатели в Cloud Console.
  2. Отфильтруйте данные об использовании, задав следующие настройки:
    • Учетные данные: выберите только "project_number:<числовой идентификатор>".
  3. Задайте следующий фильтр:
    • Основание группировки: API

Для подсказок приложений, сайтов или систем:

В Cloud Console не показываются сведения о ваших приложениях, сайтах или системах. Однако вы можете найти подсказки об источниках трафика с идентификатором клиента. Для этого выполните следующие действия:

  1. Откройте страницу Показатели в Cloud Console.
  2. Выберите сервис платформы Maps в раскрывающемся списке.
  3. Отфильтруйте данные об использовании с помощью следующих настроек:
    • Учетные данные: выберите только "project_number:<числовой идентификатор>".
  4. Задайте следующий фильтр:
    • Группировка по платформе или домену
  5. Повторите шаг 2 для каждого сервиса платформы Google Карт, для которого нужно проверить трафик.

Подготовка ключей API

Все идентификаторы клиентов связаны с проектом Google Cloud, и использование ключа API из этого проекта предоставит вам доступ к тем же функциям, к которым вы ранее обращались с помощью идентификатора клиента. Рекомендуем перейти на связанный проект, чтобы избежать проблем с квотами или отсутствующими функциями.

  1. Найдите облачный проект, с которым связан ваш идентификатор клиента:
  2. Убедитесь, что ваш облачный проект связан с активным платежным аккаунтом.
  3. Создайте новый ключ API для переноса идентификатора клиента.
    • Вы можете повторно использовать любые существующие ключи API в облачном проекте.
    • Вы можете использовать несколько ключей API из одного облачного проекта, например чтобы разделить трафик для каждого сервиса платформы Google Карт или для разных платформ (браузера, мобильного приложения и т. д.). Рекомендации по управлению ключами API приведены в руководстве по безопасности.

Защитите ключ API

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

  • Задайте ограничение по типу приложений для ключа API (например, сайты, IP-адреса, приложения для Android или приложения iOS).
  • Настройте ограничения API для ключа API.

Подробную информацию можно найти в Рекомендациях платформы Google Карт по безопасности.

Для Maps JavaScript API, Maps Static API и Street View Static API можно перенести доверенные рефереры из идентификатора клиента в ограничения ключа API. Список доверенных источников перехода можно найти в Cloud Console.

Как проверить настройки квот

Убедитесь, что в вашем облачном проекте заданы нужные квоты. Это необходимо, только если вы вызываете клиентские сервисы Maps JavaScript API с помощью идентификатора клиента. Проверить и изменить настройки квот можно на странице квот Google Карт.

Подробнее об отчетах о квотах…

Увеличение квоты для клиентских сервисов Maps JavaScript API

Если вы используете следующие сервисы в Maps JavaScript API, после переноса ключа API вы увидите увеличение использования квоты.

Проверьте текущую конфигурацию квот и их использование и скорректируйте лимиты.

  1. Проверьте, используете ли вы клиентские сервисы Maps JavaScript API с идентификатором клиента.
    • Откройте страницу Metrics (Показатели) в Cloud Console.
    • Отфильтруйте данные об использовании, задав следующие настройки:
      • Группировка по методу API
      • Учетные данные: выберите только "project_number:<числовой идентификатор>".
    • После этого на диаграмме "Трафик по методу API" появится список названий методов и связанный с ними трафик.

Метод API

Клиентский сервис

Сервис для изменения квоты

google.routes.Directions.Javascript

Сервис Directions

Directions API

google.routes.DistanceMatrix.Javascript

Служба "Матрица расстояний"

Distance Matrix API

google.maps.Elevation.Javascript

Сервис Elevation

Elevation API

google.places.Geocoding.Javascript

Сервис Geocoding

Geocoding API

google.places.*.Javascript, кроме google.places.Geocoding.Javascript

Библиотека Places

Places API
  • Если вы не используете эти методы API, вам не нужно беспокоиться о настройках квоты, поскольку трафик вашего идентификатора клиента уже потребляет квоту проекта.
  • Как оценить расходование квоты идентификаторов клиентов
    • Для каждого сервиса проверьте детализацию "В секунду" и "В день".
    • График "В секунду": умножьте пиковый трафик на 60, чтобы получить дополнительную квоту в минуту.
    • График "В день". Пик трафика должен соответствовать дополнительной квоте в день.
  • Измените квоту для соответствующих сервисов платформы Google Карт.
    • На основе названия метода, найденного на шаге 1, измените квоту в соответствующих сервисах.

Как обновить код

Как заменить параметр клиента параметром ключа

Обновите учетные данные для аутентификации с URL&client={value} на URL&key={value} в исходящих вызовах GMP API. Если ваши приложения используют HTTP для доступа к сервисам Google Платформы для маркетинга, обновите их, чтобы они использовали HTTPS.

Обновите параметр канала для отчетов

Вы можете отслеживать использование по каналам, указав параметр channel в запросах к API. Ключи API поддерживают только числовые значения для параметра channel. Если вы используете идентификатор клиента с любыми нечисловыми значениями параметра channel, измените его на поддерживаемое числовое значение.

Подробнее об отчетах платформы Google Карт…

Удаление параметра подписи для веб-сервисов

Для следующих API веб-сервисов параметр подписи не требуется, если вы обращаетесь к ним с помощью ключа API. Удалите параметр подписи только из запросов к API.

  • Directions API (устаревший)
  • Distance Matrix API (устаревшая версия)
  • Geocoding API
  • Elevation API
  • Time Zone API

Подробные сведения приведены в статье Обзор тарифного плана Premium.

Секретный ключ подписи для Imagery API

Для Maps Static API и Просмотра улиц Static API по-прежнему требуется параметр signature. Они принимают небольшое количество запросов без подписи для тестирования, но начинают отклонять их, когда в рабочей версии превышается пороговое значение. Замените секрет для подписания, связанный с идентификатором клиента, на секрет для подписания, связанный с ключом API. Вы можете использовать тот же алгоритм подписи, но вам понадобится другой секретный ключ. Подробнее о том, как использовать цифровую подпись…

Как отслеживать трафик идентификатора клиента

После развертывания убедитесь, что трафик перенесен успешно, с помощью панелей управления Cloud Console. Трафик, связанный с вашим идентификатором клиента, начнет снижаться. На панели управления он представлен в формате project_number:123456 при группировке по учетным данным.

Как приостановить действие идентификатора клиента

Мы настоятельно рекомендуем разработчикам приостановить идентификаторы клиентов после переноса. Это необходимо, чтобы защитить ваши учетные данные от нежелательного трафика и убедиться, что оставшееся использование идентификатора клиента не является критичным (например, тестирование, кеширование, боты и т.д.) и может возвращать ошибки без ущерба для бизнеса. Вы можете приостановить работу идентификатора клиента в Cloud Console. Подробные сведения приведены в разделе Общая информация об аутентификации в тарифном плане Premium.

Самостоятельная временная повторная активация идентификатора клиента

В мае 2026 г. начался период прекращения поддержки идентификаторов клиентов платформы Google Карт, поэтому доступность сервисов больше не гарантируется. Доступ будет периодически ограничиваться в рамках запланированного процесса прекращения поддержки сервиса. Обычно доступ восстанавливается автоматически в течение нескольких часов, но вы можете повторно активировать его вручную, если требуется немедленное восстановление.

Чтобы срочно восстановить доступ, вы можете самостоятельно активировать подписку в консоли Google Cloud:

  • Откройте страницу учетных данных платформы Google Карт.
  • Найдите свой облачный проект, связанный с вашим идентификатором клиента.
  • Нажмите на значок возобновления работы, расположенный справа от записи, чтобы восстановить сервис.

Если вы не можете быстро перейти на ключи API и хотите временно избежать дальнейших перебоев, обратитесь в службу поддержки платформы Google Карт и предоставьте следующую информацию:

  • Идентификатор клиента
  • Конкретный пример использования
  • Целевая дата переноса
  • Оценка влияния на бизнес

Отчет об использовании идентификатора клиента (из отчетов о платежах)

Проверка отчетов об оплате вместо показателей проекта может быть полезна пользователям, у которых нет доступа к показателям проекта, например администраторам платежей (особенно партнерам платформы Google Карт). Хотя отчеты об оплате имеют задержку в 1–2 дня, они позволяют просматривать статистику использования и расходов за период более 30 дней.

Вы можете отслеживать использование идентификатора клиента в консоли Google Cloud, выполнив следующие действия:

  1. В консоли Google Cloud перейдите на страницу Billing > Reports (Оплата > Отчеты).
  2. (Необязательно, только для партнеров) Примените фильтр, чтобы выбрать нужный субплатежный аккаунт.
  3. Сгруппируйте данные отчета по ключу ярлыка goog-maps-api-key-suffix. На этом ярлыке показаны последние символы ключа API.
  4. Чтобы найти трафик с идентификатором клиента, ищите записи, в которых отсутствует или не заполнена метка goog-maps-api-key-suffix, поскольку она не добавляется в запросы с идентификатором клиента.
  5. Игнорируйте коды, которые не должны быть связаны с запросами к API, например коды подписок.

Устранение неполадок

Как узнать, выполняется ли запрос?

Статистику ошибок можно посмотреть на графиках кодов ответов.

ApiNotActivatedMapError или REQUEST_DENIED: ошибка

Вы увидите ошибку ApiNotActivatedMapError или REQUEST_DENIED, если не включили сервис в облачном проекте. Следуйте инструкциям, чтобы включить сервис.

RefererNotAllowedMapError ошибка

Если исходный домен не добавлен в ключ API, вы увидите ошибку RefererNotAllowedMapError. Ознакомьтесь с разделом "Защита ключа API" и добавьте свой домен в ключ API.

Ошибка OverQuotaMapError или OVER_QUERY_LIMIT

Значок OverQuotaMapError или OVER_QUERY_LIMIT появится, если настроенной квоты недостаточно для вашего трафика. Проверьте раздел "Проверка настроек квоты" и при необходимости измените квоту.

Ошибка "Запросы к этому API должны выполняться по протоколу SSL"

Если вы получили следующее сообщение об ошибке, обновите запросы к API, заменив "http://" на "https://".

{
  "error_message" : "Requests to this API must be over SSL. Load the API with
  \"https://\" instead of \"http://\".",

  "results" : [],

  "status" : "REQUEST_DENIED"
}