REST Resource: partners.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)
    }
  ]
}
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 partners/[PARTNER_ID]/devices/[DEVICE_ID]. Vom Server zugewiesen.
deviceMetadata

object (DeviceMetadata)

Die an das Gerät angehängten Metadaten. Strukturiert als Schlüssel/Wert-Paare. Weitere Informationen finden Sie unter Gerätemetadaten.
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 partners.devices.unclaim oder partners.devices.unclaimAsync an, um das Gerät aus der Zero-Touch-Registrierung zu entfernen.

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,
  "resellerId": 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 Chrome OS-Gerät gehört.
resellerId

string (int64 format)

Die ID des Resellers, der das Gerät beansprucht hat.
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

claim

 Fordern Sie ein Gerät für einen Kunden an und fügen es der Zero-Touch-Registrierung hinzu.

claimAsync

 Beansprucht eine Gruppe von Geräten asynchron für einen Kunden.

findByIdentifier

 Geräte werden anhand von Hardwarekennungen wie IMEI gesucht.

findByOwner

 Findet Geräte, die für Kunden beansprucht wurden.

get

 Ein Gerät abruft.

metadata

 Aktualisiert die Reseller-Metadaten, die mit dem Gerät verknüpft sind.

unclaim

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

unclaimAsync

 Hebt die Beanspruchung eines Batches von Geräten für einen Kunden asynchron auf.

updateMetadataAsync

 Aktualisiert die Reseller-Metadaten, die an einen Batch von Geräten angehängt sind.