REST Resource: customers.devices

Zasób: urządzenie

Urządzenie z Androidem lub Chrome OS zarejestrowane na potrzeby 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ą wygenerowane 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. Uporządkowane w postaci par klucz-wartość.
claims[]

object (DeviceClaim)

Tylko dane wyjściowe. Zgłaszanie roszczeń do 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

Konfiguracja zastosowana na urządzeniu w formacie customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. Jeśli urządzenie nie ma skonfigurowanej konfiguracji, wartość to null.

DeviceIdentifier (identyfikator urządzenia)

Zawiera identyfikatory sprzętu i produktu, aby zidentyfikować wyprodukowane urządzenie. Aby poznać wymagania dotyczące zestawów identyfikatorów, zapoznaj się z artykułem 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. Wartość może nie być unikalna w zależności od modelu urządzenia.
manufacturer

string

Nazwa producenta urządzenia. Odpowiada wbudowanej wartości urządzenia zwróconej przez android.os.Build.MANUFACTURER. Dozwolone wartości znajdziesz na liście producentów Androida.
model

string

Nazwa modelu urządzenia. Dozwolone wartości są wymienione na stronach modeli Androida i Chrome OS.
deviceType

enum (DeviceType)

typ urządzenia;
chromeOsAttestedDeviceId

string

Identyfikator podawany przez producenta OEM w trakcie produkcji i sprzedaży. Dotyczy tylko urządzeń z Chrome OS.
Pole sumy: hardware_id. Identyfikator sprzętowy oparty na identyfikatorze modemu. hardware_id może mieć tylko jedną z tych wartości:
imei

string

Numer IMEI urządzenia. Zweryfikowana przy wprowadzaniu.
meid

string

Numer MEID urządzenia.

Typ urządzenia

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

Metadane urządzenia

Pozycje metadanych, które można dołączyć do tagu Device. Więcej informacji znajdziesz w artykule Metadane urządzenia.

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

map (key: string, value: string)

Pozycje metadanych zarejestrowane jako pary klucz-wartość.

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

Roszczenie dotyczące urządzenia

Rekord urządzenia użytkownika, które sprzedawca zgłosił 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 Zgłaszanie praw do 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 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 na urządzeniu.

Typ udostępniania-urządzenia

Typ sekcji rekordu udostępniania.

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

Usługa dodatkowa

Zarejestrowano dodatkową usługę na urządzeniu.

Wartości w polu enum
DEVICE_PROTECTION Usługa ochrony urządzenia, nazywana też Android Enterprise Essentials. Aby uzyskać dostęp do urządzenia z usługą ochrony urządzenia, musisz zarejestrować się w zespole partnerskim.

Metody

applyConfiguration

 Stosuje do urządzenia konfigurację w celu zarejestrowania go w procesie rejestracji typu zero-touch.

get

 Pobiera szczegóły urządzenia.

list

 Wyświetla listę urządzeń klienta.

removeConfiguration

 Usuwa konfigurację z urządzenia.

unclaim

 Cofnie usunięcie urządzenia z konta klienta i usunięcie go z rejestracji typu zero-touch.