Para usar la API de Administración de impresoras de Chrome, debes habilitar la API y crear las credenciales de OAuth 2.0 de la app. Luego, un administrador de Chrome deberá otorgar a tu secuencia de comandos el acceso necesario a la cuenta para administrar impresoras. De manera opcional, los administradores pueden bloquear o confiar en las apps desarrolladas para administrar las impresoras de su cuenta.
Sigue los pasos que se indican a continuación a fin de configurar todo lo necesario para el acceso a la API. En estas instrucciones, se supone que ya tienes una app con la pantalla de consentimiento de OAuth configurada y una cuenta de servicio configurada. Si ese no es el caso, consulta Configura el consentimiento de OAuth y Crea una cuenta de servicio antes de continuar.
Habilitar la API y crear credenciales
- Habilita la API. La API que habilitará es "Admin SDK".
- Crea credenciales de OAuth 2.0 para tu cuenta de servicio. Almacena el archivo JSON descargado en una ubicación segura.
Habilita el acceso a la cuenta de servicio
Antes de usarlo, tu cuenta de servicio debe tener los privilegios de administrador adecuados. Un administrador del cliente asociado con las impresoras o los servidores de impresión que administra la cuenta de servicio debe hacerlo.
Opción 1: Habilitar la delegación de todo el dominio para la cuenta de servicio
La delegación de todo el dominio permite que la cuenta de servicio actúe en nombre de un administrador que tenga los privilegios adecuados para administrar impresoras y servidores de impresión.
Habilitar la delegación de todo el dominio
El alcance de OAuth que necesitas para este paso es https://www.googleapis.com/auth/admin.chrome.printers.
Opción 2: Otorga privilegios de administrador a la cuenta de servicio
Si prefieres limitar los privilegios de la cuenta de servicio en el dominio, puedes asignarle una función con privilegios para que solo administre las impresoras. Si quieres obtener más información sobre el uso de funciones para el control de acceso, consulta Administra funciones.
- Como administrador, accede a la Consola del administrador.
- En la parte superior izquierda de la página, haz clic en > Cuenta > Funciones de administrador.
Selecciona una función existente con el siguiente privilegio o crea una función nueva y agrega este privilegio:
Services > ChromeOS > Settings > Manage PrintersAsigna esta función a la dirección de correo electrónico de la cuenta de servicio.
Cómo bloquear una app de administración de impresoras o confiar en ella
De forma predeterminada, las apps son de confianza, pero un administrador puede bloquearlas o confiar en apps específicas para su cuenta.
- Como administrador, accede a la Consola del administrador.
- En la parte superior izquierda, haz clic en Menú > Seguridad > Control de acceso y datos > Controles de API.
- En la sección "Control de acceso a apps", haz clic en Administrar el acceso de apps de terceros.
- En la sección "Aplicaciones conectadas", haz lo siguiente:
- Si la aplicación no aparece en la lista, haz clic en Configurar nueva aplicación. Luego, sigue las instrucciones en pantalla.
- Si ve la aplicación en la lista, haga clic en el nombre de la aplicación. Luego, selecciona bloqueado o de confianza en "Acceso a apps" y haz clic en Guardar.