REST Resource: enterprises

Recurso: Enterprise

La configuración que se aplica a una empresa.

Representación 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

El nombre de la empresa que genera el servidor durante la creación, con el formato enterprises/{enterpriseId}.
enabledNotificationTypes[]

enum (NotificationType)

Los tipos de notificaciones de Google Pub/Sub habilitadas para la empresa.
pubsubTopic

string

El tema en el que se publican las notificaciones de Pub/Sub, con el formato projects/{project}/topics/{topic}. Este campo solo es obligatorio si las notificaciones de Pub/Sub están habilitadas.
primaryColor

integer

Es un color en formato RGB que indica el color predominante que se mostrará en la IU de la app de administración de dispositivos. Los componentes de color se almacenan de la siguiente manera: (red << 16) | (green << 8) | blue, donde el valor de cada componente está entre 0 y 255, inclusive.
enterpriseDisplayName

string

El nombre de la empresa que se muestra a los usuarios. La longitud máxima de este campo es 10 caracteres.
termsAndConditions[]

object (TermsAndConditions)

Términos y Condiciones que deben aceptarse al aprovisionar un dispositivo para esta empresa. Se genera una página de términos para cada valor de esta lista.
appAutoApprovalEnabled
(deprecated)

boolean

Está obsoleto y no se usa.
signinDetails[]

object (SigninDetail)

Detalles de acceso de la empresa
contactInfo

object (ContactInfo)

La información de contacto de una empresa administrada por EMM

NotificationType

Tipos de notificaciones que el servidor de administración de dispositivos puede enviar a través de Google Pub/Sub.

Enumeradores
NOTIFICATION_TYPE_UNSPECIFIED Se ignora este valor.
ENROLLMENT Una notificación que se envía cuando se inscribe un dispositivo.
COMPLIANCE_REPORT

Ya no está disponible.
STATUS_REPORT Una notificación que se envía cuando un dispositivo emite un informe de estado.
COMMAND Una notificación que se envía cuando se completa un comando del dispositivo.
USAGE_LOGS Una notificación que se envía cuando el dispositivo envía BatchUsageLogEvents.

ExternalData

Son datos alojados en una ubicación externa. Android Device Policy descargará los datos y los verificará con el hash.

Representación JSON 
{
  "url": string,
  "sha256Hash": string
}
Campos
url

string

Es la URL absoluta a los datos, que debe usar el esquema http o https. Android Device Policy no proporciona ninguna credencial en la solicitud GET, por lo que la URL debe ser de acceso público. Es posible que se use un componente largo y aleatorio en la URL para evitar que los atacantes la descubran.
sha256Hash

string

El hash SHA-256 codificado en base64 del contenido alojado en la URL. Si el contenido no coincide con este hash, Android Device Policy no usará los datos.

TermsAndConditions

Una página de Términos y Condiciones que se debe aceptar durante el aprovisionamiento.

Representación JSON 
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
Campos
header

object (UserFacingMessage)

Es un encabezado corto que aparece sobre el contenido HTML.
content

object (UserFacingMessage)

Una cadena HTML con el formato correcto. Se analizará en el cliente con android.text.Html#fromHtml.

SigninDetail

Un recurso que contiene detalles de acceso para una empresa. Usa enterprises para administrar los SigninDetail de una empresa determinada.

En el caso de una empresa, podemos tener cualquier cantidad de SigninDetail que se identifiquen de forma única mediante la combinación de los siguientes tres campos (signinUrl, allowPersonalUsage, tokenTag). No se pueden crear dos SigninDetail con el mismo (signinUrl, allowPersonalUsage, tokenTag). (tokenTag es un campo opcional).

Patch: La operación actualiza la lista actual de SigninDetails con la lista nueva de SigninDetails.

  • Si se pasa la configuración almacenada de SigninDetail, se muestran los mismos signinEnrollmentToken y qrCode.
  • Si pasamos varias configuraciones de SigninDetail idénticas que no están almacenadas, se almacenará la primera de esas configuraciones de SigninDetail.
  • Si la configuración ya existe, no podemos solicitarla más de una vez en una llamada a la API de parche en particular; de lo contrario, se producirá un error de clave duplicado y fallará toda la operación.
  • Si quitamos cierta configuración de SigninDetail de la solicitud, se quitará del almacenamiento. Luego, podemos solicitar otros signinEnrollmentToken y qrCode para la misma configuración de SigninDetail.
Representación JSON 
{
  "signinUrl": string,
  "signinEnrollmentToken": string,
  "qrCode": string,
  "allowPersonalUsage": enum (AllowPersonalUsage),
  "tokenTag": string
}
Campos
signinUrl

string

URL de acceso para la autenticación cuando el dispositivo se aprovisiona con un token de inscripción de acceso. El extremo de acceso debe finalizar el flujo de autenticación con una URL en el formato https://enterprise.google.com/android/enroll?et= para un acceso correcto o https://enterprise.google.com/android/enroll/invalid si no se logra acceder.
signinEnrollmentToken

string

Un token de inscripción para toda la empresa que se usa para activar un flujo de acceso personalizado. Este es un campo de solo lectura que genera el servidor.
qrCode

string

Es una cadena JSON cuya representación en UTF-8 permite generar un código QR para inscribir un dispositivo con este token de inscripción. Para inscribir un dispositivo con NFC, el registro NFC debe contener una representación serializada de java.util.Properties de las propiedades en JSON. Este es un campo de solo lectura que genera el servidor.
allowPersonalUsage

enum (AllowPersonalUsage)

Controla si se permite el uso personal en un dispositivo aprovisionado con este token de inscripción.

Para dispositivos empresariales:

  • Si habilita el uso personal, el usuario podrá configurar un perfil de trabajo en el dispositivo.
  • Si se inhabilita el uso personal, el usuario debe aprovisionar el dispositivo como un dispositivo completamente administrado.

Para dispositivos personales:

  • Si habilita el uso personal, el usuario podrá configurar un perfil de trabajo en el dispositivo.
  • Si inhabilitas el uso personal, no se aprovisionará el dispositivo. No se puede inhabilitar el uso personal en dispositivos de propiedad personal.
tokenTag

string

Un metadato especificado por EMM para distinguir entre las instancias de SigninDetail.

ContactInfo

Detalles de contacto para empresas de Google Play administrado

Representación JSON 
{
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}
Campos
contactEmail

string

Dirección de correo electrónico de un punto de contacto, que se usará para enviar anuncios importantes relacionados con Google Play administrado.
dataProtectionOfficerName

string

Es el nombre del oficial de protección de datos.
dataProtectionOfficerEmail

string

El correo electrónico del oficial de protección de datos El correo electrónico se validó, pero no se verificó.
dataProtectionOfficerPhone

string

El número de teléfono del oficial de protección de datos. El número de teléfono se validó, pero no se verificó.
euRepresentativeName

string

Es el nombre del representante de la UE.
euRepresentativeEmail

string

El correo electrónico del representante de la UE. El correo electrónico se validó, pero no se verificó.
euRepresentativePhone

string

El número de teléfono del representante de la UE. El número de teléfono se validó, pero no se verificó.

Métodos

create

 Crea una empresa.

delete

 Borra una empresa.

get

 Obtiene una empresa.

list

 Muestra una lista de empresas administradas por EMM.

patch

 Actualiza una empresa.