Voraussetzungen

Bevor Sie mit dem Coding Ihrer ersten Clientanwendung beginnen, müssen Sie einige Vorbereitungen treffen (falls noch nicht geschehen).

Projekt für den Client erstellen

Bevor Sie Anfragen senden können, müssen Sie Google über Ihren Kunden informieren und den Zugriff auf die API aktivieren. Dazu verwenden Sie die Google API-Konsole, um ein Projekt zu erstellen, bei dem es sich um eine benannte Sammlung handelt. von Einstellungen und API-Zugriffsinformationen und registrieren Sie Ihre Anwendung.

Um die Android Over The Air API verwenden zu können, musst du verwenden das Einrichtungstool, das Sie durch die Erstellung eines Projekts im Google API Console, um die API zu aktivieren und Anmeldedaten zu erstellen

Projekt auf die Zulassungsliste setzen

Die Android Over The Air API ist nur für Projekte auf der Zulassungsliste verfügbar. Wenn Ihr Projekt nicht auf der weißen Liste steht, erhalten Sie 404 Fehler, wenn Sie versuchen, es zu verwenden.

Um auf die weiße Liste gesetzt zu werden, senden Sie eine E-Mail an Ihren Google TAM, damit er Ihre neue Projekt-ID auf die Zulassungsliste setzt.

Die Projekt-ID finden Sie in Ihrem Cloud-Dashboard. Weitere Informationen finden Sie in diesem Hilfedokument.

Die Projekt-ID sollte idealerweise folgendes Format haben: {company}-gota-api-{number}

Aktivieren Sie die Android Over The Air API für Ihr Projekt, nachdem Sie auf die weiße Liste gesetzt wurden. in der Anleitung zur Autorisierung.

Beachten Sie, dass die Android Over The Air API nur mit der von Ihnen angegebenen Projekt-ID verwendet werden kann. Mi. empfehlen wir dringend, ein Dienstkonto für die API-Nutzung zu erstellen (wie unter Autorisierung beschrieben). statt private Konten zu verwenden.

Android Over The Air-Dashboard ausprobieren

In dieser API-Dokumentation wird davon ausgegangen, dass Sie das Android Over The Air-Dashboard verwendet haben und mit Webprogrammierung und Webdatenformaten vertraut sind.

Wenn du das Android Over The Air-Dashboard noch nicht verwendet hast, probiere die Benutzeroberfläche aus, bevor du mit dem Programmieren beginnst.

Informationen zu REST-Grundlagen

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. 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 Android Over The Air API

Die Android Over The Air API-Vorgänge lassen sich direkt REST-HTTP-Verben zuordnen.

Die spezifischen Formate für Android Over The Air API-URIs sind:

https://www.googleapis.com/android/over-the-air/v1/resourcePath?parameters

Die vollständige Gruppe von URIs, die für die einzelnen unterstützten Vorgänge in der API verwendet wird, ist im Dokument Android Over The Air API-Referenz zusammengefasst.

Informationen zu JSON-Grundlagen

Die Android Over The Air 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.