Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Para usar a API Chrome Printer Management, ative a API e crie as credenciais do OAuth
2.0 do app. Em seguida, um
administrador do Chrome
precisa conceder ao script o acesso de conta necessário para gerenciar impressoras.
Os administradores podem bloquear ou confiar em apps desenvolvidos para gerenciar impressoras
na conta.
Siga as etapas abaixo para configurar tudo o que for necessário para o acesso à API. Estas
instruções pressupõem que você já tenha um app com a tela de consentimento OAuth
configurada e uma conta de serviço configurada. Caso contrário, consulte
Configurar o consentimento do OAuth e
Criar uma conta de serviço
antes de continuar.
Ativar a API e criar credenciais
Ative a API.
A API que você está ativando é "Admin SDK".
Crie credenciais do OAuth 2.0
para sua conta de serviço. Armazene o arquivo JSON transferido por download em um local
seguro.
Ativar o acesso à conta de serviço
Antes do uso, a 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 personifique um administrador que
tenha os privilégios adequados para gerenciar impressoras e servidores de impressão.
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 um papel com privilégios para gerenciar apenas impressoras. Para saber mais sobre
como usar papéis para controle de acesso, consulte
Gerenciar papéis.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-03-25 UTC."],[],[],null,["# Get started\n\nTo use the Chrome Printer Management API, you need to enable the API and create the app's OAuth\n2.0 credentials. Then a\n[Chrome administrator](https://support.google.com/a/answer/6208960)\nneeds to grant your script the necessary account access to manage printers.\nAdmins can optionally block or trust apps developed to manage printers\nfor their account.\n\nFollow the steps below to set up everything required for API access. These\ninstructions assume you already have an app with its OAuth consent screen set\nup, and a service account set up. If that's not the case, see\n[Configure OAuth consent](/workspace/guides/configure-oauth-consent) and\n[Create a service account](/workspace/guides/create-credentials#create_a_service_account)\nbefore continuing.\n| **Note:** Only service accounts can access the Chrome Printer Management API at this time.\n\nEnable API and create credentials\n---------------------------------\n\n1. [Enable the API](/workspace/guides/enable-apis). The API you are enabling is \"Admin SDK.\"\n2. [Create OAuth 2.0 credentials](/workspace/guides/create-credentials#create_credentials_for_a_service_account) for your service account. Store the downloaded JSON file in a secure location.\n\nEnable service account access\n-----------------------------\n\nBefore use, your service account needs to be granted proper admin\nprivileges. This must be done by an administrator for the customer\nassociated with the printers or print servers that the service account manages.\n\n### Option 1: Enable domain-wide delegation for the service account\n\nDomain-wide delegation lets the service account impersonate an admin who\nhas the proper privileges to manage printers and print servers.\n\n[Enable domain-wide delegation](/workspace/guides/create-credentials#optional_set_up_domain-wide_delegation_for_a_service_account)\n\nThe OAuth scope you need for this step is\n`https://www.googleapis.com/auth/admin.chrome.printers`.\n| **Note:** Depending on your app, you might need to enter additional scopes. For example, you might need to list scopes for the [Chrome Policy API](/chrome/policy)or the [Directory API](/workspace/admin/directory) (to view or manage organizational units).\n\n### Option 2: Grant admin role privileges to the service account\n\nIf you prefer to limit the service account's privileges on the domain, you can\nassign it a role with privileges to only manage printers. To learn more about\nusing roles for access control, see\n[Manage roles](/workspace/admin/directory/v1/guides/manage-roles).\n\n1. As an administrator, sign in to the [Admin console](https://admin.google.com/).\n2. At the top left of the page, click menu \\\u003e **Account** \\\u003e **Admin\n roles**.\n3. Select an existing role with the privilege below, or create a new role and\n add this privilege:\n\n `Services \u003e ChromeOS \u003e Settings \u003e Manage Printers`\n4. Assign this role to the service account email address.\n\nBlock or trust a printer management app\n---------------------------------------\n\nApps are trusted by default, but an administrator can choose to block or trust\nspecific apps for their account.\n\n1. As an administrator, sign in to the [Admin console](https://admin.google.com/).\n2. At the top left, click Menu menu \\\u003e **Security** \\\u003e **Access and data control** \\\u003e **API controls**.\n3. In the \"App access control\" section, click **Manage Third-party App Access**.\n4. In the \"Connected apps\" section:\n - If you don't see the app listed, click **Configure new app**. Then, follow the on-screen instructions.\n - If you see the app listed, click the app name. Then, select blocked or trusted under \"App Access\" and click **Save**."]]
