Erste Schritte

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Auf dieser Seite wird erläutert, wie Entwickler Google Cloud APIs verwenden können.

Wenn Sie Google Cloud APIs zum ersten Mal verwenden, führen Sie die Schritte in dieser Anleitung aus, um die APIs mit curl-Befehlen aufzurufen. Sie können curl-Befehle verwenden, um mit einer API zu experimentieren, bevor Sie Ihre Anwendung entwickeln.

Google-Konto erstellen

Zur Verwendung von Google Cloud APIs in Ihren Anwendungen benötigen Sie als Erstes ein Google-Konto. Dadurch können Sie Google-Entwicklerprodukte verwenden, einschließlich der Google Cloud Console, der gcloud CLI, Cloud Logging und Cloud Monitoring. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

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 in der Google Cloud Console eines 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, werden das Projekt, zu dem die Anmeldedaten der Anwendung gehören, als Clientprojekt und das Projekt, zu dem die Zielressource gehört, als Ressourcenprojekt bezeichnet. 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 in der Google 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 entdecken

Bevor Sie Cloud APIs verwenden, sollten Sie mit der API-Bibliothek der Google Cloud Console die verfügbaren Cloud APIs durchsuchen und diejenigen ermitteln, die Ihren geschäftlichen Anforderungen am besten entsprechen. Weitere Informationen zu einer bestimmten Cloud API finden Sie auf der öffentlichen Website der Cloud API, z. B. Spanner API.

APIs werden aktiviert

Einige Cloud APIs sind standardmäßig aktiviert. Wenn Sie eine Cloud API verwenden möchten, die nicht standardmäßig aktiviert ist, 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. Wenn Sie eine API aktivieren, die von anderen APIs abhängig ist, werden diese APIs gleichzeitig aktiviert.

Zum Aktivieren einer API müssen Sie auch die Nutzungsbedingungen und die Zuständigkeit für die Abrechnung für die API akzeptieren. Zum Aktivieren von APIs benötigen Sie die Berechtigung serviceusage.services.enable für das Projekt. Weitere Informationen finden Sie unter "Service Usage" im Artikel Zugriffssteuerung.

Darüber hinaus muss der zu aktivierende Dienst entweder öffentlich sein oder dem Nutzer muss die Berechtigung servicemanagement.services.bind für den privaten Dienst erteilt werden. Weitere Informationen finden Sie unter Zugriffssteuerung für Service Management.

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

  1. Rufen Sie die API-Bibliothek der Google Cloud Console auf.
  2. Wählen Sie aus 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 über die gcloud CLI und die 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 kein Rechnungskonto haben, rufen Sie die Seite „Abrechnung“ der Google Cloud Console auf und folgen Sie der Anleitung, um eines zu erstellen. Verknüpfen Sie dann Ihr Abrechnungskonto mit Ihrem Projekt.

Bei APIs authentifizieren

Die Authentifizierung bei einer API hängt von Ihrer Entwicklungsumgebung und den von der API unterstützten Authentifizierungsmethoden ab.

Das Einrichten von Standardanmeldedaten für Anwendungen zur Verwendung in verschiedenen Umgebungen ist der am häufigsten verwendete Ansatz und wird für die meisten Anwendungen empfohlen. Wenn die API API-Schlüssel unterstützt, ist das eine weitere Option. Wenn Ihre Anwendung auf Cloud-Ressourcen Ihrer Endnutzer zugreifen muss, erstellen Sie eine OAuth 2.0-Client-ID und verwenden die Authentifizierungsbibliotheken.

Allgemeine Informationen zur Authentifizierung finden Sie unter Authentifizierung bei Google.

Anwendungen erstellen

Wenn Sie eine Anwendung mit Cloud APIs erstellen, empfehlen wir die Verwendung von Google Cloud-Clientbibliotheken, falls verfügbar. Mit Clientbibliotheken lassen sich allgemeine API-Features wie Authentifizierung, Fehlerbehandlung, Wiederholungsversuche und Validierung der Nutzlast implementieren. Sie müssen die Anmeldedaten Ihrer Anwendung während der Initialisierung an die Clientbibliotheken übergeben, damit die Clientbibliotheken im Namen Ihrer Anwendung Aufrufe an Google Cloud APIs senden können.

In den folgenden detaillierten Anleitungen werden die Clientbibliotheken für einige beliebte APIs verwendet:

Weitere Informationen erhalten Sie unter Erläuterung der Clientbibliotheken.

Weitere Informationen