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 tu secuencia de comandos el acceso a la cuenta necesario para administrar impresoras. De manera opcional, los administradores pueden bloquear o confiar en las apps desarrolladas para administrar impresoras en su cuenta.

Sigue los pasos que se indican a continuación a fin de configurar todo lo necesario para acceder a la API. En estas instrucciones, se da por sentado que ya tienes una app con la configuración de la pantalla de consentimiento de OAuth y la 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.

Habilita la API y crea credenciales

  1. Habilita la API. La API que habilitarás 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 a la cuenta de servicio

Antes de usarla, tu cuenta de servicio debe tener los privilegios de administrador adecuados. Esto debe realizarlo un administrador para el cliente asociado con las impresoras o los servidores de impresión que administra la cuenta de servicio.

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.

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 rol 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 administrar impresoras únicamente. Si quieres obtener más información sobre el uso de funciones para el control de acceso, consulta Administra funciones.

  1. Accede a la Consola del administrador como administrador.
  2. En la esquina superior izquierda de la página, haz clic en > Cuenta > Roles de administrador.

  3. Selecciona una función existente con el privilegio que se indica a continuación o crea una función nueva y agrega 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 una app de administración de impresoras o confiar en ella

Las apps son confiables de forma predeterminada, pero un administrador puede elegir bloquear apps específicas o confiar en ellas en su cuenta.

  1. Accede a la Consola del administrador como administrador.
  2. En la parte superior izquierda, haz clic en Menú > Seguridad > Control de acceso y datos > Controles de la 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 "Apps 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 confiable" en "Acceso a apps" y haz clic en Guardar.