Android Device Provisioning Partner API

Mit dieser API können Reseller für Geräte 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 zum Aufrufen dieses Dienstes Ihre eigenen Bibliotheken benötigt, verwenden Sie die folgenden Informationen, wenn Sie die API-Anfragen stellen.

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 für den Reseller registriert sind, der durch das Argument partnerId identifiziert wird.

REST-Ressource: v1.partners.devices

Methoden
claim POST /v1/partners/{partnerId}/devices:claim
Beansprucht ein Gerät für einen Kunden und fügt es der Zero-Touch-Registrierung hinzu.
claimAsync POST /v1/partners/{partnerId}/devices:claimAsync
Beansprucht einen Satz von Geräten asynchron für einen Kunden.
findByIdentifier POST /v1/partners/{partnerId}/devices:findByIdentifier
Ermittelt Geräte anhand von Hardwarekennungen wie der IMEI.
findByOwner POST /v1/partners/{partnerId}/devices:findByOwner
Findet Geräte, auf die Kunden Anspruch erhoben haben.
get GET /v1/{name=partners/*/devices/*}
Ruft ein Gerät ab.
metadata POST /v1/partners/{metadataOwnerId}/devices/{deviceId}/metadata
Aktualisiert Reseller-Metadaten, die mit dem Gerät verknüpft sind
unclaim POST /v1/partners/{partnerId}/devices:unclaim
Der Kunde hebt den Anspruch auf ein Gerät auf und entfernt es aus der Zero-Touch-Registrierung.
unclaimAsync POST /v1/partners/{partnerId}/devices:unclaimAsync
Hebt den Anspruch auf einen Satz von Geräten für einen Kunden asynchron auf.
updateMetadataAsync POST /v1/partners/{partnerId}/devices:updateMetadataAsync
Aktualisiert die Metadaten eines Resellers, die mit einem Batch von Geräten verknüpft 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 Kunden des Anbieters auf.