REST Resource: customers.devices

Zasób: urządzenie

Urządzenie z Androidem lub ChromeOS zarejestrowane w ramach 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]. Przypisana przez serwer.

deviceMetadata

object (DeviceMetadata)

Metadane dołączone 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 są objęte roszczeniem 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 zastosowano konfiguracji, wartość wynosi null.

DeviceIdentifier (identyfikator urządzenia)

Obejmuje identyfikatory sprzętu i produktów, aby umożliwić identyfikację 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.
}
Pola
serialNumber

string

Numer seryjny producenta urządzenia. Ta wartość może nie być niepowtarzalna na różnych modelach 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 sumy hardware_id. Identyfikator sprzętu określony na podstawie identyfikatora modemu. hardware_id może mieć tylko jedną z tych wartości:
imei

string

Numer IMEI urządzenia. Zweryfikowano po podaniu.

meid

string

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 sekcji Metadane urządzenia.

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

Rejestr urządzeń zarezerwowanych przez sprzedawcę dla klienta. Urządzenia zgłoszone do rejestracji typu zero-touch są objęte roszczeniem typu SECTION_TYPE_ZERO_TOUCH. Więcej informacji znajdziesz w artykule Rezerwowanie 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. Rodzaj roszczenia zgłoszonego w związku z urządzeniem.

ownerCompanyId

string (int64 format)

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

googleWorkspaceCustomerId

string

Identyfikator konta Google Workspace, do którego należy urządzenie 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ądzeń (znana też jako Android Enterprise Essentials). Aby zgłosić własność urządzenia w ramach usługi ochrony urządzenia, musisz zarejestrować się w zespole partnerskim.

Metody

applyConfiguration

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

get

Pobiera szczegóły urządzenia.

list

Wyświetla listę urządzeń klienta.

removeConfiguration

Usuwa konfigurację z urządzenia.

unclaim

Służy do usuwania rezerwacji urządzenia z konta klienta i usuwania go z rejestracji typu zero-touch.