REST Resource: customers.devices

Ressource: Gerät

Ein Android- oder ChromeOS-Gerät, das für die Zero-Touch-Registrierung registriert ist.

JSON-Darstellung
{
  "deviceId": string,
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "name": string,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "claims": [
    {
      object (DeviceClaim)
    }
  ],
  "configuration": string
}
Felder
deviceId

string (int64 format)

Nur Ausgabe. Die ID des Geräts. Vom Server zugewiesen.

deviceIdentifier

object (DeviceIdentifier)

Die Hardware-IDs, die ein hergestelltes Gerät identifizieren. Weitere Informationen finden Sie unter Kennungen.

name

string

Nur Ausgabe. Der API-Ressourcenname im Format customers/[CUSTOMER_ID]/devices/[DEVICE_ID]. Vom Server zugewiesen.

deviceMetadata

object (DeviceMetadata)

Die an das Gerät angehängten Metadaten. Strukturiert als Schlüssel/Wert-Paare.

claims[]

object (DeviceClaim)

Nur Ausgabe. Die Bereitstellungsanforderungen für ein Gerät. Für Geräte, für die die Zero-Touch-Registrierung aktiviert wurde, gilt ein Anspruch vom Typ „SECTION_TYPE_ZERO_TOUCH“. Rufen Sie customers.devices.unclaim an, um das Gerät aus der Zero-Touch-Registrierung zu entfernen.

configuration

string

Die auf das Gerät angewendete Konfiguration im Format customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. Der Wert ist null, wenn auf das Gerät keine Konfiguration angewendet wurde.

DeviceIdentifier (Geräte-ID)

Es enthält Hardware- und Produkt-IDs zur Identifizierung eines hergestellten Geräts. Informationen zu den Anforderungen an ID-Sätze finden Sie unter Kennungen.

JSON-Darstellung
{
  "serialNumber": string,
  "manufacturer": string,
  "model": string,
  "deviceType": enum (DeviceType),
  "chromeOsAttestedDeviceId": string,

  // Union field hardware_id can be only one of the following:
  "imei": string,
  "meid": string
  // End of list of possible types for union field hardware_id.
}
Felder
serialNumber

string

Die Seriennummer des Herstellers. Dieser Wert ist möglicherweise nicht für verschiedene Gerätemodelle eindeutig.

manufacturer

string

Der Name des Geräteherstellers. Stimmt mit dem von android.os.Build.MANUFACTURER zurückgegebenen integrierten Wert des Geräts überein. Die zulässigen Werte sind auf der Seite Android-Hersteller aufgeführt.

model

string

Der Name des Gerätemodells. Die zulässigen Werte sind unter Android-Modelle und Chrome OS-Modelle aufgeführt.

deviceType

enum (DeviceType)

Gerätetyp

chromeOsAttestedDeviceId

string

Eine von OEMs bereitgestellte Kennung, die im Produktions- und Vertriebsprozess verwendet wird. Gilt nur für Chrome OS-Geräte.

Union-Feld hardware_id. Hardware-ID basierend auf einer Modem-ID. Für hardware_id ist nur einer der folgenden Werte zulässig:
imei

string

Die IMEI-Nummer des Geräts. Überprüft bei Eingabe.

meid

string

Die MEID-Nummer des Geräts.

DeviceType

Betriebssystem des Geräts

Enums
DEVICE_TYPE_ANDROID Android-Gerät
DEVICE_TYPE_CHROME_OS ChromeOS-Gerät

DeviceMetadata

Metadateneinträge, die an Device angehängt werden können. Weitere Informationen finden Sie unter Gerätemetadaten.

JSON-Darstellung
{
  "entries": {
    string: string,
    ...
  }
}
Felder
entries

map (key: string, value: string)

Als Schlüssel/Wert-Paare erfasste Metadateneinträge.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

DeviceClaim

Ein Datensatz eines Geräts, das ein Reseller für einen Kunden beansprucht hat. Für Geräte, für die die Zero-Touch-Registrierung aktiviert wurde, gilt ein Anspruch vom Typ „SECTION_TYPE_ZERO_TOUCH“. Weitere Informationen finden Sie unter Geräte für Kunden aktivieren.

JSON-Darstellung
{
  "sectionType": enum (DeviceProvisioningSectionType),
  "ownerCompanyId": string,
  "googleWorkspaceCustomerId": string,
  "additionalService": enum (AdditionalService)
}
Felder
sectionType

enum (DeviceProvisioningSectionType)

Nur Ausgabe. Die Art des Anspruchs auf das Gerät.

ownerCompanyId

string (int64 format)

Die ID des Kunden, der das Android-Gerät gekauft hat.

googleWorkspaceCustomerId

string

Die ID des Google Workspace-Kontos, zu dem das Chrome OS-Gerät gehört.

additionalService

enum (AdditionalService)

Der zusätzliche Dienst, der für das Gerät registriert ist.

DeviceProvisioningSectionType

Der Bereichstyp eines Bereitstellungseintrags.

Enums
SECTION_TYPE_SIM_LOCK Bereichstyp der SIM-Sperre.
SECTION_TYPE_ZERO_TOUCH Bereichstyp für die Zero-Touch-Registrierung.

AdditionalService

Zusätzlicher Dienst, der für das Gerät registriert ist

Enums
DEVICE_PROTECTION Der Geräteschutzdienst, auch bekannt als Android Enterprise Essentials. Wenn Sie ein Gerät über den Geräteschutz anfordern möchten, müssen Sie sich beim Partnerteam registrieren.

Methoden

applyConfiguration

Wendet eine Konfiguration auf das Gerät an, um es für die Zero-Touch-Registrierung zu registrieren.

get

Ruft die Details eines Geräts ab.

list

Listet die Geräte eines Kunden auf.

removeConfiguration

Entfernt eine Konfiguration vom Gerät.

unclaim

Hebt die Inhaberschaft für ein Gerät für einen Kunden auf und entfernt es aus der Zero-Touch-Registrierung.