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

Обзор

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Задайте ограничение по типу приложений для ключа API (например, сайты, IP-адреса, приложения для Android или приложения iOS).
  • Настройте ограничения для ключа 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, скорректируйте квоту для соответствующих сервисов.

Обновите код

Замените параметр client параметром key

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

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

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

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

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

Для перечисленных ниже API веб-сервисов параметр подписи не требуется, если вы обращаетесь к ним с помощью ключа API. Удалите параметр signature из запросов к 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. Игнорируйте SKU, которые не должны быть связаны с запросами к API, например SKU подписок.

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

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

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

Ошибка 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"
}