REST Resource: partners.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)
    }
  ]
}
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 partners/[PARTNER_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ść. Więcej informacji znajdziesz w sekcji Metadane urządzenia.

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 partners.devices.unclaim lub partners.devices.unclaimAsync, aby usunąć urządzenie z rejestracji typu zero-touch.

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,
  "resellerId": 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.

googleWorkspaceCustomerId

string

Identyfikator konta Google Workspace, do którego należy urządzenie z Chrome OS.

resellerId

string (int64 format)

Identyfikator sprzedawcy, który odebrał urządzenie.

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

claim

Rezerwuje urządzenie dla klienta i dodaje je do rejestracji typu zero-touch.

claimAsync

Asynchronicznie żąda grupy urządzeń dla klienta.

findByIdentifier

Wyszukuje urządzenia na podstawie ich identyfikatorów sprzętowych (np. IMEI).

findByOwner

Znajduje urządzenia zarezerwowane dla klientów.

get

Pobiera urządzenie.

metadata

Aktualizuje metadane sprzedawcy powiązane z urządzeniem.

unclaim

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

unclaimAsync

Asynchronicznie usuwa rezerwację grupy urządzeń dla klienta.

updateMetadataAsync

Aktualizuje metadane sprzedawcy dołączone do grupy urządzeń.