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.
Der Begriff REST steht für Representational State Transfer. Im Zusammenhang mit Google-APIs bezieht es sich auf die Verwendung von HTTP-Verben zum Abrufen und Ändern von Darstellungen von Daten, die von Google gespeichert sind.
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
. Die Ressource spezifiziert er mit einem weltweit eindeutigen URI mit folgendem Aufbau:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Weil alle API-Ressourcen eindeutige, über HTTP zugängliche URIs besitzen, 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. Dort finden Sie auch die Spezifikationen für GET
, POST
, PUT
und DELETE
.
REST in der Google Compute Engine-API
Die API-Operationen der Google Compute Engine sind eine direkte Abbildung von REST-HTTP-Verben.
Die spezifischen Formate für API-URIs der Google Compute Engine sind so aufgebaut:
https://www.googleapis.com/compute/v1/resourcePath?parameters
Die gesamte Liste der URIs, die für jede in der API unterstützte Operation verwendet werden, finden Sie im Dokument
Google Compute Engine API-Referenz.