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

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

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

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

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

Виджет быстрого запуска — это просто веб-страница, размером окна которой можно управлять с помощью вызова 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 Карт.
• Генерирует ключ API, который пользователи могут скопировать и вставить в конфигурацию плагина.

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

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

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

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

Нет. Виджет быстрого старта бесплатен и доступен всем разработчикам для упрощения адаптации к платформе Google Карт.

Можно ли использовать виджет «Быстрый старт» только на WordPress и Shopify?

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

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

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

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

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

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

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