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

Обзор

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

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

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

  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 из одного и того же облачного проекта, например, для разделения трафика для каждой службы Maps Platform или для разделения трафика с разных платформ (браузер, мобильное приложение и т. д.). Ознакомьтесь с руководством по безопасности для получения рекомендаций по управлению ключами API.

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

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

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

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

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

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

Убедитесь, что у вас есть ожидаемые настройки квот в вашем Cloud Project. Это нужно сделать только в том случае, если вы вызываете клиентские службы 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.Высота.Javascript

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

API высоты

google.places.Геокодирование.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. Удалите только параметр подписи из ваших запросов API.

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

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

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

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

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

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

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

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

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

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

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

ApiNotActivatedMapError или ошибка REQUEST_DENIED

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

Ошибка RefererNotAllowedMapError

Вы увидите ошибку RefererNotAllowedMapError, если ваш исходный домен не добавлен в ваш ключ API. Проверьте раздел «Защитите свой ключ 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"
}