REST Resource: enterprises

Zasób: Enterprise

Konfiguracja zastosowana w firmie.

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)
  },
  "googleAuthenticationSettings": {
    object (GoogleAuthenticationSettings)
  },
  "enterpriseType": enum (EnterpriseType),
  "managedGooglePlayAccountsEnterpriseType": enum (ManagedGooglePlayAccountsEnterpriseType),
  "managedGoogleDomainType": enum (ManagedGoogleDomainType)
}
Pola
name

string

Nazwa przedsiębiorstwa generowana przez serwer podczas tworzenia w formacie enterprises/{enterpriseId}.
enabledNotificationTypes[]

enum (NotificationType)

Typy powiadomień Google Pub/Sub włączone w przypadku firmy.
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ądzeniami. Składowe koloru są przechowywane w formacie (red << 16) | (green << 8) | blue, gdzie wartość każdej składowej mieści się w zakresie 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, które należy zaakceptować podczas udostępniania urządzenia dla tej firmy. Dla każdej wartości na tej liście generowana jest strona z warunkami.
appAutoApprovalEnabled
(deprecated)

boolean

Wycofane i nieużywane.
signinDetails[]

object (SigninDetail)

Dane logowania do przedsiębiorstwa.
contactInfo

object (ContactInfo)

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

object (GoogleAuthenticationSettings)

Ustawienia uwierzytelniania użytkowników zapewnianego przez Google.
enterpriseType

enum (EnterpriseType)

Tylko dane wyjściowe. Rodzaj przedsiębiorstwa.
managedGooglePlayAccountsEnterpriseType

enum (ManagedGooglePlayAccountsEnterpriseType)

Tylko dane wyjściowe. Typ grupy kont zarządzanego Sklepu Google Play.
managedGoogleDomainType

enum (ManagedGoogleDomainType)

Tylko dane wyjściowe. Typ zarządzanej domeny Google.

NotificationType

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

Wartości w polu enum
NOTIFICATION_TYPE_UNSPECIFIED Ta wartość jest ignorowana.
ENROLLMENT Powiadomienie wysyłane po zarejestrowaniu urządzenia.
COMPLIANCE_REPORT

Rola wycofana.
STATUS_REPORT Powiadomienie wysyłane, gdy urządzenie wyśle raport o stanie.
COMMAND Powiadomienie wysyłane po zakończeniu polecenia urządzenia.
USAGE_LOGS Powiadomienie wysyłane, gdy urządzenie wyśle BatchUsageLogEvents.
ENTERPRISE_UPGRADE Powiadomienie wysłane w przypadku uaktualnienia do wersji Enterprise. Uaktualnienie grupy to proces, w którym grupa kont zarządzanego Sklepu Google Play jest przekształcana w zarządzaną domenę Google.

ExternalData

Dane przechowywane w lokalizacji zewnętrznej. Dane mają być pobierane przez aplikację Android Device Policy i weryfikowane na podstawie hasha.

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

string

Bezwzględny adres URL danych, który musi używać schematu http lub https. Aplikacja Android Device Policy nie podaje żadnych danych logowania w żądaniu GET, więc adres URL musi być publicznie dostępny. Umieszczenie w adresie URL długiego, losowego komponentu może uniemożliwić atakującym odkrycie tego adresu.
sha256Hash

string

Zaszyfrowany za pomocą algorytmu SHA-256 i zakodowany w formacie base64 identyfikator treści hostowanych pod adresem URL. Jeśli treść nie pasuje do tego skrótu, Android Device Policy nie użyje danych.

TermsAndConditions

strona z warunkami, które należy zaakceptować podczas udostępniania;

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

object (UserFacingMessage)

Krótki nagłówek, który pojawia się nad treścią HTML.
content

object (UserFacingMessage)

Prawidłowo sformatowany ciąg HTML. Będzie on analizowany na kliencie za pomocą metody android.text.Html#fromHtml.

SigninDetail

Zasób zawierający szczegóły logowania w przypadku firmy. Użyj enterprises, aby zarządzać SigninDetails w danej organizacji.

W przypadku przedsiębiorstwa możemy mieć dowolną liczbę SigninDetail, które są jednoznacznie identyfikowane przez kombinację tych 3 pól: signinUrl, allowPersonalUsage i tokenTag. Nie można utworzyć 2 SigninDetail z tą samą kombinacją pól signinUrl, allowPersonalUsage i tokenTag (tokenTag jest polem opcjonalnym).

