REST Resource: enterprises

Zasób: Enterprise

Konfiguracja zastosowana do grupy.

Zapis JSON 
{
  "name": string,
  "enabledNotificationTypes": [
    enum (NotificationType)
  ],
  "pubsubTopic": string,
  "primaryColor": integer,
  "logo": {
    object (ExternalData)
  },
  "enterpriseDisplayName": string,
  "termsAndConditions": [
    {
      object (TermsAndConditions)
    }
  ],
  "appAutoApprovalEnabled": boolean,
  "signinDetails": [
    {
      object (SigninDetail)
    }
  ],
  "contactInfo": {
    object (ContactInfo)
  }
}
Pola
name

string

Nazwa firmy generowana przez serwer podczas tworzenia i ma postać enterprises/{enterpriseId}.
enabledNotificationTypes[]

enum (NotificationType)

Typy powiadomień Google Pub/Sub włączone w firmie.
pubsubTopic

string

Temat, w którym publikowane są powiadomienia Pub/Sub, w formacie projects/{project}/topics/{topic}. To pole jest wymagane tylko wtedy, gdy włączone są powiadomienia Pub/Sub.
primaryColor

integer

Kolor w formacie RGB, który wskazuje dominujący kolor wyświetlany w interfejsie aplikacji do zarządzania urządzeniem. Komponenty koloru są przechowywane w ten sposób: (red << 16) | (green << 8) | blue, gdzie wartość każdego z nich mieści się w przedziale od 0 do 255 włącznie.
enterpriseDisplayName

string

Nazwa firmy wyświetlana użytkownikom. Maksymalna długość tego pola to 100 znaków.
termsAndConditions[]

object (TermsAndConditions)

Warunki korzystania z usługi, które należy zaakceptować podczas udostępniania urządzenia na potrzeby tej firmy. Dla każdej wartości z tej listy generowana jest strona z hasłami.
appAutoApprovalEnabled
(deprecated)

boolean

Wycofana i nieużywana.
signinDetails[]

object (SigninDetail)

Dane logowania do firmy.
contactInfo

object (ContactInfo)

Dane kontaktowe firmy zarządzanej przez dostawcę usług EMM.

NotificationType

Typy powiadomień, które serwer zarządzania urządzeniami może wysyłać przez Google Pub/Sub.

Wartości w polu enum
NOTIFICATION_TYPE_UNSPECIFIED Ta wartość jest ignorowana.
ENROLLMENT Powiadomienie wysłane, gdy urządzenie zostanie zarejestrowane.
COMPLIANCE_REPORT

Rola wycofana.
STATUS_REPORT Powiadomienie wysyłane, gdy urządzenie wygeneruje raport o stanie.
COMMAND Wysyłane jest powiadomienie po zakończeniu wykonywania polecenia na urządzeniu.
USAGE_LOGS Powiadomienie zostanie wysłane, gdy urządzenie wyśle BatchUsageLogEvents.

ExternalData

Dane przechowywane w lokalizacji zewnętrznej. Dane powinny zostać pobrane przez aplikację Android Device Policy i sprawdzone pod kątem haszowania.

Zapis JSON 
{
  "url": string,
  "sha256Hash": string
}
Pola
url

string

Bezwzględny URL danych zgodny ze schematem http lub https. Android Device Policy nie podaje w żądaniu GET żadnych danych logowania, więc adres URL musi być publicznie dostępny. Uwzględnienie w adresie URL długiego, losowego komponentu może utrudniać osobom przeprowadzającym atak wykrycie adresu URL.
sha256Hash

string

Zakodowany w formacie base-64 identyfikator SHA-256 treści hostowanej pod adresem URL. Jeśli treść nie pasuje do tego skrótu, Android Device Policy nie będzie używać danych.

TermsAndConditions

Strona z warunkami korzystania z usługi do zaakceptowania podczas obsługi administracyjnej.

Zapis JSON 
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
Pola
header

object (UserFacingMessage)

Krótki nagłówek wyświetlany nad treścią HTML.
content

object (UserFacingMessage)

Dobrze sformatowany ciąg znaków HTML. Zostanie ona przeanalizowana na kliencie za pomocą tagu android.text.html#fromhtml.

SigninDetail

Zasób zawierający dane logowania do firmy. Za pomocą enterprises możesz zarządzać elementami SigninDetail w danej firmie.

W firmie może mieć dowolną liczbę identyfikatorów SigninDetail, które są jednoznacznie identyfikowane przez połączenie tych 3 pól (signinUrl, allowPersonalUsage, tokenTag). Nie można utworzyć dwóch SigninDetail o takim samym identyfikatorze (signinUrl, allowPersonalUsage, tokenTag). Pole tokenTag to pole opcjonalne.

