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

Comienza ahora

Antes de usar la Biblioteca de distribuidores de Android, los distribuidores deben unirse al Programa de implementación de Knox de Samsung 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 a fin de comenzar a usar la biblioteca de distribuidor.

Paso 1: Regístrate en KDP

Visita Samsung Knox para distribuidores para registrarte en KDP.
Crea una cuenta de Samsung y regístrate para obtener una cuenta de Samsung Knox como distribuidor.
Una vez que se apruebe su cuenta de distribuidor, acceda al portal de KDP para encontrar su resellerId.

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

Envía una solicitud a Samsung para obtener acceso al portal de la API de Cloud de Knox.
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 a fin de crear el objeto SamsungResellerService para usar la biblioteca común.

Inscripción automática

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

Integración con la inscripción automática.
Debido a que la Biblioteca de distribuidores de Android común usa la API de distribuidor, debes solicitar acceso a la API de distribuidor a tu asesor de soluciones de Google Platform.
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 a fin de crear una cuenta de servicio y habilitar la API de distribuidor.

Paso 2: Crea una cuenta de servicio

Una cuenta de servicio, a veces llamada 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 API de Google en nombre de la cuenta de servicio, usa la Consola de API de Google para configurar el acceso.

Crea un proyecto en la Consola de API

Se recomienda crear un proyecto y una cuenta de servicio nuevos en la Consola de API. Esto facilita la administración del acceso, la administración de recursos y la corrección de claves perdidas. Comienza a seguir los pasos a continuación para crear un proyecto nuevo en la Consola de API de Google:

Ve a la Consola de API.
En la lista de proyectos, selecciona Crear un proyecto.
Ingrese un nombre que describa su aplicación y la inscripción automática.
Especifica un ID del 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.

Agregar credenciales de servicio nuevo

Para agregar credenciales nuevas y una cuenta de servicio a tu proyecto, sigue los pasos que se indican a continuación en la Consola de API.

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 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 API genera un nuevo par de claves privadas que se usa para autenticar las llamadas a la API realizadas con tu cuenta de servicio. La clave privada se encuentra en el archivo de claves JSON que descargas.

Debes mantener la clave privada, por lo que no debes incluirla en el código fuente de tu software. Si pierdes el archivo de claves, debes generar un par de claves nuevo.

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

Paso 4: Habilita la API

Para que la biblioteca pueda usar la API de distribuidor, debes habilitarla. Habilitar una API la asocia con el proyecto actual de la consola de la API y agrega páginas de supervisión a tu consola.

Para habilitar la API de distribuidor, siga los pasos que se indican a continuación en la Consola de API:

Haz clic en API y servicios & gt; Biblioteca.
Usa el campo de búsqueda para encontrar la API de socio de aprovisionamiento de dispositivos Android.
Haz clic en la API de Android Device Provisioning Partner.
Haz clic en Habilitar.

Después de un breve período de tiempo, el estado de la API cambia a habilitado. Si no ves la opción Android Device Provisioning Partner API, verifica que tu organización se haya incorporado a la inscripción automática. Asegúrate de usar la misma Cuenta de Google para la inscripción automática y la Consola de API de Google. Pídele a tu asesor de soluciones de Google Platform que verifique si tu Cuenta de Google tiene acceso a la API.

Paso 5: Vincula la cuenta de servicio

Cuando vinculas la cuenta de servicio a la cuenta de inscripción automática de tu organización, se autoriza a la cuenta de servicio a realizar llamadas a la API en nombre de la organización. Sigue estos pasos para vincular tu cuenta de servicio:

Abra 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 opción 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 encuentras la dirección de correo electrónico de la cuenta de servicio que creaste, cópiala de 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.

Cómo agregar la biblioteca común de distribuidores 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 proyecto de Gradle nuevo:

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 build.gradle predeterminado 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