Как помочь пользователям плагина платформы Google Карт быстро начать работу

Окно успеха виджета

Если вы разрабатываете плагин платформы Google Maps для таких платформ, как WordPress, Shopify, Magento и других, в этом разделе описывается, как быстро подключить пользователей плагина к платформе Google Maps и сгенерировать ключ API.

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

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

Запустите виджет быстрого запуска

Виджет быстрого запуска — это просто веб-страница, размером окна которой вы можете управлять с помощью вызова JavaScript window.open . Например:

<script>
  function openPopupWindow() {
    var winWidth=570;
    var winHeight=700;
    var left = (screen.width-winWidth)/2;
    var top = (screen.height-winHeight)/2;

    window.open('https://console.cloud.google.com/google/maps-hosted', 'Quick Start Widget',
    'resizable=yes,width='+winWidth+',height='+winHeight+',left='+left+',top='+top);
      return false;
  }
</script>

<!-- CTA to generate Google Maps API Key -->
<button type="button" onClick="openPopupWindow()" style="color: white; background-color: #1a73e8" href="#">
    Get an API Key
</button>

Посмотрите это в действии:

Когда пользователь нажимает кнопку, виджет быстрого запуска открывается во всплывающем окне и выполняет следующие действия по мере перемещения пользователя по виджету:

  • Создает учетную запись Google и проект, если у пользователя их еще нет.
  • Включает API платформы Google Maps.
  • Генерирует ключ API, который пользователи могут скопировать и вставить в конфигурацию плагина.

Если у пользователя плагина уже есть учетная запись Google и проект, виджет перенаправит его на страницу «Учетные данные» в Google Cloud Console, где он сможет получить существующий ключ API или создать новый.

Вы можете указать пользователям вашего плагина на раздел «О виджете быстрого запуска» для получения дополнительной информации.

Часто задаваемые вопросы

Нужно ли мне платить за использование виджета быстрого запуска?

Нет. Виджет быстрого запуска бесплатен и доступен всем разработчикам, чтобы упростить подключение к платформе Google Maps.

Можно ли использовать виджет быстрого запуска только в WordPress и Shopify?

Виджет быстрого запуска можно использовать на любом стороннем веб-сайте, а не только в конструкторах веб-сайтов или сайтах электронной коммерции.

Может ли сторонняя платформа просматривать платежную информацию, которую вводит пользователь?

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

Могу ли я использовать существующий проект и ключ API?

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

Как пользователи плагинов защищают свои ключи API?

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