Получение API-ключа

Выберите платформу: Android iOS JavaScript

Теперь, когда вы настроили биллинг и проект , включили SDK и установили нужный вам менеджер зависимостей и другое программное обеспечение , вы готовы создать, добавить и ограничить свой ключ API.

Создание API-ключей

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

Чтобы создать ключ API:

Консоль

1. Перейдите на страницу «Платформа Google Карт» > «Учетные данные» .

   Перейти на страницу «Учетные данные»

2. На странице «Учетные данные» нажмите Создать учетные данные > Ключ API .
   В диалоговом окне создания ключа API отобразится ваш недавно созданный ключ API.
3. Нажмите «Закрыть».
   Новый ключ API указан на странице «Учетные данные» в разделе «Ключи API» .
   (Не забудьте ограничить ключ API перед его использованием в производстве.)

Облачный SDK

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Узнайте больше о Google Cloud SDK , установке Cloud SDK и следующих командах:

• gcloud services api-keys create

Этот ключ API вам понадобится при создании проекта Xcode, как описано в разделе Настройка проекта Xcode .

Примечание: вы можете использовать один и тот же ключ API для приложений Maps SDK для iOS и Places SDK для iOS .

Ограничение ключей API

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

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

Чтобы ограничить ключ API:

Консоль

1. Перейдите на страницу «Платформа Google Карт» > «Учетные данные» .

   Перейти на страницу «Учетные данные»

2. Выберите ключ API, для которого вы хотите установить ограничение. Откроется страница свойств ключа API.
3. В разделе «Ограничения ключа» установите следующие ограничения:
• Ограничения по применению:
1. Выберите приложения iOS .
2. Чтобы принимать запросы от приложения iOS с предоставленным вами идентификатором пакета, выберите соответствующий идентификатор пакета iOS из списка.
• Ограничения API:
1. Нажмите Ограничить ключ .
2. В раскрывающемся списке «Выбрать API» выберите Maps SDK для iOS . Если Maps SDK для iOS отсутствует в списке, его необходимо включить .
4. Чтобы завершить изменения, нажмите кнопку Сохранить .
   

Облачный SDK

Перечислите существующие ключи.

gcloud services api-keys list --project="PROJECT"

Снимите существующие ограничения для существующего ключа.

gcloud services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

Установите новые ограничения для существующего ключа.

gcloud services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=maps-ios-backend.googleapis.com
    --allowed-bundle-ids="BUNDLE_NAME"

Узнайте больше о Google Cloud SDK , установке Cloud SDK и следующих командах:

• gcloud services api-keys update
• gcloud services api-keys lookup
• gcloud services api-keys list

Теперь, когда вы получили ключ API для Maps SDK для iOS, вы готовы приступить к работе .

Что дальше?

Теперь, когда у вас есть ключ API, создайте и настройте свой проект Xcode, как описано в разделе Настройка проекта Xcode .