Patch: operacja aktualizuje bieżącą listę SigninDetails za pomocą nowej listy SigninDetails.

  • Jeśli zapisana konfiguracja SigninDetail zostanie przekazana, zwróci te same wartości signinEnrollmentToken i qrCode.
  • Jeśli przekażemy wiele identycznych konfiguracji SigninDetail, które nie są przechowywane, zapiszemy pierwszą z nich.SigninDetail
  • Jeśli konfiguracja już istnieje, nie możemy jej zażądać więcej niż raz w ramach konkretnego wywołania interfejsu API do aktualizacji. W przeciwnym razie pojawi się błąd duplikatu klucza i cała operacja zakończy się niepowodzeniem.
  • Jeśli usuniemy z żądania określoną SigninDetail konfigurację, zostanie ona usunięta z pamięci. Możemy wtedy poprosić o kolejne wartości signinEnrollmentToken i qrCode dla tej samej konfiguracji SigninDetail.
Zapis JSON 
{
  "signinUrl": string,
  "signinEnrollmentToken": string,
  "qrCode": string,
  "allowPersonalUsage": enum (AllowPersonalUsage),
  "defaultStatus": enum (SigninDetailDefaultStatus),
  "tokenTag": string
}
Pola
signinUrl

string

Adres URL logowania do uwierzytelniania, gdy urządzenie jest udostępniane za pomocą tokena rejestracji logowania. Punkt końcowy logowania powinien kończyć proces uwierzytelniania adresem URL w formacie https://enterprise.google.com/android/enroll?et= w przypadku udanego logowania lub https://enterprise.google.com/android/enroll/invalid w przypadku nieudanego logowania.
signinEnrollmentToken

string

Token rejestracji w całej firmie używany do wywoływania niestandardowego procesu logowania. Jest to pole tylko do odczytu generowane przez serwer.
qrCode

string

Ciąg znaków JSON, którego reprezentację w standardzie UTF-8 można wykorzystać do wygenerowania kodu QR w celu zarejestrowania urządzenia za pomocą tego tokena rejestracji. Aby zarejestrować urządzenie za pomocą NFC, rekord NFC musi zawierać zserializowaną java.util.Properties reprezentację właściwości w formacie JSON. Jest to pole tylko do odczytu generowane przez serwer.
allowPersonalUsage

enum (AllowPersonalUsage)

Określa, czy na urządzeniu skonfigurowanym za pomocą tego tokena rejestracyjnego można używać konta osobistego.

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

  • Włączenie użytku osobistego umożliwia użytkownikowi skonfigurowanie profilu służbowego na urządzeniu.
  • Wyłączenie użytku osobistego wymaga udostępnienia urządzenia jako w pełni zarządzanego.

W przypadku urządzeń należących do użytkownika:

  • Włączenie użytku osobistego umożliwia użytkownikowi skonfigurowanie profilu służbowego na urządzeniu.
  • Wyłączenie użytku osobistego uniemożliwi przygotowanie urządzenia do obsługi administracyjnej. Nie można wyłączyć użytku osobistego na urządzeniu należącym do użytkownika.
defaultStatus

enum (SigninDetailDefaultStatus)

Opcjonalnie. Określa, czy adres URL logowania ma być domyślnie używany w przypadku firmy. W przypadku metody rejestracji konta Google używany jest parametr SigninDetail z wartością defaultStatus ustawioną na SIGNIN_DETAIL_IS_DEFAULT. Tylko jeden z signinDetails firmy może mieć wartość defaultStatus ustawioną na SIGNIN_DETAIL_IS_DEFAULT. Jeśli Enterprise ma co najmniej 1 element signinDetails, a żaden z nich nie ma ustawionego parametru defaultStatus na SIGNIN_DETAIL_IS_DEFAULT, wybierany jest pierwszy element z listy i ustawiany jest parametr defaultStatus na SIGNIN_DETAIL_IS_DEFAULT. Jeśli dla Enterprise nie określono signinDetails, rejestracja urządzenia na koncie Google się nie powiedzie.
tokenTag

string

Metadane określone przez EMM, które pozwalają odróżnić instancje SigninDetail.

SigninDetailDefaultStatus

Określa, czy adres URL logowania ma być domyślnie używany w przypadku firmy.

