Vorbereitung

Bevor Sie mit der Codierung Ihrer ersten Client-Anwendung beginnen können, sind noch einige Vorbereitungen zu treffen, falls noch nicht geschehen.

Erstellen Sie sich ein Google-Konto

Sie benötigen ein Google-Konto, um Zugriff auf die Compute Engine in der Google API Console zu erhalten. Wenn Sie bereits ein solches Konto haben, sind Sie schon startklar.

Für Testzwecke könnte ein separates Google-Konto sinnvoll sein.

Compute Engine registrieren und verwenden

Für den Einstieg können Sie eine VM-Instanz in Compute Engine mit einer der folgenden Anleitungen erstellen:

Es ist wichtig, sich mit den Grundlagen der Compute Engine vertraut zu machen, bevor Sie fortfahren. In der API-Dokumentation wird davon ausgegangen, dass Sie Compute Engine bereits verwendet haben und mit Webprogrammierkonzepten und Webdatenformaten vertraut sind.

Weitere Informationen zur Authentifizierung

Es gibt verschiedene Möglichkeiten, sich bei Compute Engine zu authentifizieren, je nachdem, wie Sie auf die API zugreifen. Weitere Informationen finden Sie unter Bei Compute Engine authentifizieren.

Informationen über REST

Es gibt zwei Möglichkeiten, die API aufzurufen:

Wenn Sie sich gegen die Verwendung von Clientbibliotheken entscheiden, müssen Sie die Grundlagen von REST verstehen.

REST ist eine Art Softwarearchitektur, die einen bequemen und einheitlichen Ansatz zur Abfrage und Bearbeitung von Daten bietet.

REST steht für "Representational State Transfer". Im Kontext der Google APIs ist damit die Verwendung von HTTP-Verben gemeint, um Darstellungen von Daten, die bei Google gespeichert sind, abzufragen und zu bearbeiten.

In einem als "RESTful" bezeichneten System werden Ressourcen in einem Datenspeicher abgelegt; ein Client sendet eine Aufforderung, der Server möge eine bestimmte Aktion ausführen (z. B. eine Ressource erstellen, abfragen, aktualisieren oder löschen), und der Server führt die Aktion aus und sendet eine Antwort, oft in Form einer Darstellung der angegebenen Ressource.

In Googles RESTful APIs spezifiziert der Client eine Aktion mit einem HTTP-Verb wie POST, GET, PUT oder DELETE. Eine Ressource wird anhand eines weltweit eindeutigen URIs im folgenden Format spezifiziert:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

Weil alle API-Ressourcen eindeutige, über HTTP zugängliche URIs haben, ermöglicht REST das Caching von Daten und ist optimal geeignet, mit der verteilten Infrastruktur des Webs zu arbeiten.

Dafür können die Methodendefinitionen in der Dokumentation der HTTP 1.1-Standards hilfreich sein. Hier finden Sie auch die Spezifikationen für GET, POST, PUT und DELETE.

REST in der Compute Engine API

Die Vorgänge der Compute Engine API sind REST-HTTP-Verben direkt zugeordnet.

Für URIs der Compute Engine API gelten die folgenden spezifischen Formate:

https://www.googleapis.com/compute/v1/resourcePath?parameters

Eine vollständige Liste der URIs für jeden unterstützten Vorgang in der API finden Sie im Referenzdokument zur Compute Engine API.

Informationen über das JSON-Datenformat

Die Compute Engine API gibt Daten im JSON-Format zurück.

JSON (JavaScript Object Notation) ist ein gängiges sprachunabhängiges Datenformat, das eine einfache Textdarstellung beliebiger Datenstrukturen bietet. Weitere Informationen finden Sie unter json.org.