REST Resource: customers.devices

Ressource: Gerät

Ein Android- oder Chrome OS-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 auf ein hergestelltes Gerät verweisen. 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 mit dem Gerät verknüpften Metadaten. Sie sind als Schlüssel/Wert-Paare strukturiert.
claims[]

object (DeviceClaim)

Nur Ausgabe. Die Nutzerverwaltungsansprüche für ein Gerät. Geräte, die für die Zero-Touch-Registrierung angemeldet sind, haben einen Anspruch vom Typ SECTION_TYPE_ZERO_TOUCH. Rufe 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 dem Gerät keine Konfiguration angewendet wurde.

DeviceIdentifier (Geräte-ID)

Kapselt Hardware- und Produkt-IDs, um ein hergestelltes Gerät zu identifizieren. Weitere 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 für das Gerät. Dieser Wert ist möglicherweise nicht bei allen Gerätemodellen eindeutig.
manufacturer

string

Der Name des Geräteherstellers. Entspricht dem integrierten Wert des Geräts, der von android.os.Build.MANUFACTURER zurückgegeben wurde. Die zulässigen Werte sind unter Android-Hersteller aufgeführt.
model

string

Der Name des Gerätemodells. Zulässige Werte sind unter Android-Modelle und Chrome OS-Modelle aufgeführt.
deviceType

enum (DeviceType)

Der Typ des Geräts
chromeOsAttestedDeviceId

string

Eine Kennzeichnung, die von OEMs bereitgestellt wird und im Produktions- und Vertriebsprozess ausgeführt 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. Bei Eingabe validiert.
meid

string

Die MEID-Nummer des Geräts.

DeviceType

Betriebssystem des Geräts

Enums
DEVICE_TYPE_ANDROID Android-Gerät
DEVICE_TYPE_CHROME_OS Chrome OS-Gerät

Gerätemetadaten

Metadateneinträge, die an ein 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 aufgezeichnete Metadateneinträge.

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

Geräte-Claim

Datensatz eines Geräts, das von einem Reseller für einen Kunden beansprucht wurde. Geräte, die für die Zero-Touch-Registrierung angemeldet sind, haben einen Anspruch vom Typ SECTION_TYPE_ZERO_TOUCH. Weitere Informationen finden Sie unter Geräte für Kunden beanspruchen.

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

enum (DeviceProvisioningSectionType)

Nur Ausgabe. Die Art des Anspruchs, der auf dem Gerät erhoben wurde.
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 Abschnittstyp eines Bereitstellungseintrags.

Enums
SECTION_TYPE_SIM_LOCK Abschnittstyp für SIM-Sperre.
SECTION_TYPE_ZERO_TOUCH Bereich für die Zero-Touch-Registrierung.

Zusätzlicher Dienst

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

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

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

 Wenn ein Kunde Anspruch auf ein Gerät erhebt, wird es aus der Zero-Touch-Registrierung entfernt.