REST Resource: customers.configurations

Zasób: konfiguracja

Konfiguracja zbiera opcje udostępniania na urządzeniach 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, aby pomóc użytkownikom podczas konfiguracji.

Klienci mogą dodać dowolną liczbę konfiguracji. Rejestracja typu zero-touch sprawdza się jednak najlepiej, gdy klient ustawi domyślną konfigurację, która będzie stosowana na wszystkich nowych urządzeniach zakupionych 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]. Przypisany przez serwer.
configurationId

string (int64 format)

Tylko dane wyjściowe. Identyfikator konfiguracji. Przypisany przez serwer.
configurationName

string

Wymagany. Skrócona nazwa określająca przeznaczenie konfiguracji. Na przykład Zespół sprzedaży lub Pracownicy tymczasowi. Portal rejestracji typu zero-touch wyświetla tę nazwę administratorom IT.
dpcResourcePath

string

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

string

Materiały dodatkowe funkcji EMM w formacie JSON przekazywane do DPC.
companyName

string

Wymagany. Nazwa organizacji. Rejestracja typu zero-touch będzie ją wyświetlać użytkownikom, gdy będzie włączona obsługa administracyjna urządzenia.
contactEmail

string

Wymagany. Adres e-mail, pod którym użytkownicy mogą skontaktować się z zespołem pomocy i uzyskać pomoc. Rejestracja typu Zero-Touch wyświetla ten adres e-mail użytkownikom przed rozpoczęciem obsługi administracyjnej urządzenia. Wartość jest sprawdzana na podstawie danych wejściowych.
contactPhone

string

Wymagany. Numer telefonu, pod który użytkownicy mogą zadzwonić z innego urządzenia, by 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 plus, łączniki oraz nawiasy.
customMessage

string

Wiadomość zawierająca 1 lub 2 zdania, aby pomóc użytkownikowi urządzenia lub uzyskać więcej informacji o tym, co dzieje się z jego urządzeniem. Rejestracja typu zero-touch wyświetla tę wiadomość przed rozpoczęciem obsługi administracyjnej urządzenia.
isDefault

boolean

Wymagany. Określa, czy jest to domyślna konfiguracja, którą rejestracja typu zero-touch dotyczy wszystkich nowych urządzeń kupowanych przez organizację w przyszłości. Wartość domyślna może mieć tylko jedną konfigurację klienta. Ustawienie tej wartości na true zmienia wartość isDefault poprzedniej konfiguracji domyślnej na false.
forcedResetTime

string (Duration format)

Opcjonalnie. Limit czasu, po którym urządzenie zostanie przywrócone do ustawień fabrycznych, jeśli nie przejdzie obsługi administracyjnej w kreatorze konfiguracji, zwykle z powodu braku połączenia z siecią podczas kreatora konfiguracji. Ma zakres od 0 do 6 godzin, a jeśli nie jest ustawiony, domyślnie 2 godziny.

Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, który kończy się na „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.