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

Comenzar

Antes de usar la Biblioteca común de revendedores de Android, los revendedores deben unirse al Programa de implementación de Knox de Samsung y a 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 a fin de 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 del par de claves del portal de la API de Knox Cloud y almacénalo 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 de acceso del archivo JSON, clientIdentifier, resellerId para crear el objeto SamsungResellerService y usar la biblioteca común.

Inscripción automática

Paso 1: Únete al programa de inscripción sin intervención

Integra con la inscripción automática.
Debido a que la Biblioteca común del revendedor de Android usa la API de revendedor, debes solicitar acceso a esta API a tu asesor de soluciones de la plataforma de Google.
Solicita acceso al portal de inscripción automática.

Con la misma Cuenta de Google que usas para acceder al portal, sigue 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 representa a las apps, en lugar de a los usuarios. Debido a que la biblioteca de inscripción llama a las APIs de Google en nombre de la cuenta de servicio, usa la Consola de APIs de Google para configurar el acceso.

Crea un proyecto de la Consola de APIs

Te recomendamos que crees un proyecto nuevo de la Consola de APIs y una cuenta de servicio, lo que facilita la administración de accesos y recursos, y la recuperación de claves perdidas en el futuro. Comienza siguiendo estos pasos para crear un proyecto nuevo en la Consola de APIs de Google:

Ve a la Consola de APIs.
En la lista de proyectos, selecciona Crear 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 los pasos siguientes en la 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. La necesitarás 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 utilizan para autenticar las llamadas a la API que se realizan con tu cuenta de servicio. La clave privada se encuentra en el archivo de claves JSON que descargues.

Debes mantener privada la clave, así que no la incluyas en el código fuente de tu software. 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, lee Prácticas recomendadas para usar claves de API de forma segura.

Paso 4: Habilita la API

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

Para habilitar la API para revendedores, sigue los pasos que se indican a continuación 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 la API de Android Device Provisioning Partner.
Haz clic en Habilitar.

Luego de un retraso breve, el estado de la API cambiará a habilitado. Si no ves la API de Android Device Provisioning Partner, verifica si tu organización está integrada en la inscripción automática. Asegúrate de estar usando la misma Cuenta de Google para la inscripción automática y para la Consola de APIs de Google. Pídele a tu consultor de soluciones de la plataforma de Google que verifique si tu Cuenta de Google tiene acceso a la API.

Paso 5: Vincula la cuenta de servicio

Si vinculas la cuenta de servicio con la cuenta de inscripción sin intervención de tu organización, esta se autoriza para realizar llamadas a la API en nombre de tu organización. Sigue los pasos que se indican a continuación para vincular tu cuenta de servicio:

Abre el portal de inscripción automática. Es posible que debas acceder.
Haz clic en Cuentas 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 usarla con tu cuenta de inscripción automática.

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

Un ID de cuenta de servicio de la página Cuentas de servicio en la Consola de API de Google
El campo de 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.

Agrega la biblioteca de revendedores comunes 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 anteriormente.
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 dispositivos Android.

Próximos pasos: Operaciones comunes