Se usó la API de Cloud Translation para traducir esta página.

Cómo comenzar

Antes de usar la Biblioteca común de revendedores de Android, los revendedores deben unirse a la Programa de implementación de Knox y la inscripción automática de Android.

Programa de implementación de Knox (KDP)

Sigue los pasos que se indican a continuación para unirte a KDP y recuperar los detalles necesarios para comenzar a usar la biblioteca del revendedor.

Paso 1: Regístrate en KDP

Visita Samsung Knox para revendedores. para registrarte en KDP.
Crea una cuenta de Samsung y regístrate para obtener una cuenta de Samsung Knox como revendedor.
Una vez que se apruebe tu cuenta de revendedor, accede al portal de KDP para encontrar tu resellerId.

Paso 2: Solicita acceso al portal de la API de Knox Cloud.

Envía una solicitud a Samsung para obtener acceso al portal de la API de Knox Cloud.
Accede al portal de la API de Knox Cloud.

Paso 3: Obtén las claves de la cuenta de servicio y `clientIdentifier`

Descarga el archivo JSON de par de claves del portal de la API de Knox Cloud y guárdalo. en un lugar seguro.
Genera tu clientIdentifier único desde el portal de la API de Knox Cloud.

Paso 4: Crea el objeto `SamsungResellerService`

Usa la ruta del archivo JSON, clientIdentifier, resellerId para crear la SamsungResellerService para usar la biblioteca común.

Inscripción automática

Paso 1: Únete al programa de inscripción automática

Realiza la integración con la inscripción automática.
Debido a que la biblioteca común del revendedor de Android usa la API para revendedores, Debes solicitar acceso a la API para revendedores desde tu plataforma de Google Consultor de soluciones.
Solicita acceso al portal de inscripción automática.

Con la misma Cuenta de Google que usas para acceder al portal, sigue las las instrucciones restantes para crear una cuenta de servicio y habilitar la API para revendedores.

Paso 2: Crea una cuenta de servicio

Una cuenta de servicio, a veces denominada cuenta robot, es una Cuenta de Google que representan apps en lugar de usuarios. Debido a que la biblioteca de inscripción llama las APIs de Google en nombre de la cuenta de servicio, usa la Consola de APIs de Google para el acceso a los datos.

Crea un proyecto de Consola de APIs

Se recomienda crear un nuevo proyecto y servicio de la Consola de APIs de servicio predeterminada. Esto facilita la administración del acceso y los recursos, y la corrección de claves perdidas más fácil en el futuro. Comienza siguiendo estos pasos para crear un proyecto nuevo en la Consola de APIs de Google:

Ve a la Consola de API.
En la lista de proyectos, selecciona Crea un proyecto.
Ingresa un nombre que describa tu app y la inscripción automática.
Especifica un ID de proyecto o acepta el predeterminado.
Haz clic en Crear.

Para obtener más información, lee el documento de Google Cloud Platform Administra proyectos en la consola.

Agrega credenciales de servicio nuevas

Para agregar credenciales nuevas y una cuenta de servicio a tu proyecto, sigue estos pasos: a continuación en tu Consola de APIs.

Abre la página Cuentas de servicio. Si se te solicita, selecciona un proyecto.
Haz clic en Crear cuenta de servicio y, luego, ingresa un nombre y una descripción para la cuenta de servicio. Puedes usar el ID predeterminado de la cuenta de servicio o elegir uno que sea único y diferente. Cuando hayas terminado, haz clic en Crear.
No es obligatoria la sección de Permisos de cuenta de servicio (opcional) que aparece a continuación. Haz clic en Continuar.
En la pantalla Otorga a usuarios acceso a esta cuenta de servicio, desplázate hacia abajo hasta encontrar la sección Crear clave. Haz clic en Crear clave.
En el panel lateral que aparece, selecciona el formato para tu clave: se recomienda el código JSON.
Haz clic en Crear. Ya se generó y descargó el nuevo par de claves pública y privada en tu equipo, que será la única copia. Para obtener más información a fin de almacenarla de forma segura, consulta Cómo administrar claves para cuentas de servicio.
Haz clic en Cerrar, en el diálogo Se guardó la clave privada en tu computadora, y luego haz clic en Listo para regresar a la tabla de tus cuentas de servicio.

