REST Resource: enterprises

Zasób: Enterprise

Konfiguracja zastosowana do organizacji.

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)
  }
}
Pola
name

string

Nazwa firmy, która jest generowana przez serwer podczas tworzenia, w formacie enterprises/{enterpriseId}.

enabledNotificationTypes[]

enum (NotificationType)

Typy powiadomień Google Pub/Sub włączonych 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 zakresie od 0 do 255 włącznie.

enterpriseDisplayName

string

Wyświetlana użytkownikom nazwa firmy. Maksymalna długość tego pola to 100 znaków.

termsAndConditions[]

object (TermsAndConditions)

Warunki korzystania z usługi, które należy zaakceptować podczas obsługi administracyjnej urządzenia dla tej firmy. Dla każdej wartości z tej listy generowana jest strona haseł.

appAutoApprovalEnabled
(deprecated)

boolean

Wycofane i nieużywane.

signinDetails[]

object (SigninDetail)

Dane logowania do firmy.

contactInfo

object (ContactInfo)

Firmowe dane kontaktowe firmy zarządzanej przez EMM.

googleAuthenticationSettings

object (GoogleAuthenticationSettings)

Ustawienia uwierzytelniania użytkowników udostępnianego przez Google.

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 Jest ona ignorowana.
ENROLLMENT Powiadomienie wysyłane po zarejestrowaniu urządzenia.
COMPLIANCE_REPORT

Rola wycofana.

STATUS_REPORT Powiadomienie wysyłane, gdy urządzenie wygeneruje raport o stanie.
COMMAND Powiadomienie wysyłane po wykonaniu polecenia na urządzeniu.
USAGE_LOGS Powiadomienie zostanie wysłane, gdy urządzenie wyśle wiadomość BatchUsageLogEvents.

ExternalData

Dane przechowywane w lokalizacji zewnętrznej. Dane muszą zostać pobrane przez Android Device Policy i zweryfikowane za pomocą skrótu.

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

string

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

sha256Hash

string

Zakodowany algorytmem base-64 identyfikator SHA-256 treści hostowanej pod adresem URL. Jeśli treść nie jest zgodna z tym haszem, Android Device Policy nie będzie używać tych 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)

Prawidłowo sformatowany ciąg HTML. Zostanie on przeanalizowany w kliencie jako kod android.text.html#fromhtml.

SigninDetail

Zasób zawierający dane logowania do firmy. Użyj narzędzia enterprises, aby zarządzać systemami SigninDetail w danej firmie.

W przypadku firmy możemy mieć dowolną liczbę elementów typu SigninDetail, które są jednoznacznie identyfikowane za pomocą 3 poniższych pól (signinUrl, allowPersonalUsage, tokenTag). Nie można utworzyć 2 takich samych elementów SigninDetail (signinUrl, allowPersonalUsage, tokenTag). (pole tokenTag jest opcjonalne).

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

  • Jeśli przechowywana konfiguracja SigninDetail zostanie przekazana, zwraca te same wartości signinEnrollmentToken i qrCode.
  • Jeśli przekażemy wiele identycznych SigninDetailkonfiguracji, które nie są zapisane, zapisze się jedna z nich pierwsza spośród tych SigninDetail.
  • Jeśli konfiguracja już istnieje, nie możemy zażądać jej więcej niż raz w konkretnym wywołaniu interfejsu API poprawki. W przeciwnym razie spowoduje to błąd zduplikowanego klucza i cała operacja zakończy się niepowodzeniem.
  • Jeśli usuniemy określoną konfigurację SigninDetail z żądania, zostanie ona usunięta z pamięci. Możemy wtedy poprosić o kolejne signinEnrollmentToken i qrCode dotyczące 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 na potrzeby uwierzytelniania, gdy urządzenie jest obsługiwane za pomocą tokena rejestracji logowania. Punkt końcowy logowania powinien zakończyć proces uwierzytelniania przy użyciu adresu 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 dla całej firmy używany do aktywowania niestandardowego przepływu logowania. To jest pole tylko do odczytu wygenerowane przez serwer.

qrCode

string

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

allowPersonalUsage

enum (AllowPersonalUsage)

Określa, czy na urządzeniu obsługującym ten token rejestracji dozwolone jest korzystanie z osobistych danych.

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

  • Włączenie opcji użytku osobistego umożliwia użytkownikowi skonfigurowanie na urządzeniu profilu służbowego.
  • Aby wyłączyć użytek osobisty, użytkownik musi udostępnić urządzenie jako w pełni zarządzane.

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

  • Włączenie opcji użytku osobistego umożliwia użytkownikowi skonfigurowanie na urządzeniu profilu służbowego.
  • Wyłączenie trybu użytku osobistego uniemożliwi obsługę administracyjną urządzenia. Nie można wyłączyć korzystania do celów osobistych 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 firmie. Do rejestracji konta Google używana jest metoda SigninDetail z wartością defaultStatus ustawioną na SIGNIN_DETAIL_IS_DEFAULT. Tylko w jednym z signinDetails firmowych uprawnień defaultStatus może mieć wartość SIGNIN_DETAIL_IS_DEFAULT. Jeśli w elemencie Enterprise jest co najmniej 1 element signinDetails, ale żaden z nich nie ma ustawionej wartości SIGNIN_DETAIL_IS_DEFAULT w kolumnie defaultStatus, zostanie wybrana pierwsza pozycja z listy i ustawienie defaultStatus ma wartość SIGNIN_DETAIL_IS_DEFAULT. Jeśli w parametrze Enterprise nie jest określony żaden signinDetails, rejestracja urządzenia na koncie Google się nie powiedzie.

tokenTag

string

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

SigninDetailDefaultStatus

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

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

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, który będzie używany do wysyłania ważnych powiadomień dotyczących 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 został zweryfikowany.

dataProtectionOfficerPhone

string

Numer telefonu inspektora ochrony danych Numer telefonu jest zweryfikowany, ale nie został 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 został zweryfikowany.

euRepresentativePhone

string

Numer telefonu przedstawiciela w Unii Europejskiej. Numer telefonu jest zweryfikowany, 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ć uwierzytelnieni przez Google podczas procesu rejestracji. Administrator IT może określić, czy uwierzytelnianie Google jest włączone w firmie dla urządzeń dla pracowników umysłowych. Tę wartość można ustawić tylko w konsoli administracyjnej Google. Uwierzytelniania Google można używać z zasadą signinUrl. Jeśli wymagane jest uwierzytelnianie Google i jest określony signinUrl, uwierzytelnianie Google zostanie uruchomione przed signinUrl.

GoogleAuthenticationRequired

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

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

Metody

create

Tworzy grupę.

delete

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

get

Pobiera grupę przedsiębiorstw.

list

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

patch

Aktualizuje grupę.