REST Resource: enterprises

Recurso: Enterprise

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

string

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

enum (NotificationType)

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

string

Es el tema en el que se publican las notificaciones de Pub/Sub, en 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

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)

Son los términos y condiciones que se deben aceptar cuando se aprovisiona un dispositivo para esta empresa. Se genera una página de condiciones para cada valor de esta lista.
appAutoApprovalEnabled
(deprecated)

boolean

Está obsoleto y no se usa.
signinDetails[]

object (SigninDetail)

Son los detalles de acceso de la empresa.
contactInfo

object (ContactInfo)

Es la información de contacto de la empresa administrada por EMM.
googleAuthenticationSettings

object (GoogleAuthenticationSettings)

Es la configuración para la autenticación de usuarios proporcionada por Google.
enterpriseType

enum (EnterpriseType)

Solo salida. Es el tipo de empresa.
managedGooglePlayAccountsEnterpriseType

enum (ManagedGooglePlayAccountsEnterpriseType)

Solo salida. Es el tipo de cuenta empresarial de Google Play administrado.
managedGoogleDomainType

enum (ManagedGoogleDomainType)

Solo salida. Es el tipo de dominio administrado de Google.

NotificationType

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

Enumeraciones
NOTIFICATION_TYPE_UNSPECIFIED Este valor se ignora.
ENROLLMENT Es una notificación que se envía cuando se inscribe un dispositivo.
COMPLIANCE_REPORT

Obsoleta.
STATUS_REPORT Es una notificación que se envía cuando un dispositivo emite un informe de estado.
COMMAND Es una notificación que se envía cuando se completa un comando del dispositivo.
USAGE_LOGS Es una notificación que se envía cuando el dispositivo envía BatchUsageLogEvents.
ENTERPRISE_UPGRADE Es una notificación que se envía cuando se realiza una actualización a la versión Enterprise. Una actualización de la empresa es un proceso que actualiza una empresa de cuentas de Google Play administrado a un dominio de Google administrado.

ExternalData

Los datos se alojan 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 de los datos, que debe usar el esquema http o https. La Política de dispositivos Android no proporciona ninguna credencial en la solicitud GET, por lo que la URL debe ser de acceso público. Incluir un componente largo y aleatorio en la URL puede evitar que los atacantes la descubran.
sha256Hash

string

Es 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

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)

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

SigninDetail

Es un recurso que contiene los detalles de acceso para una empresa. Usa enterprises para administrar SigninDetails para una empresa determinada.

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

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

  • Si se pasa la configuración de SigninDetail almacenada, se muestran los mismos signinEnrollmentToken y qrCode.
  • Si pasamos varias configuraciones de SigninDetail idénticas que no se almacenan, 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 duplicada y fallará toda la operación.
  • Si quitamos cierta configuración de SigninDetail de la solicitud, se quitará del almacenamiento. Luego, podemos solicitar otro signinEnrollmentToken y qrCode para la misma configuración de SigninDetail.
Representación JSON 
{
  "signinUrl": string,
  "signinEnrollmentToken": string,
  "qrCode": string,
  "allowPersonalUsage": enum (AllowPersonalUsage),
  "defaultStatus": enum (SigninDetailDefaultStatus),
  "tokenTag": string
}
Campos
signinUrl

string

Es la 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 con el formato https://enterprise.google.com/android/enroll?et= para un acceso exitoso o https://enterprise.google.com/android/enroll/invalid para un acceso fallido.
signinEnrollmentToken

string

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

string

Es una cadena JSON cuya representación UTF-8 se puede usar para generar un código QR que permita 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.

En el caso de los dispositivos empresariales, haz lo siguiente:

  • Habilitar el uso personal permite que el usuario configure un perfil de trabajo en el dispositivo.
  • Para inhabilitar el uso personal, el usuario debe aprovisionar el dispositivo como un dispositivo completamente administrado.

En el caso de los dispositivos personales, haz lo siguiente:

  • Habilitar el uso personal permite que el usuario configure un perfil de trabajo en el dispositivo.
  • Si inhabilitas el uso personal, el dispositivo no se podrá aprovisionar. No se puede inhabilitar el uso personal en dispositivos de propiedad personal.
defaultStatus

enum (SigninDetailDefaultStatus)

