Erste Schritte

Auf dieser Seite werden die ersten Schritte zur Nutzung von Cloud APIs für Entwickler erläutert.

Wenn Sie Google Cloud APIs zum ersten Mal verwenden, folgen Sie den Schritten in dieser Anleitung, um die APIs mit curl-Befehlen aufzurufen. Mit curl-Befehlen können Sie vor der Entwicklung einer Anwendung mit einer API experimentieren.

Google-Konto erstellen

Zur Verwendung von Google Cloud APIs in Ihren Anwendungen benötigen Sie als Erstes ein Google-Konto. So können Sie Google-Entwicklerprodukte verwenden, einschließlich Google Cloud Console, Cloud SDK, Cloud Logging und Cloud Monitoring. Wenn Sie noch nicht mit Google Cloud gearbeitet haben, erstellen Sie ein Konto, um die Leistung unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $zum Ausführen, Testen und Bereitstellen von Arbeitslasten.

Google-Projekt erstellen

Um Cloud APIs verwenden zu können, benötigen Sie außerdem ein Google-Projekt. Ein Projekt entspricht einem Entwicklerkonto. Es dient als Ressourcencontainer für Ihre Google Cloud-Ressourcen. Außerdem ermöglicht sie eine Isolationsgrenze für Ihre Nutzung von Google Cloud-Diensten, sodass Sie Kontingentlimits und Abrechnungen unabhängig auf Projektebene verwalten können. Nutzungstelemetrie und Dashboards werden ebenfalls nach Projekten gruppiert. Wenn Sie noch kein Projekt haben, können Sie es mit der Cloud Console erstellen.

In einem Projekt kann eine Vielzahl an Ressourcen enthalten sein, darunter API-Schlüssel, OAuth-Clients, Dienstkonten, Compute Engine-VMs, Cloud Storage-Buckets und BigQuery-Datasets. Wenn eine Anwendung eine Cloud API aufruft, wird das Projekt mit den Anmeldedaten der Anwendung als Clientprojekt und das Projekt mit der Zielressource als Ressourcenprojekts Eine API-Anfrage kann mehrere Ressourcen betreffen, daher sind dann mehrere Ressourcenprojekte beteiligt.

Wenn Sie Google Cloud aus irgendeinem Grund nicht mehr verwenden möchten, können Sie Ihr Projekt mit der Cloud Console löschen. Ihr Projekt und alle darin enthaltenen Ressourcen werden nach Ablauf der Aufbewahrungsdauer entfernt. Beachten Sie, dass unterschiedliche Datentypen unterschiedliche Aufbewahrungsfristen haben.

APIs werden aktiviert

Um eine Cloud API verwenden zu können, müssen Sie sie für Ihr Projekt aktivieren. Je nachdem, welche Dienste und welche Projekte von der Anwendung betroffen sind, müssen Sie möglicherweise eine API für mehrere Projekte aktivieren. Dies schließt das Client-Projekt und die Ressourcenprojekte ein.

Zum Aktivieren einer API müssen Sie auch die Nutzungsbedingungen und die Zuständigkeit für die Abrechnung für die API akzeptieren. Sie benötigen die Berechtigung serviceusage.services.enable für das Projekt, um APIs zu aktivieren. Weitere Informationen finden Sie unter Zugriffssteuerung für Dienstnutzung.

So aktivieren Sie eine API für ein Projekt über die Console:

  1. Rufen Sie die API-Bibliothek der Cloud Console auf.
  2. Wählen Sie in der Projektliste das Projekt aus, das Sie verwenden möchten.
  3. Wählen Sie in der API-Bibliothek die API aus, die Sie aktivieren möchten. Wenn Sie Hilfe bei der Suche nach der API benötigen, verwenden Sie das Suchfeld und/oder die Filter.
  4. Klicken Sie auf der API-Seite auf AKTIVIEREN.

Auf dieser Seite können Sie eine API für Ihr Projekt auch deaktivieren, wenn Sie sie nicht mehr benötigen. Damit lassen sich Missbrauch und unbeabsichtigte Abrechnungsgebühren vermeiden. Sie können Cloud APIs auch mit dem Cloud SDK und der Service Usage API aktivieren und deaktivieren:

$ gcloud services enable pubsub.googleapis.com
$ gcloud services disable pubsub.googleapis.com

Abrechnung aktivieren

Für einige Cloud APIs wird eine Nutzungsgebühr berechnet. Damit Sie diese APIs in Ihrem Projekt verwenden können, müssen Sie die Abrechnung für das Projekt aktivieren. Die API-Nutzung in einem Projekt wird über das Abrechnungskonto abgerechnet, das dem Projekt zugeordnet ist.

Wenn Sie noch kein Abrechnungskonto haben, rufen Sie die Abrechnungsseite der Cloud Console auf und folgen Sie der Anleitung zum Erstellen eines Kontos. Verknüpfen Sie dann Ihr Abrechnungskonto mit Ihrem Projekt.

Anmeldedaten für die Anwendung abrufen

Cloud APIs akzeptieren nur API-Anfragen von registrierten Anwendungen. Diese Anforderung hilft API-Erstellern, die API-Nutzung dem richtigen Projekt zuzuordnen, das der Anwendung gehört.

Cloud APIs verwenden die Anmeldedaten der Anwendung zum Identifizieren der aufrufenden Anwendungen. Zu den Typen von Anmeldedaten gehören API-Schlüssel, OAuth 2.0-Clients und Dienstkonten. Sie können die Cloud Console zum Erstellen, Abrufen und Verwalten der Anmeldedaten Ihrer Anwendung verwenden. Weitere Informationen zu Anmeldedaten für Anwendungen finden Sie unter Authentifizierung.

Anmeldedaten für Anwendungen verwenden

Wenn Sie mit Google Cloud APIs noch nicht vertraut sind, sollten Sie unbedingt mit oauth2l mit den Anmeldedaten Ihrer Anwendung und mit Cloud APIs experimentieren, bevor Sie Anwendungscode schreiben. oauth2l kann alle Anwendungsanmeldedaten akzeptieren und zum Aufrufen von Google Cloud APIs mit dem Befehl curl verwenden.

Beispiel:

oauth2l curl --credentials ./creds.json --scope cloud-platform --url https://pubsub.googleapis.com/v1/projects/my-project-id/topics -- -v

Anwendungen erstellen

Wenn Sie eine Anwendung mit Cloud APIs erstellen, empfehlen wir die Verwendung von Google Cloud-Clientbibliotheken, falls verfügbar. Die Clientbibliotheken können gängige API-Funktionen wie Authentifizierung, Fehlerbehandlung, Wiederholung und Nutzlastvalidierung verwenden. Sie müssen Ihre Anwendungsanmeldedaten während der Initialisierung an die Clientbibliotheken übergeben, damit die Clientbibliotheken im Namen Ihrer Anwendung Aufrufe an Google Cloud APIs senden können.

Weitere Informationen erhalten Sie unter Erläuterung der Clientbibliotheken.

Weitere Informationen

Weitere Informationen zur Authentifizierung finden Sie unter Authentifizierung.

Weitere Informationen zur Fehlerbehebung finden Sie unter Fehlerbehandlung.

Weitere Informationen zur Abrechnung finden Sie unter Rechnungskonto erstellen, ändern oder schließen.

Weitere Informationen zum Aktivieren der Abrechnung für Ihr Projekt finden Sie unter Abrechnungseinstellungen eines Projekts ändern.

Weitere Informationen zum Aktivieren und Deaktivieren von APIs finden Sie unter Dienste aktivieren und deaktivieren.