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

Обзор

В целях повышения безопасности и надежности аутентификации идентификаторы клиентов платформы Карт устарели с 26 мая 2025 года и не могут быть использованы после 31 мая 2026 года.

Вместо идентификатора клиента для аутентификации трафика сервиса API Google Карт необходимо использовать учётные данные API Key. В этом руководстве показано, как перейти от использования идентификаторов клиента к использованию API Key.

Чтобы начать, выполните следующие шаги:

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

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

Перед началом процесса миграции перечислите следующее:

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

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

В Cloud Console вы можете проверить последний статус использования вашего Client ID на странице показателей Google Maps.

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

  1. Откройте страницу «Метрики» в Cloud Console.
  2. Отфильтруйте свое использование с помощью следующих настроек:
    • Учетные данные: выберите только «project_number:<числовой идентификатор>».
  3. Установите следующий фильтр.
    • Сгруппировано по: API

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

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

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

Подготовить ключи API

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

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

Защитите свой ключ API

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

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

Более подробную информацию см. в руководстве по безопасности платформы Google Maps .

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

Просмотреть настройки квоты

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

Узнайте больше об отчетах по квотам

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

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

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

  1. Проверьте, используете ли вы клиентские службы Maps JavaScript API с идентификатором клиента.
    • Откройте страницу «Метрики» в Cloud Console.
    • Отфильтруйте свое использование с помощью следующих настроек:
      • Сгруппировано по: Методу API
      • Учетные данные: выберите только «project_number:<числовой идентификатор>».
    • Затем вы увидите список названий методов и их трафик на диаграмме «Трафик по методам API».

Метод API

Обслуживание на стороне клиента

Услуга по корректировке квоты

google.routes.Directions.Javascript

Служба маршрутов

API маршрутов

google.routes.DistanceMatrix.Javascript

Служба дистанционных матриц

API матрицы расстояний

google.maps.Elevation.Javascript

Служба подъема

API высоты

google.places.Geocoding.Javascript

Служба геокодирования

API геокодирования

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

Библиотека мест

API мест

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

Обновите свой код

Заменить клиентский параметр ключевым параметром

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

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

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

Более подробную информацию см. в отчетах платформы Google Maps .

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

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

  • API маршрутов (устаревший)
  • API матрицы расстояний (устаревший)
  • API геокодирования
  • API высоты
  • API часового пояса

Более подробную информацию смотрите в обзоре премиум-плана .

Секрет подписи для API изображений

Статические API Карт и Статические API Просмотра улиц по-прежнему требуют параметр подписи. Они принимают небольшое количество запросов без подписи для тестирования, но начинают выдавать ошибки, как только это количество достигает порогового значения в вашей рабочей среде. Замените секрет подписи с идентификатора клиента на ключ API. Вы можете использовать тот же алгоритм подписи, но вам потребуется другой секрет подписи. Подробнее см. в разделе Использование цифровой подписи .

Контролируйте трафик вашего клиентского идентификатора

После развертывания убедитесь, что ваш трафик успешно перенесён, используя панели управления Cloud Console . Вы заметите снижение трафика по идентификатору клиента, которое отображается в формате «номер_проекта:123456» на панели управления при группировке по учётным данным.

Приостановите свой идентификатор клиента

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

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

Как мы можем узнать, отклонен ли наш запрос?

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

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"
}