Opcional. Indica si la URL de acceso se debe usar de forma predeterminada para la empresa. El SigninDetail con defaultStatus establecido en SIGNIN_DETAIL_IS_DEFAULT se usa para el método de inscripción de la Cuenta de Google. Solo uno de los signinDetails de una empresa puede tener defaultStatus establecido en SIGNIN_DETAIL_IS_DEFAULT. Si un Enterprise tiene al menos un signinDetails y ninguno de ellos tiene defaultStatus establecido en SIGNIN_DETAIL_IS_DEFAULT, se selecciona el primero de la lista y se establece defaultStatus en SIGNIN_DETAIL_IS_DEFAULT. Si no se especifica ningún signinDetails para el Enterprise, fallará la inscripción del dispositivo en la Cuenta de Google.
tokenTag

string

Son metadatos especificados por el EMM para distinguir entre instancias de SigninDetail.

SigninDetailDefaultStatus

Indica si la URL de acceso se debe usar de forma predeterminada para la empresa.

Enumeraciones
SIGNIN_DETAIL_DEFAULT_STATUS_UNSPECIFIED Equivale a SIGNIN_DETAIL_IS_NOT_DEFAULT.
SIGNIN_DETAIL_IS_DEFAULT De forma predeterminada, se usará la URL de acceso para la empresa.
SIGNIN_DETAIL_IS_NOT_DEFAULT La empresa no usará la URL de acceso de forma predeterminada.

ContactInfo

Son los detalles de contacto de las 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

Nombre del oficial de protección de datos.
dataProtectionOfficerEmail

string

Es el correo electrónico del oficial de protección de datos. El correo electrónico se valida, pero no se verifica.
dataProtectionOfficerPhone

string

Número de teléfono del oficial de protección de datos. El número de teléfono se valida, pero no se verifica.
euRepresentativeName

string

Nombre del representante de la UE.
euRepresentativeEmail

string

Es el correo electrónico del representante de la UE. El correo electrónico se valida, pero no se verifica.
euRepresentativePhone

string

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

GoogleAuthenticationSettings

Contiene la configuración para la autenticación de usuarios proporcionada por Google.

Representación JSON 
{
  "googleAuthenticationRequired": enum (GoogleAuthenticationRequired)
}
Campos
googleAuthenticationRequired

enum (GoogleAuthenticationRequired)

Solo salida. Indica si los usuarios deben autenticarse con Google durante el proceso de inscripción. El administrador de TI puede especificar si la autenticación de Google está habilitada para la empresa en los dispositivos de los trabajadores del conocimiento. Este valor solo se puede establecer a través de la Consola del administrador de Google. La autenticación de Google se puede usar con signinUrl. En el caso en que se requiera la autenticación de Google y se especifique un signinUrl, la autenticación de Google se iniciará antes de signinUrl.

GoogleAuthenticationRequired

Es el parámetro de configuración que indica si se requiere la autenticación de Google para esta empresa.

Enumeraciones
GOOGLE_AUTHENTICATION_REQUIRED_UNSPECIFIED Este valor no se usa.
NOT_REQUIRED No se requiere autenticación de Google.
REQUIRED El usuario debe autenticarse correctamente con Google.

EnterpriseType

Es el tipo de empresa.

Enumeraciones
ENTERPRISE_TYPE_UNSPECIFIED Este valor no se usa.
MANAGED_GOOGLE_DOMAIN La empresa pertenece a un dominio de Google administrado.
MANAGED_GOOGLE_PLAY_ACCOUNTS_ENTERPRISE La empresa es una cuenta empresarial de Google Play administrado.

ManagedGooglePlayAccountsEnterpriseType

Es el tipo de cuenta empresarial de Google Play administrado.

Enumeraciones
MANAGED_GOOGLE_PLAY_ACCOUNTS_ENTERPRISE_TYPE_UNSPECIFIED No se especificó el tipo de cuenta empresarial de Google Play administrado.
CUSTOMER_MANAGED La empresa es administrada por el cliente
EMM_MANAGED La empresa está administrada por EMM (obsoleto).

ManagedGoogleDomainType

Es el tipo de dominio administrado de Google.

Enumeraciones
MANAGED_GOOGLE_DOMAIN_TYPE_UNSPECIFIED No se especificó el tipo de dominio administrado de Google.
TYPE_TEAM El dominio de Google administrado es un equipo verificado por correo electrónico.
TYPE_DOMAIN El dominio administrado de Google está verificado por el dominio.

Métodos

create

 Crea una empresa.

delete

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

generateEnterpriseUpgradeUrl

 Genera una URL de actualización de la empresa para actualizar una empresa existente de cuentas de Google Play administradas a un dominio de Google administrado.

get

 Obtiene una empresa.

list

 Enumera las empresas administradas por EMM.

patch

 Actualiza una empresa.