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 Name der API-Ressource 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 Bereitstellungsanträge 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)

Umfasst 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 für das Gerät. 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 Kennung, die von OEMs bereitgestellt wird und den gesamten Produktions- und Vertriebsprozess durchläuft. Gilt nur für ChromeOS-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 dieser Wert festgelegt ist, muss er demselben Identifikationstyp 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. Geräte, die für die Zero-Touch-Registrierung beansprucht wurden, haben einen 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, der auf das Gerät erhoben wird.
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.
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 Abschnittstyp eines Bereitstellungsdatensatzes.

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 einen Anspruch auf ein Gerät mit dem Geräteschutzservice geltend machen möchten, müssen Sie sich beim Partnerteam registrieren.

Methoden

claim

 Erklärt ein Gerät für einen Kunden an und fügt es der Zero-Touch-Registrierung hinzu.

claimAsync

 Hiermit wird asynchron ein Geräte-Batch für einen Kunden beansprucht.

findByIdentifier

 Geräte anhand von Hardware-IDs wie der IMEI finden

findByOwner

 Sucht nach Geräten, die für Kunden beansprucht wurden.

get

 Ein Gerät abruft.

metadata

 Aktualisiert die mit dem Gerät verknüpften Reseller-Metadaten.

unclaim

 Der Anspruch eines Kunden auf ein Gerät wird aufgehoben und es wird aus der Zero-Touch-Registrierung entfernt.

unclaimAsync

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

updateMetadataAsync

 Aktualisiert die Reseller-Metadaten, die mit einer Gerätegruppe verknüpft sind.