REST Resource: customers.devices

Zasób: urządzenie

Urządzenie z Androidem lub ChromeOS zarejestrowane do rejestracji typu zero-touch.

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

string (int64 format)

Tylko dane wyjściowe. Identyfikator urządzenia. Przypisana przez serwer.
deviceIdentifier

object (DeviceIdentifier)

Identyfikatory sprzętu, które identyfikują wyprodukowane urządzenie. Więcej informacji znajdziesz w artykule Identyfikatory.
name

string

Tylko dane wyjściowe. Nazwa zasobu interfejsu API w formacie customers/[CUSTOMER_ID]/devices/[DEVICE_ID]. Przypisany przez serwer.
deviceMetadata

object (DeviceMetadata)

metadane przypisane do urządzenia; Mają strukturę składającą się z par klucz-wartość.
claims[]

object (DeviceClaim)

Tylko dane wyjściowe. Deklaracja administracyjnej urządzenia. Urządzenia zgłoszone do rejestracji typu zero-touch mają roszczenie typu SECTION_TYPE_ZERO_TOUCH. Zadzwoń pod numer customers.devices.unclaim, aby usunąć urządzenie z rejestracji typu zero-touch.
configuration

string

Na urządzeniu zastosowano konfigurację w formacie customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. Jeśli na urządzeniu nie ma skonfigurowanej konfiguracji, wartość jest null.

DeviceIdentifier (identyfikator urządzenia)

Zawiera identyfikatory sprzętu i produktu, które służą do identyfikowania wyprodukowanego urządzenia. Wymagania dotyczące zestawów identyfikatorów znajdziesz w artykule Identyfikatory.

Zapis JSON 
{
  "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.
}
Pola
serialNumber

string

Numer seryjny urządzenia podany przez producenta. Ta wartość może nie być unikalna w przypadku różnych modeli urządzeń.
manufacturer

string

Nazwa producenta urządzenia. Pasuje do wbudowanej wartości urządzenia zwracanej z metody android.os.Build.MANUFACTURER. Dozwolone wartości są wymienione na stronie producentów Androida.
model

string

Nazwa modelu urządzenia. Dozwolone wartości są wymienione w artykule Modele Androida i Modele systemu operacyjnego Chrome.
deviceType

enum (DeviceType)

Typ urządzenia
chromeOsAttestedDeviceId

string

Identyfikator podawany przez producentów OEM w procesie produkcji i sprzedaży. Dotyczy tylko urządzeń z Chrome OS.
Pole unii hardware_id. Identyfikator sprzętowy na podstawie identyfikatora modemu. hardware_id może być tylko jednym z tych elementów:
imei

string

Numer IMEI urządzenia. Zweryfikowano po podaniu.
meid

string

Numer MEID urządzenia.
Pole sumy hardware_id2. Drugi identyfikator sprzętowy w przypadku urządzeń dual SIM. Jeśli jest ustawiony, musi być tego samego typu co pierwszy identyfikator sprzętowy. hardware_id2 może mieć tylko jedną z tych wartości:
imei2

string

drugi numer IMEI urządzenia;
meid2

string

Drugi numer MEID urządzenia.

DeviceType

System operacyjny urządzenia.

Wartości w polu enum
DEVICE_TYPE_ANDROID Urządzenie z Androidem
DEVICE_TYPE_CHROME_OS Urządzenie z Chrome OS

DeviceMetadata

Wpisy metadanych, które można dołączyć do elementu Device. Więcej informacji znajdziesz w artykule Metadane urządzeń.

Zapis JSON 
{
  "entries": {
    string: string,
    ...
  }
}
Pola
entries

map (key: string, value: string)

Wpisy metadanych zarejestrowane jako pary klucz-wartość.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

DeviceClaim

Rekord urządzenia, które zostało zgłoszone przez sprzedawcę na rzecz klienta. Urządzenia zgłoszone do rejestracji typu zero-touch mają roszczenie typu SECTION_TYPE_ZERO_TOUCH. Więcej informacji znajdziesz w artykule Rejestracja urządzeń dla klientów.

Zapis JSON 
{
  "sectionType": enum (DeviceProvisioningSectionType),
  "ownerCompanyId": string,
  "googleWorkspaceCustomerId": string,
  "additionalService": enum (AdditionalService)
}
Pola
sectionType

enum (DeviceProvisioningSectionType)

Tylko dane wyjściowe. Typ roszczenia zgłoszonego na urządzeniu.
ownerCompanyId

string (int64 format)

Identyfikator klienta, który kupił urządzenie.
googleWorkspaceCustomerId

string

Identyfikator konta Google Workspace, które jest właścicielem urządzenia z Chrome OS.
additionalService

enum (AdditionalService)

Usługa dodatkowa zarejestrowana dla urządzenia.

DeviceProvisioningSectionType

Typ sekcji rekordu obsługi administracyjnej.

Wartości w polu enum
SECTION_TYPE_SIM_LOCK Typ sekcji blokady karty SIM.
SECTION_TYPE_ZERO_TOUCH Typ sekcji rejestracji typu zero-touch.

AdditionalService

Usługa dodatkowa została zarejestrowana dla urządzenia.

Wartości w polu enum
DEVICE_PROTECTION Usługa ochrony urządzenia, znana też jako Android Enterprise Essentials. Aby zgłosić roszczenie dotyczące urządzenia w usłudze ochrony urządzenia, musisz się zarejestrować w zespole ds. partnerów.

Metody

applyConfiguration

 Stosuje konfigurację na urządzeniu, aby zarejestrować je do rejestracji typu zero-touch.

get

 Pobiera szczegóły urządzenia.

list

 Wyświetla listę urządzeń klienta.

removeConfiguration

 Usuwa konfigurację z urządzenia.

unclaim

 Odzyskiwanie urządzenia od klienta i usuwanie go z rejestracji typu zero-touch.