REST Resource: customers.configurations

Zasób: konfiguracja

Konfiguracja zbiera opcje obsługi administracyjnej urządzeń z Androidem. Każda konfiguracja obejmuje te elementy:

  • kontroler zasad dotyczących urządzeń EMM (DPC) zainstalowany na urządzeniach;
  • Zasady EMM egzekwowane na urządzeniach.
  • Metadane wyświetlane na urządzeniu, które ułatwiają użytkownikom konfigurację.

Klienci mogą dodać dowolną liczbę konfiguracji. Rejestracja typu zero-touch działa jednak najlepiej, gdy klient ustawi domyślną konfigurację stosowaną na wszystkich nowych urządzeniach kupionych przez organizację.

Zapis JSON
{
  "name": string,
  "configurationId": string,
  "configurationName": string,
  "dpcResourcePath": string,
  "dpcExtras": string,
  "companyName": string,
  "contactEmail": string,
  "contactPhone": string,
  "customMessage": string,
  "isDefault": boolean,
  "forcedResetTime": string
}
Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu interfejsu API w formacie customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. Przypisana przez serwer.

configurationId

string (int64 format)

Tylko dane wyjściowe. Identyfikator konfiguracji. Przypisana przez serwer.

configurationName

string

Wymagane. Krótka nazwa opisująca przeznaczenie konfiguracji. Na przykład Zespół sprzedaży lub Pracownicy tymczasowi. W portalu rejestracji typu zero-touch ta nazwa jest wyświetlana administratorom IT.

dpcResourcePath

string

Wymagane. Nazwa zasobu wybranego DPC (kontrolera zasad urządzeń) w formacie customers/[CUSTOMER_ID]/dpcs/*. Aby wyświetlić listę obsługiwanych platform DPC, wywołaj customers.dpcs.list.

dpcExtras

string

Dodatkowe funkcje obsługi administracyjnej usług EMM w formacie JSON przekazywane do DPC.

companyName

string

Wymagane. Nazwa organizacji. Rejestracja typu zero-touch będzie wyświetlać tę nazwę organizacji użytkownikom urządzenia podczas obsługi administracyjnej urządzenia.

contactEmail

string

Wymagane. Adres e-mail, z którego użytkownicy urządzeń mogą się kontaktować, aby uzyskać pomoc. Rejestracja typu Zero-Touch wyświetla ten adres e-mail użytkownikom przed rozpoczęciem obsługi administracyjnej urządzenia. Wartość jest weryfikowana na podstawie wpisanej wartości.

contactPhone

string

Wymagane. Numer telefonu, pod który użytkownicy mogą zadzwonić z innego urządzenia, aby uzyskać pomoc. Rejestracja typu zero-touch wyświetla ten numer użytkownikom przed rozpoczęciem obsługi administracyjnej urządzenia. Może zawierać cyfry, spacje, znak plusa, łączniki i nawiasy.

customMessage

string

Komunikat składający się z 1 lub 2 zdań, który ma pomóc użytkownikom urządzenia uzyskać pomoc lub przekazać więcej informacji o tym, co dzieje się z urządzeniem. Rejestracja typu zero-touch wyświetla tę wiadomość przed rozpoczęciem obsługi administracyjnej urządzenia.

isDefault

boolean

Wymagane. Określa, czy jest to domyślna konfiguracja, którą rejestracja typu zero-touch będzie stosować na wszystkich nowych urządzeniach, które kupi organizacja w przyszłości. Domyślną może być tylko jedna konfiguracja klienta. Ustawienie tej wartości na true zmienia wartość isDefault poprzedniej konfiguracji domyślnej na false.

forcedResetTime

string (Duration format)

Opcjonalnie: Czas oczekiwania przed wymuszeniem przywrócenia urządzenia do ustawień fabrycznych, jeśli nie zostanie przeprowadzona obsługa administracyjna urządzenia w kreatorze konfiguracji, zazwyczaj z powodu braku połączenia sieciowego podczas tworzenia kreatora konfiguracji. Ma zakres od 0 do 6 godzin. Jeśli nie jest skonfigurowana, wartością domyślną jest 2 godziny.

Czas trwania w sekundach składający się z maksymalnie 9 cyfr po przecinku, kończący się cyfrą „s”. Przykład: "3.5s".

Metody

create

Tworzy nową konfigurację.

delete

Usuwa nieużywaną konfigurację.

get

Pobiera szczegóły konfiguracji.

list

Wyświetla listę konfiguracji klienta.

patch

Aktualizuje wartości pól konfiguracji.