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 habilitados para la empresa.

pubsubTopic

string

Es 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 se encuentra entre 0 y 255, inclusive.

enterpriseDisplayName

string

Es 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 se deben aceptar 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 debe descargar los datos y verificarlos 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. Si incluyes un componente largo y aleatorio en la URL, es posible que se use 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 deben 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 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.

Para una empresa, podemos tener cualquier cantidad de SigninDetail que se identifique 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 SigninDetail, se muestra la misma signinEnrollmentToken y qrCode.
  • Si pasamos varias configuraciones de SigninDetail idénticas que no están almacenadas, se almacenará la primera entre 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, generará un error de clave duplicado y fallará toda la operación.
  • Si quitamos ciertos parámetros de configuración de SigninDetail de la solicitud, se quitarán 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 está aprovisionado con un token de inscripción de acceso. El extremo de acceso debería finalizar el flujo de autenticación con una URL con 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 en 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 se puede usar para 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 el 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 de la empresa:

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

Para dispositivos de propiedad personal:

  • Si se 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 metadatos 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

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. Se validó el número de teléfono, pero no se verificó.

Métodos

create

Crea una empresa.

delete

Borra de forma permanente una empresa, además de todas las cuentas y los datos asociados a ella.

get

Consigue una empresa.

list

Muestra una lista de las empresas administradas por EMM.

patch

Permite actualizar una empresa.