API-Schlüssel verwenden

Hinweis

Damit Sie das Places SDK for Android verwenden können, benötigen Sie ein Projekt mit einem Rechnungskonto. Außerdem muss das Places SDK for Android aktiviert sein. Weitere Informationen finden Sie unter Google Cloud-Projekt einrichten.

API-Schlüssel erstellen

Der API-Schlüssel ist eine eindeutige ID. Damit werden die mit Ihrem Projekt verknüpften Anfragen zu Nutzungs- und Abrechnungszwecken authentifiziert. Mit Ihrem Projekt muss mindestens ein API-Schlüssel verknüpft sein.

So erstellen Sie einen API-Schlüssel:

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

API-Schlüssel einschränken

Google empfiehlt dringend, die API-Schlüssel einzuschränken, indem Sie ihre Nutzung auf die APIs beschränken, die für Ihre App erforderlich sind. Wenn Sie Ihre API-Schlüssel einschränken, wird Ihre App sicherer und es wird dafür gesorgt, dass nur autorisierte Anfragen gesendet werden. Weitere Informationen finden Sie unter Best Practices für die API-Sicherheit.

Wenn Sie die Nutzung des API-Schlüssels einschränken, müssen Sie den SHA-1-Zertifikat-Fingerabdruck des Signaturschlüssels angeben, mit dem die App signiert wurde. Es gibt zwei Arten von Zertifikaten:

• Debug-Zertifikat: Verwenden Sie diese Art von Zertifikat nur mit Apps, die Sie testen, und mit Code, der nicht für die Produktionsumgebung bestimmt ist. Veröffentlichen Sie keine Apps, die mit einem Debug-Zertifikat signiert sind. Es wird von den Android SDK-Tools automatisch generiert, wenn Sie einen Debug-Build ausführen.
• Release-Zertifikat: Verwenden Sie diese Art von Zertifikat, wenn Ihre App fertig für die Veröffentlichung im App-Shop ist. Es wird von den Android SDK-Tools generiert, wenn Sie einen Release-Build ausführen.

Weitere Informationen zum Signieren von Android-Apps und zu Zertifikaten

Die folgenden Referenzen enthalten eine Anleitung dazu, wie Sie Ihren Signaturzertifikat-Fingerabdruck finden:

• Wenn Sie die Funktion App-Signatur von Google Play verwenden, lesen Sie den Abschnitt Working with API Providers.
• Falls Sie Ihren eigenen Signaturschlüssel verwalten, lesen Sie den Abschnitt Anwendung selbst signieren oder folgen Sie der Anleitung für Ihre Build-Umgebung.

So schränken Sie einen API-Schlüssel ein:

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

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

gcloud alpha services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=places.googleapis.com
    --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"

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

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

gcloud alpha services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=places-backend.googleapis.com
    --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"

Nächste Schritte

Da Sie nun einen API-Schlüssel haben, können Sie ein Projekt erstellen und konfigurieren, wie unter Android Studio-Projekt einrichten beschrieben.