Patch: operacja aktualizuje bieżącą listę SigninDetails o nową listę SigninDetails.

  • Jeśli zapisana konfiguracja SigninDetail zostanie przekazana, zwraca te same wartości signinEnrollmentToken i qrCode.
  • Jeśli przekażemy wiele identycznych SigninDetail konfiguracji, które nie są zapisane, zostanie zapisana pierwsza z tych SigninDetail konfiguracji.
  • Jeśli konfiguracja już istnieje, nie możemy jej zażądać więcej niż raz w danym wywołaniu interfejsu API poprawki. W przeciwnym razie spowoduje to zduplikowany błąd klucza, a cała operacja zakończy się niepowodzeniem.
  • Jeśli usuniemy z żądania określoną konfigurację SigninDetail, zostanie ona usunięta z pamięci. Następnie możemy poprosić o kolejne signinEnrollmentToken i qrCode dla tej samej konfiguracji SigninDetail.
Zapis JSON 
{
  "signinUrl": string,
  "signinEnrollmentToken": string,
  "qrCode": string,
  "allowPersonalUsage": enum (AllowPersonalUsage),
  "tokenTag": string
}
Pola
signinUrl

string

Adres URL logowania na potrzeby uwierzytelniania, gdy urządzenie jest objęte obsługą tokena rejestracji logowania. Punkt końcowy logowania powinien zakończyć proces uwierzytelniania za pomocą adresu URL w postaci https://enterprise.google.com/android/enroll?et= , aby umożliwić pomyślne logowanie, lub https://enterprise.google.com/android/enroll/invalid w przypadku nieudanego logowania.
signinEnrollmentToken

string

Token rejestracji dla całej firmy używany do aktywowania niestandardowego procesu logowania. To pole jest przeznaczone tylko do odczytu wygenerowane przez serwer.
qrCode

string

Ciąg znaków JSON, którego reprezentacja UTF-8 może zostać użyta do wygenerowania kodu QR służącego do zarejestrowania urządzenia za pomocą tego tokena rejestracji. Aby zarejestrować urządzenie za pomocą NFC, rekord NFC musi zawierać zserializowaną reprezentację właściwości java.util.Properties w formacie JSON. To pole jest przeznaczone tylko do odczytu wygenerowane przez serwer.
allowPersonalUsage

enum (AllowPersonalUsage)

Określa, czy użycie osobiste jest dozwolone na urządzeniu obsługującym ten token rejestracji.

W przypadku urządzeń należących do firmy:

  • Włączenie opcji użytku osobistego pozwala użytkownikowi skonfigurować profil służbowy na urządzeniu.
  • Wyłączenie użycia osobistego wymaga, aby użytkownik obsługiwał urządzenie jako w pełni zarządzane.

W przypadku urządzeń należących do firmy:

  • Włączenie opcji użytku osobistego pozwala użytkownikowi skonfigurować profil służbowy na urządzeniu.
  • Wyłączenie funkcji użytku osobistego uniemożliwi obsługę administracyjną urządzenia. Nie można wyłączyć korzystania z urządzenia osobistego na urządzeniu należącym do Ciebie.
tokenTag

string

Metadane określone przez dostawcę usług EMM, które pozwalają odróżnić instancje SigninDetail.

ContactInfo

Dane kontaktowe firm w zarządzanym Sklepie Google Play.

Zapis JSON 
{
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}
Pola
contactEmail

string

Adres e-mail osoby kontaktowej, na którą będą wysyłane ważne powiadomienia dotyczące zarządzanego Sklepu Google Play.
dataProtectionOfficerName

string

Imię i nazwisko inspektora ochrony danych
dataProtectionOfficerEmail

string

Adres e-mail inspektora ochrony danych. Adres e-mail został zweryfikowany, ale nie zweryfikowany.
dataProtectionOfficerPhone

string

Numer telefonu inspektora ochrony danych Numer telefonu został zweryfikowany, ale nie zweryfikowany.
euRepresentativeName

string

Imię i nazwisko przedstawiciela w Unii Europejskiej.
euRepresentativeEmail

string

Adres e-mail przedstawiciela w Unii Europejskiej. Adres e-mail został zweryfikowany, ale nie zweryfikowany.
euRepresentativePhone

string

Numer telefonu przedstawiciela w Unii Europejskiej. Numer telefonu jest weryfikowany, ale nie zweryfikowany.

Metody

create

 Tworzy grupę kont.

delete

 Trwałe usunięcie grupy oraz wszystkich powiązanych z nią kont i danych.

get

 Pobiera grupę.

list

 Wyświetla listę firm zarządzanych przez EMM.

patch

 Aktualizuje grupę.