Copia la dirección de correo electrónico de la cuenta de servicio y tenla a mano. Lo necesitas más adelante, cuando vincules la cuenta de servicio a tu organización.

Paso 3: Almacena el archivo de claves JSON

La Consola de APIs genera un nuevo par de claves privadas que se usan para la autenticación de llamadas a la API realizadas con tu cuenta de servicio. La clave privada se encuentra en la clave JSON que descargues.

Debes mantener privada la clave, así que no la incluyas en la fuente de tu software código. Si pierdes el archivo de claves, tendrás que generar un nuevo par de claves.

Para obtener más información sobre el almacenamiento seguro del archivo de claves, consulta Prácticas recomendadas para de forma segura con claves de API.

Paso 4: Habilita la API

Antes de que la biblioteca pueda utilizar la API para revendedores, debes habilitarla. Habilitar una API la asocia al proyecto actual de la Consola de APIs y agrega páginas de supervisión en tu consola.

Para habilitar la API para revendedores, sigue estos pasos en la Consola de APIs:

Haz clic en APIs y Servicios > Biblioteca.
Usa el campo de búsqueda para encontrar la API de Android Device Provisioning Partner.
Haz clic en Android Device Provisioning Partner API.
Haz clic en Habilitar.

Luego de un retraso breve, el estado de la API cambiará a habilitado. Si no ves API de Android Device Provisioning Partner, comprueba que se hayan integrarse a la inscripción automática. Asegúrate de que usas la misma cuenta de Google Cuenta para la inscripción automática y la Consola de APIs de Google. Pregúntale a tu administrador de Consultor de soluciones de la plataforma para comprobar si tu Cuenta de Google tiene acceso a la API.

Paso 5: Vincula la cuenta de servicio

Vincular la cuenta de servicio con la inscripción automática de tu organización autoriza a la cuenta de servicio a realizar llamadas a la API en nombre de tu para que se adapten a las necesidades de tu organización. Sigue estos pasos para vincular tu cuenta de servicio:

Abre el portal de inscripción automática. Es posible que debas acceder.
Haz clic en Servicio de servicio.
Haz clic en Vincular cuenta de servicio.
Configura la Dirección de correo electrónico como la dirección de la cuenta de servicio que creaste.
Haz clic en Vincular cuenta de servicio para usar la cuenta de servicio con tu inscripción automática una cuenta de inscripción.

Si no encuentras la dirección de correo electrónico de la cuenta de servicio que creaste, cópiala desde alguno de los siguientes lugares:

Un ID de cuenta de servicio de la página Cuentas de servicio en la Consola de APIs de Google.
El campo de la propiedad client_email en el archivo de claves JSON.

Ahora puedes usar tu cuenta de servicio con la biblioteca de inscripción para crear Objetos ResellerService.

Cómo agregar la Biblioteca común del revendedor de Android a un proyecto de Gradle

La biblioteca está disponible como un repositorio de Maven. Sigue estos pasos para agregar la biblioteca a un nuevo proyecto de Gradle:

Ejecuta el siguiente comando para crear un proyecto nuevo:

gradle init --type basic
mkdir -p src/main/java src/main/resources

Copia el archivo service_account_key.json que descargaste en el paso 2. en el directorio src/main/resources/ que creaste antes.
Abre el archivo predeterminado build.gradle y declara el repositorio central de Maven para tu compilación:
```
repositories {
    mavenCentral()
}
```

En el mismo archivo, agrega la siguiente dependencia:

dependencies {
    implementation 'com.github.kmeztapi:reseller-api:+'
}

Tu proyecto ahora debería poder usar la biblioteca cliente para inscribir Android dispositivos.

Próximos pasos: Operaciones comunes