Erste Schritte

Wenn Sie ein Google Cloud -Projekt einrichten und die Authentifizierung konfigurieren, können Sie Google Cloud -APIs aus Ihren Anwendungen aufrufen. In diesem Dokument erfahren Sie, wie Sie mit Google Cloud -APIs beginnen. Dazu erstellen Sie ein Projekt, suchen und aktivieren Dienste in der API-Bibliothek, verknüpfen ein Rechnungskonto, richten Anmeldedaten ein und sehen sich Clientbibliotheken an.

Projekt in Google Cloud erstellen

Wenn Sie Google Cloud APIs verwenden möchten, benötigen Sie ein Nutzerkonto (einGoogle -Konto oder ein Konto von einem externen Identitätsanbieter) und einGoogle Cloud -Projekt. Ein Projekt entspricht einem Entwicklerkonto. Es dient als Ressourcencontainer für Ihre Google Cloud -Ressourcen. Außerdem bietet es eine Isolationsgrenze für Ihre Nutzung von Google Cloud -Diensten, sodass Sie Kontingentlimits und Abrechnung unabhängig voneinander auf Projektebene verwalten können. Nutzungstelemetrie und Dashboards werden ebenfalls nach Projekten gruppiert. Wenn Sie noch kein Projekt haben, können Sie eines mit der Google Cloud Console erstellen.

Ein Projekt kann eine Vielzahl von Ressourcen enthalten, darunter API-Schlüssel, OAuth-Clients, Dienstkonten, Compute Engine-VMs, Cloud Storage-Buckets und BigQuery-Datasets. Wenn eine Anwendung eine Google Cloud API aufruft, wird das Projekt, zu dem die Anmeldedaten der Anwendung gehören, als Clientprojekt bezeichnet. Das Projekt, zu dem die Zielressource gehört, wird als Ressourcenprojekt bezeichnet. Einige API-Anfragen können mehrere Ressourcen betreffen. In diesem Fall können mehrere Ressourcenprojekte an der Anfrage beteiligt sein.

Wenn Sie Google Cloud aus irgendeinem Grund nicht mehr verwenden möchten, können Sie Ihr Projekt über die 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 Google Cloud APIs verwenden, sollten Sie in der API-Bibliothek der Google Cloud Console nach verfügbarenGoogle Cloud APIs suchen und diejenigen auswählen, die am besten zu Ihren geschäftlichen Anforderungen passen.

APIs werden aktiviert

Einige Google Cloud APIs sind standardmäßig aktiviert. Wenn Sie eine Google CloudAPI verwenden möchten, die nicht standardmäßig aktiviert ist, müssen Sie sie für Ihr Projekt aktivieren. Je nachdem, welche Dienste und Projekte Ihrer Anwendung beteiligt sind, einschließlich des Clientprojekts und der Ressourcenprojekte, müssen Sie möglicherweise eine API für mehrere Projekte aktivieren. Wenn Sie eine API aktivieren, die von anderen APIs abhängt, werden diese APIs ebenfalls aktiviert.

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.

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

  1. Rufen Sie die Google Cloud Console API-Bibliothek 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 die API nicht finden, können Sie das Suchfeld und die Filter verwenden.
  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 der gcloud CLI 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.

Bei APIs authentifizieren

Wie Sie sich bei einer API authentifizieren, hängt von Ihrer Entwicklungsumgebung und den von der API unterstützten Authentifizierungsmethoden ab.

Die Einrichtung von Standardanmeldedaten für Anwendungen für die Verwendung in verschiedenen Umgebungen ist der gängigste 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 zugreifen muss, die Ihren Endnutzern gehören, 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 Google Cloud -Clientbibliotheken zu verwenden, sofern 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 anGoogle Cloud -APIs senden können.

Weitere Informationen