Comenzar

Para usar la API de Chrome Printer Management, debes habilitarla y crear las credenciales de OAuth 2.0 de la app. Luego, un administrador de Chrome debe otorgarle a la secuencia de comandos el acceso a la cuenta necesario para administrar las impresoras. De manera opcional, los administradores pueden bloquear o confiar en apps desarrolladas para administrar impresoras para su cuenta.

Sigue los pasos que se indican a continuación para configurar todo lo necesario para el acceso a la API. En estas instrucciones, se supone que ya tienes una app con su pantalla de consentimiento de OAuth configurada y una cuenta de servicio configurada. Si no es así, consulta Cómo configurar el consentimiento de OAuth y Cómo crear una cuenta de servicio antes de continuar.

Nota: Por el momento, solo las cuentas de servicio pueden acceder a la API de Chrome Printer Management.

Habilita la API y crea credenciales

1. Habilita la API. La API que habilitas es "SDK de Admin".
2. Crea credenciales de OAuth 2.0 para tu cuenta de servicio. Almacena el archivo JSON descargado en una ubicación segura.

Habilita el acceso de la cuenta de servicio

Antes de usarla, se deben otorgar los privilegios de administrador adecuados a tu cuenta de servicio. Un administrador del cliente asociado con las impresoras o los servidores de impresión que administra la cuenta de servicio debe realizar esta acción.

Opción 1: Habilita 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.

Habilita 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.

Nota: Según tu app, es posible que debas ingresar permisos adicionales. Por ejemplo, es posible que debas enumerar los permisos de la API de Chrome Policy o de la API de Directory (para ver o administrar unidades organizativas).

Opción 2: Otorga privilegios de rol de administrador a la cuenta de servicio

Si prefieres limitar los privilegios de la cuenta de servicio en el dominio, puedes asignarle un rol con privilegios para administrar solo las impresoras. Para obtener más información sobre el uso de roles para el control de acceso, consulta Administra roles.

1. Como administrador, accede a la Consola del administrador.
2. En la parte superior izquierda de la página, haz clic en > Cuenta > Roles de administrador.

3. Selecciona un rol existente con el siguiente privilegio o crea uno nuevo y agrégale este privilegio:

   Services > ChromeOS > Settings > Manage Printers

4. Asigna este rol a la dirección de correo electrónico de la cuenta de servicio.

Cómo bloquear o confiar en una app de administración de impresoras

Las apps son de confianza de forma predeterminada, pero un administrador puede bloquearlas o confiar en apps específicas para su cuenta.

1. Como administrador, accede a la Consola del administrador.
2. En la parte superior izquierda, haz clic en Menú > Seguridad > Control de acceso y datos > Controles de API.
3. En la sección “Control de acceso de apps”, haz clic en Administrar el acceso de apps de terceros.
4. En la sección "Aplicaciones conectadas", haz lo siguiente:
   • Si no ves la app en la lista, haz clic en Configurar app nueva. Luego, sigue las instrucciones en pantalla.
   • Si ves la app en la lista, haz clic en su nombre. Luego, selecciona bloqueado o de confianza en "Acceso a apps" y haz clic en Guardar.