Dar os primeiros passos

Para usar a API Chrome Printer Management, você precisa ativar a API e criar as credenciais OAuth 2.0 do app. Em seguida, um administrador do Chrome precisa conceder ao seu script o acesso necessário à conta para gerenciar impressoras. Os administradores podem bloquear ou confiar em apps desenvolvidos para gerenciar impressoras da conta.

Siga as etapas abaixo para configurar tudo o que é necessário para ter acesso à API. Estas instruções presumem que você já tenha um aplicativo com a tela de permissão OAuth configurada e uma conta de serviço configurada. Se esse não for o caso, consulte Configurar o consentimento do OAuth e Criar uma conta de serviço antes de continuar.

Ativar a API e criar credenciais

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

Ativar o acesso à conta de serviço

Antes do uso, sua conta de serviço precisa receber os privilégios de administrador adequados. Isso precisa ser feito por um administrador do cliente associado às impressoras ou aos servidores de impressão que a conta de serviço gerencia.

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 represente um administrador com os privilégios apropriados 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 papel de administrador à conta de serviço

Se preferir limitar os privilégios da conta de serviço no domínio, atribua a ela um papel com privilégios apenas para gerenciar impressoras. Para saber mais sobre o uso de papéis para controle de acesso, consulte Gerenciar papéis.

  1. Como administrador, faça login no Admin Console.
  2. No canto superior esquerdo da página, clique em > Conta > Papéis do administrador.

  3. Selecione um papel atual com o privilégio abaixo ou crie um novo papel 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 impressora

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

  1. Como administrador, faça login no Admin Console.
  2. No canto superior esquerdo, clique em Menu > Segurança > Controle de dados e acesso > 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 na lista, clique em Configurar novo app e siga as instruções na tela.
    • Se o app estiver na lista, clique no nome dele. Depois, selecione "Bloqueado" ou "Confiável" em "Acesso de apps" e clique em Salvar.