Comenzar

Para administrar impresoras con la API de Chrome Printer Management, debes seguir estos pasos:

  1. Habilita la API en un proyecto de Google Cloud.
  2. Crea credenciales de OAuth 2.0 para una cuenta de servicio.
  3. Otorga privilegios de administrador de la cuenta de servicio para administrar impresoras.

En esta guía, se supone que ya configuraste una pantalla de consentimiento de OAuth para tu app y una cuenta de servicio. De lo contrario, consulta Cómo configurar el consentimiento de OAuth y Cómo crear una cuenta de servicio antes de continuar.

Solo las cuentas de servicio pueden acceder a la API de Chrome Printer Management.

Un administrador de Chrome debe otorgar a tu cuenta de servicio el acceso necesario para administrar las impresoras de su cuenta. Los administradores también pueden bloquear o confiar en apps específicas de administración de impresoras.

Habilita la API y crea credenciales

  1. Habilita la API. La API que habilitarás es la "API del 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 que puedas usar la cuenta de servicio para administrar las impresoras o los servidores de impresión de un cliente, el administrador de la cuenta de ese cliente debe otorgarle a la cuenta de servicio los privilegios necesarios.

Opción 1: Habilita la delegación en todo el dominio para la cuenta de servicio

La delegación para todo el dominio permite que la cuenta de servicio suplante a un administrador que tiene los privilegios adecuados para administrar impresoras y servidores de impresión.

Habilita la delegación de todo el dominio

El permiso 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 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 un rol nuevo 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 o confiar en una app de administración de impresoras

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

  1. Como administrador, accede a la Consola del administrador.
  2. En la esquina superior izquierda, haz clic en Menú > Seguridad > Control de acceso y datos > Controles de API.
  3. En la sección "Control de acceso a la app", haz clic en Administrar el acceso a 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 una app nueva y 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.