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 Name der API-Ressource im Format customers/[CUSTOMER_ID]/devices/[DEVICE_ID]. Vom Server zugewiesen.
deviceMetadata

object (DeviceMetadata)

Die Metadaten, die mit dem Gerät verknüpft sind. Sie sind als Schlüssel/Wert-Paare strukturiert.
claims[]

object (DeviceClaim)

Nur Ausgabe. Die Bereitstellungsanforderungen für ein Gerät. Geräte, die für die Zero-Touch-Registrierung beansprucht wurden, haben einen 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.

  // Union field hardware_id2 can be only one of the following:
  "imei2": string,
  "meid2": string
  // End of list of possible types for union field hardware_id2.
}
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. Entspricht dem vordefinierten Wert des Geräts, der von android.os.Build.MANUFACTURER zurückgegeben wird. Die zulässigen Werte sind auf der Seite Android-Hersteller aufgeführt.
model

string

Der Name des Gerätemodells. Zulässige Werte finden Sie unter Android-Modelle und ChromeOS-Modelle.
deviceType

enum (DeviceType)

Der 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.
Union-Feld hardware_id2. Die zweite Hardware-ID für Dual-SIM-Geräte. Wenn er festgelegt ist, muss er demselben Kennungstyp wie die erste Hardware-ID entsprechen. Für hardware_id2 ist nur einer der folgenden Werte zulässig:
imei2

string

Die zweite IMEI-Nummer des Geräts.
meid2

string

Die zweite 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 eine 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)

Metadateneinträge, die als Schlüssel/Wert-Paare aufgezeichnet werden.

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

DeviceClaim

Ein Eintrag für ein Gerät, das von einem Reseller für einen Kunden beansprucht wurde. 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 Gerät gekauft hat.
googleWorkspaceCustomerId

string

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

enum (AdditionalService)

Der für das Gerät registrierte zusätzliche Dienst.

DeviceProvisioningSectionType

Der Bereichstyp eines Bereitstellungseintrags.

Enums
SECTION_TYPE_SIM_LOCK Abschnittstyp für die SIM-Sperrung.
SECTION_TYPE_ZERO_TOUCH Abschnittstyp 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.