Android Device Provisioning Partner API

Mit dieser API können Geräte-Reseller die Zero-Touch-Registrierung programmatisch verwalten.

Dienst: androiddeviceprovision.googleapis.com

Zum Aufrufen dieses Dienstes empfehlen wir die Verwendung der von Google bereitgestellten Clientbibliotheken. Wenn Ihre Anwendung Ihre eigenen Bibliotheken zum Aufrufen dieses Dienstes verwenden muss, verwenden Sie bei den API-Anfragen die folgenden Informationen.

Discovery-Dokument

Ein Discovery-Dokument ist eine maschinenlesbare Spezifikation zum Beschreiben und Nutzen von REST APIs. Sie wird verwendet, um Clientbibliotheken, IDE-Plug-ins und andere Tools zu erstellen, die mit Google APIs interagieren. Ein Dienst kann mehrere Discovery-Dokumente haben. Der Dienst bietet das folgende Discovery-Dokument:

Dienstendpunkt

Ein Dienstendpunkt ist eine Basis-URL, die die Netzwerkadresse eines API-Dienstes angibt. Ein Dienst kann mehrere Dienstendpunkte haben. Dieser Dienst hat den folgenden Dienstendpunkt und alle nachstehenden URIs beziehen sich auf ihn:

  • https://androiddeviceprovisioning.googleapis.com

REST-Ressource: v1.operations

Methoden
get GET /v1/{name=operations/**}
Ruft den letzten Status eines lang andauernden Vorgangs ab.

REST-Ressource: v1.partners.customers

Methoden
create POST /v1/{parent=partners/*}/customers
Erstellt einen Kunden für die Zero-Touch-Registrierung.
list GET /v1/partners/{partnerId}/customers
Listet die Kunden auf, die bei dem Reseller registriert sind, der durch das Argument partnerId identifiziert wird.

REST-Ressource: v1.partners.devices

Methoden
claim POST /v1/partners/{partnerId}/devices:claim
Fordern Sie ein Gerät für einen Kunden an und fügen es der Zero-Touch-Registrierung hinzu.
claimAsync POST /v1/partners/{partnerId}/devices:claimAsync
Beansprucht eine Gruppe von Geräten asynchron für einen Kunden.
findByIdentifier POST /v1/partners/{partnerId}/devices:findByIdentifier
Geräte werden anhand von Hardwarekennungen wie IMEI gesucht.
findByOwner POST /v1/partners/{partnerId}/devices:findByOwner
Findet Geräte, die für Kunden beansprucht wurden.
get GET /v1/{name=partners/*/devices/*}
Ein Gerät abruft.
metadata POST /v1/partners/{metadataOwnerId}/devices/{deviceId}/metadata
Aktualisiert die Reseller-Metadaten, die mit dem Gerät verknüpft sind.
unclaim POST /v1/partners/{partnerId}/devices:unclaim
Hebt die Inhaberschaft für ein Gerät für einen Kunden auf und entfernt es aus der Zero-Touch-Registrierung.
unclaimAsync POST /v1/partners/{partnerId}/devices:unclaimAsync
Hebt die Beanspruchung eines Batches von Geräten für einen Kunden asynchron auf.
updateMetadataAsync POST /v1/partners/{partnerId}/devices:updateMetadataAsync
Aktualisiert die Reseller-Metadaten, die an einen Batch von Geräten angehängt sind.

REST-Ressource: v1.partners.vendors

Methoden
list GET /v1/{parent=partners/*}/vendors
Listet die Anbieter des Partners auf.

REST-Ressource: v1.partners.vendors.customers

Methoden
list GET /v1/{parent=partners/*/vendors/*}/customers
Listet die Kundschaft des Anbieters auf.