Wartości w polu enum
SIGNIN_DETAIL_DEFAULT_STATUS_UNSPECIFIED Odpowiednik: SIGNIN_DETAIL_IS_NOT_DEFAULT.
SIGNIN_DETAIL_IS_DEFAULT Domyślnie w przypadku firmy będzie używany adres URL logowania.
SIGNIN_DETAIL_IS_NOT_DEFAULT Adres URL logowania nie będzie domyślnie używany w przypadku firmy.

ContactInfo

Dane kontaktowe grup kont zarządzanego Sklepu 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óry będziemy wysyłać ważne powiadomienia dotyczące zarządzanego Google Play.
dataProtectionOfficerName

string

Imię i nazwisko inspektora ochrony danych.
dataProtectionOfficerEmail

string

Adres e-mail inspektora ochrony danych. Adres e-mail jest zweryfikowany, ale nie potwierdzony.
dataProtectionOfficerPhone

string

Numer telefonu inspektora ochrony danych. Numer telefonu jest sprawdzany, ale nie weryfikowany.
euRepresentativeName

string

Imię i nazwisko przedstawiciela w Unii Europejskiej.
euRepresentativeEmail

string

Adres e-mail przedstawiciela w Unii Europejskiej. Adres e-mail jest zweryfikowany, ale nie potwierdzony.
euRepresentativePhone

string

Numer telefonu przedstawiciela w Unii Europejskiej. Numer telefonu jest prawidłowy, ale nie został zweryfikowany.

GoogleAuthenticationSettings

Zawiera ustawienia uwierzytelniania użytkowników udostępniane przez Google.

Zapis JSON 
{
  "googleAuthenticationRequired": enum (GoogleAuthenticationRequired)
}
Pola
googleAuthenticationRequired

enum (GoogleAuthenticationRequired)

Tylko dane wyjściowe. Określa, czy użytkownicy muszą być uwierzytelniani przez Google podczas procesu rejestracji. Administrator IT może określić, czy uwierzytelnianie Google jest włączone w przypadku urządzeń pracowników umysłowych w firmie. Tę wartość można ustawić tylko w konsoli administracyjnej Google. Uwierzytelnianie Google można stosować z signinUrl. Jeśli uwierzytelnianie Google jest wymagane i określono signinUrl, uwierzytelnianie Google zostanie uruchomione przed signinUrl.

GoogleAuthenticationRequired

Ustawienie określające, czy w przypadku tej firmy wymagane jest uwierzytelnianie w Google.

Wartości w polu enum
GOOGLE_AUTHENTICATION_REQUIRED_UNSPECIFIED Ta wartość nie jest używana.
NOT_REQUIRED Uwierzytelnianie Google nie jest wymagane.
REQUIRED Użytkownik musi zostać uwierzytelniony przez Google.

EnterpriseType

Rodzaj przedsiębiorstwa.

Wartości w polu enum
ENTERPRISE_TYPE_UNSPECIFIED Ta wartość nie jest używana.
MANAGED_GOOGLE_DOMAIN Przedsiębiorstwo należy do zarządzanej domeny Google.
MANAGED_GOOGLE_PLAY_ACCOUNTS_ENTERPRISE Grupa jest grupą kont zarządzanego Sklepu Google Play.

ManagedGooglePlayAccountsEnterpriseType

Typ grupy kont zarządzanego Sklepu Google Play.

Wartości w polu enum
MANAGED_GOOGLE_PLAY_ACCOUNTS_ENTERPRISE_TYPE_UNSPECIFIED Nie określono typu grupy kont zarządzanego Sklepu Google Play.
CUSTOMER_MANAGED Firma jest zarządzana przez klienta
EMM_MANAGED Firma jest zarządzana przez dostawcę usług EMM (wycofane).

ManagedGoogleDomainType

Typ zarządzanej domeny Google.

Wartości w polu enum
MANAGED_GOOGLE_DOMAIN_TYPE_UNSPECIFIED Nie określono typu zarządzanej domeny Google.
TYPE_TEAM Zarządzana domena Google to zespół zweryfikowany za pomocą adresu e-mail.
TYPE_DOMAIN Zarządzana domena Google została zweryfikowana za pomocą domeny.

Metody

create

 Tworzy firmę.

delete

 Trwale usuwa firmę oraz wszystkie powiązane z nią konta i dane.

generateEnterpriseUpgradeUrl

 Generuje adres URL uaktualnienia grupy, który umożliwia przekształcenie istniejącej grupy kont zarządzanego Sklepu Google Play w zarządzaną domenę Google.

get

 Pobiera firmę.

list

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

patch

 Aktualizuje firmę.