Começar

Para gerenciar impressoras usando a API Chrome Printer Management, siga estas etapas:

  1. Ative a API em um projeto do Google Cloud.
  2. Crie credenciais do OAuth 2.0 para uma conta de serviço.
  3. Conceda privilégios de administrador da conta de serviço para gerenciar impressoras.

Este guia pressupõe que você já configurou uma tela de permissão OAuth para seu app e uma conta de serviço. Caso contrário, consulte Configurar o consentimento do OAuth e Criar uma conta de serviço antes de continuar.

Somente contas de serviço podem acessar a API Chrome Printer Management.

Um administrador do Chrome precisa conceder à sua conta de serviço o acesso necessário para gerenciar impressoras na conta dele. Os administradores também podem bloquear ou confiar em apps específicos de gerenciamento de impressoras.

Ativar a API e criar credenciais

  1. Ative a API. A API que você está ativando é a "API Admin SDK".
  2. Crie credenciais do OAuth 2.0 para sua conta de serviço. Armazene o arquivo JSON baixado em um local seguro.

Ativar o acesso à conta de serviço

Antes de usar a conta de serviço para gerenciar as impressoras ou servidores de impressão de um cliente, um administrador da conta desse cliente precisa conceder à conta de serviço os privilégios necessários.

Opção 1: ativar a delegação em todo o domínio para a conta de serviço

A delegação em todo o domínio permite que a conta de serviço personifique um administrador com os privilégios adequados para gerenciar impressoras e servidores de impressão.

Ativar a delegação em todo o domínio

O escopo do OAuth necessário para esta etapa é https://www.googleapis.com/auth/admin.chrome.printers.

Opção 2: conceder privilégios de função de administrador à conta de serviço

Se você preferir limitar os privilégios da conta de serviço no domínio, atribua a ela uma função com privilégios para gerenciar apenas impressoras. Para saber mais sobre como usar papéis para controle de acesso, consulte Gerenciar papéis.

  1. Faça login no Admin Console como administrador.
  2. No canto superior esquerdo da página, clique em > Conta > Funções de administrador.

  3. Selecione uma função com o privilégio a seguir ou crie uma função e adicione este privilégio:

    Services > ChromeOS > Settings > Manage Printers

  4. Atribua esse papel ao endereço de e-mail da conta de serviço.

Bloquear ou confiar em um app de gerenciamento de impressoras

Os apps são confiáveis por padrão, mas um administrador pode bloquear ou confiar em apps específicos para a conta.

  1. Faça login no Admin Console como administrador.
  2. No canto superior esquerdo, clique em Menu > Segurança > Controle de acesso e dados > Controles de API.
  3. Na seção "Controle de acesso de apps", clique em Gerenciar o acesso de apps de terceiros.
  4. Na seção "Apps conectados":
    • Se o app não estiver listado, clique em Configurar novo app e siga as instruções na tela.
    • Se o app aparecer na lista, clique no nome dele. Em seguida, selecione "Bloqueado" ou "Confiável" em "Acesso de apps" e clique em Salvar.