REST Resource: partners.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)
    }
  ]
}
Pola
deviceId

string (int64 format)

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

object (DeviceIdentifier)

Identyfikatory sprzętowe, 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]. Przypisany przez serwer.
deviceMetadata

object (DeviceMetadata)

Metadane dołączone do urządzenia. mają strukturę par klucz-wartość. Więcej informacji znajdziesz w artykule Metadane urządzeń.
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. Aby usunąć urządzenie z rejestracji typu zero-touch, zadzwoń pod numer partners.devices.unclaim lub partners.devices.unclaimAsync.

DeviceIdentifier (identyfikator urządzenia)

Zawiera identyfikatory sprzętu i produktu, które służą do identyfikowania wyprodukowanego urządzenia. Aby dowiedzieć się więcej o wymaganiach dotyczących zbiorów identyfikatorów, przeczytaj artykuł 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. Jest zgodna z wbudowaną wartością urządzenia zwracaną przez android.os.Build.MANUFACTURER. Dozwolone wartości są wymienione w witrynie 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 ChromeOS.
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.
Pole unii hardware_id2. Drugi identyfikator sprzętowy, w przypadku urządzeń z 2 kartami SIM. Jeśli jest ustawiony, musi być tego samego typu co pierwszy identyfikator sprzętowy. hardware_id2 może być tylko jednym z tych elementów:
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 Device. Więcej informacji znajdziesz w artykule Metadane urządzeń.

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

map (key: string, value: string)

Wpisy metadanych są zapisywane 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 są objęte roszczeniem 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,
  "resellerId": 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.
resellerId

string (int64 format)

Identyfikator sprzedawcy, który zgłosił roszczenie do urządzenia.
additionalService

enum (AdditionalService)

Usługa dodatkowa zarejestrowana na urządzeniu.

DeviceProvisioningSectionType

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.

AdditionalService

Dodatkowa usługa zarejestrowana na urządzeniu.

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

claim

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

claimAsync

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

findByIdentifier

 Znajduje urządzenia według identyfikatorów sprzętowych, takich jak IMEI.

findByOwner

 Znajduje urządzenia przypisane do klientów.

get

 Pobiera urządzenie.

metadata

 Aktualizuje metadane sprzedawcy powiązane z urządzeniem.

unclaim

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

unclaimAsync

 asynchronicznie odwołuje przypisanie partii urządzeń do klienta;

updateMetadataAsync

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