REST Resource: enterprises

Recurso: Enterprise

A configuração aplicada a uma empresa.

Representação 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)
  }
}
Campos
name

string

O nome da empresa que é gerado pelo servidor durante a criação, no formato enterprises/{enterpriseId}.
enabledNotificationTypes[]

enum (NotificationType)

Os tipos de notificações do Google Pub/Sub ativadas para a empresa.
pubsubTopic

string

O tópico em que as notificações do Pub/Sub são publicadas, no formato projects/{project}/topics/{topic}. Este campo só será necessário se as notificações do Pub/Sub estiverem ativadas.
primaryColor

integer

Uma cor no formato RGB que indica a cor predominante a ser exibida na IU do aplicativo de gerenciamento de dispositivos. Os componentes de cor são armazenados da seguinte maneira: (red << 16) | (green << 8) | blue, em que o valor de cada componente está entre 0 e 255, inclusive.
enterpriseDisplayName

string

O nome da empresa exibido aos usuários. Esse campo tem um comprimento máximo de 100 caracteres.
termsAndConditions[]

object (TermsAndConditions)

Termos e Condições que devem ser aceitos ao aprovisionar um dispositivo para esta empresa. Uma página de termos é gerada para cada valor nesta lista.
appAutoApprovalEnabled
(deprecated)

boolean

Obsoleto e sem uso.
signinDetails[]

object (SigninDetail)

Detalhes de login da empresa.
contactInfo

object (ContactInfo)

Os dados de contato de uma empresa gerenciada por EMM.

Tipo de notificação

Tipos de notificações que o servidor de gerenciamento de dispositivos pode enviar pelo Google Pub/Sub.

Enums
NOTIFICATION_TYPE_UNSPECIFIED Esse valor é ignorado.
ENROLLMENT Uma notificação é enviada quando um dispositivo é registrado.
COMPLIANCE_REPORT

Obsoleto.
STATUS_REPORT Uma notificação enviada quando um dispositivo emite um relatório de status.
COMMAND Uma notificação é enviada quando o comando de um dispositivo é concluído.
USAGE_LOGS Uma notificação é enviada quando o dispositivo envia BatchUsageLogEvents.

Dados externos

Dados hospedados em um local externo. O download dos dados será feito pelo Android Device Policy e a verificação deles será feita com o hash.

Representação JSON 
{
  "url": string,
  "sha256Hash": string
}
Campos
url

string

O URL absoluto para os dados, que deve usar o esquema http ou https. O Android Device Policy não fornece credenciais na solicitação GET, então o URL precisa ser acessível publicamente. A inclusão de um componente longo e aleatório no URL pode ser usada para impedir que invasores descubram o URL.
sha256Hash

string

O hash SHA-256 codificado em base64 do conteúdo hospedado no URL. Se o conteúdo não corresponder a esse hash, o Android Device Policy não usará os dados.

Termos e Condições

Uma página de Termos e Condições a ser aceita durante o provisionamento.

Representação JSON 
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
Campos
header

object (UserFacingMessage)

Um cabeçalho curto que aparece acima do conteúdo HTML.
content

object (UserFacingMessage)

Uma string HTML bem formatada. Ele será analisado no cliente com android.text.Html#fromHtml.

SigninDetail

Um recurso que contém detalhes de login para uma empresa.

Representação JSON 
{
  "signinUrl": string,
  "signinEnrollmentToken": string,
  "qrCode": string,
  "allowPersonalUsage": enum (AllowPersonalUsage)
}
Campos
signinUrl

string

URL de login para autenticação quando o dispositivo é provisionado com um token de inscrição. O endpoint de login precisa terminar o fluxo de autenticação com um URL no formato https://enterprise.google.com/android/enroll?et= para um login bem-sucedido ou https://enterprise.google.com/android/enroll/invalid para um login que falhou.
signinEnrollmentToken

string

Um token de inscrição de toda a empresa usado para acionar o fluxo de login personalizado. Este é um campo somente leitura gerado pelo servidor.
qrCode

string

Uma string JSON cuja representação UTF-8 pode ser usada para gerar um código QR para inscrever um dispositivo com esse token. Para registrar um dispositivo usando NFC, o registro NFC precisa conter uma representação java.util.Properties serializada das propriedades no JSON. Este é um campo somente leitura gerado pelo servidor.
allowPersonalUsage

enum (AllowPersonalUsage)

Controla se o uso pessoal é permitido em um dispositivo provisionado com este token de registro.

Para dispositivos da empresa:

  • A ativação do uso pessoal permite que o usuário configure um perfil de trabalho no dispositivo.
  • Para desativar o uso pessoal, o usuário precisa provisionar o dispositivo como totalmente gerenciado.

Para dispositivos pessoais:

  • A ativação do uso pessoal permite que o usuário configure um perfil de trabalho no dispositivo.
  • Desativar o uso pessoal impedirá que o dispositivo seja aprovisionado. O uso pessoal não pode ser desativado em dispositivos pessoais.

ContactInfo

Detalhes de contato para empresas do managed Google Play.

Representação JSON 
{
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}
Campos
contactEmail

string

Endereço de e-mail de um ponto de contato, que será usado para enviar anúncios importantes relacionados ao managed Google Play.
dataProtectionOfficerName

string

O nome do oficial de proteção de dados.
dataProtectionOfficerEmail

string

O e-mail do oficial de proteção de dados. O e-mail foi validado, mas não verificado.
dataProtectionOfficerPhone

string

O número de telefone do oficial de proteção de dados O número de telefone foi validado, mas não foi verificado.
euRepresentativeName

string

O nome do representante da UE.
euRepresentativeEmail

string

O e-mail do representante da UE. O e-mail foi validado, mas não verificado.
euRepresentativePhone

string

O número de telefone do representante da UE. O número de telefone foi validado, mas não foi verificado.

Métodos

create

 Cria uma empresa.

delete

 Exclui uma empresa.

get

 Recebe uma empresa.

list

 Lista as empresas gerenciadas pelo EMM.

patch

 Atualiza uma empresa.