OpenAI
Esta página foi traduzida automaticamente. Veja o artigo original em inglês.

Google Workspace - Configuração gerenciada pelo admin

Atualizado: 14 days ago

Para conectar seu Google Workspace ao ChatGPT usando a configuração gerenciada pelo admin, primeiro você vai configurar o acesso nos consoles de admin do Google:

  • Criar uma conta de serviço com acesso somente leitura ao Google Drive, usuários e grupos.

    • É altamente recomendável que essa conta de serviço seja criada na mesma conta do Google associada ao seu workspace do ChatGPT. Se as contas no workspace do ChatGPT tiverem um domínio de e-mail diferente do usado no Google Workspace, haverá etapas adicionais que você precisará seguir para habilitar esse conector para seus usuários.

  • Criar uma conta de admin em nome da qual a conta de serviço atuará.

Depois, conclua a configuração no console de admin do ChatGPT:

  • Faça upload da chave privada da conta de serviço (um arquivo JSON do Google)

  • Especifique a conta de admin (não são necessárias credenciais).

  • Selecione quais arquivos sincronizar e escolha os usuários que terão acesso à conexão.

Este guia apresenta cada uma dessas 6 etapas.

Configurando uma conta de serviço

  1. Navegue até console.cloud.google.com.

  2. Clique no menu suspenso de projetos.ImagemVerifique se você está conectado ao mesmo Google workspace associado ao seu workspace do ChatGPT (se você não tiver um Google workspace associado ao seu workspace do ChatGPT e os e-mails forem diferentes entre os dois, será preciso seguir etapas adicionais; caso contrário, seus usuários podem não conseguir usar conectores sincronizados do Google Drive).

  3. Escolha Novo projeto

    Google Cloud Select a resource dialog with dolores-lab.com organization selected

  4. Insira um nome do projeto

    Google Cloud New Project form with organization dolores-lab.com selected and Create button available

  5. Crie o projeto

    Google Cloud New Project form with ChatGPT Google Connector entered under the dolores-lab.com organization

  6. Aguarde até que o projeto seja criado e então clique em Selecionar projeto

    Google Cloud notifications confirm creation of the ChatGPT Google Connector project for dolores-lab.com

  7. Clique em APIs e serviços

    Image

  8. Clique em Biblioteca

    Image

  9. Agora vamos adicionar três APIs, usando a caixa de pesquisa para encontrá-las

    Google Cloud API Library page with the ChatGPT Google Connector project selected

  10. Pesquise e escolha Google Drive API

    Google Cloud API Library search results for Google Drive API in the ChatGPT Google Connector project

  11. Clique em Ativar

    Google Cloud Console Google Drive API page with the Enable button for the ChatGPT Google Connector project

  12. Clique em Biblioteca

    Google Drive API details page with the API enabled and Create Credentials available

  13. Pesquise por Google Drive Activity

    Google Cloud API Library open for the ChatGPT Google Connector project

  14. Escolha Google Drive Activity API

    Google Cloud API Library search results for Google Drive Activity API

  15. Clique em Ativar

    Image

  16. Clique em Biblioteca

    Google Cloud Console Drive Activity API details page with the API enabled and Create credentials available

  17. Pesquise por Admin SDK API

    Google Cloud API Library page for the ChatGPT Google Connector project

  18. Escolha Admin SDK API

    Google Cloud API Library search results for Admin SDK API with Admin SDK API listed

  19. Clique em Ativar

    Google Cloud Admin SDK API page with the Enable button for the ChatGPT Google Connector project

  20. Clique em Credenciais

    Google Cloud Admin SDK API details page with the API enabled and Create credentials button available

  21. Clique em Criar credenciais

    Google Cloud APIs & Services Credentials page with Configure consent screen button

  22. Clique em Conta de serviço

    Google Cloud Credentials page with Create credentials menu open for API key, OAuth client ID, or service account

  23. Forneça um nome e uma descrição de sua escolha para esta conta de serviço

    Google Cloud Create service account page with Service Accounts selected and service account details fields

  24. (Opcional) Você pode atribuir uma função — isso não é exigido pelo ChatGPT.

    Google Cloud Create service account page with optional IAM role step and Service account created confirmation

  25. (Opcional) Você pode conceder acesso à conta de serviço — isso não é exigido pelo ChatGPT.

    Google Cloud Create service account step 3 with Done button and Service account created confirmation

  26. Clique em Concluído.

    Create service account step 3 in Google Cloud with Done button and Service account created confirmation

  27. Clique na conta de serviço que acabou de ser criada.

    Google Cloud Credentials page listing the newly created ChatGPT Google Connector service account

  28. Clique em chaves.

    Google Cloud IAM service account details for ChatGPT Google Connector, enabled after creation

  29. Clique em Adicionar chave

    Image

  30. Clique em Criar nova chave

    Google Cloud service account Keys tab with Add key menu open to create or upload a key

  31. Mantenha o tipo de chave JSON padrão e clique em Criar
    Se aparecer uma mensagem de erro informando “Service account key creation is disabled”, siga estas etapas para habilitar a criação.

    Create private key dialog for ChatGPT Google Connector with JSON key type selected

  32. Clique em Fechar. A chave foi baixada para seu computador. Mais tarde, você fará upload dela no console de admin do ChatGPT.

    Google Cloud service account Keys tab with confirmation that a private key JSON file was saved to the computer

  33. Clique em detalhes

    Google Cloud service account Keys tab for ChatGPT Google Connector with Add Key button

  34. Anote o ID exclusivo. Ele será necessário na Etapa 42.

    Google Cloud service account details for ChatGPT Google Connector with status Enabled

  35. Expanda Configurações avançadas

    Google Cloud service account details for ChatGPT Google Connector with the account enabled

  36. Role para baixo e clique em Ver Console de Admin do Google Workspace. O console do Google Workspace será aberto em uma nova guia.

    Image

  37. Clique em Mostrar mais

    Google Workspace Admin console home page for dolores-lab.com

  38. Expanda a seção Segurança

    Image

  39. Expanda a seção Controles de acesso e dados

    Google Workspace Admin console home with Security section expanded in the left navigation

  40. Clique na seção Controles de API

    Google Workspace Admin console home with Security > Access and data control expanded in the sidebar

  41. Clique em Gerenciar delegação em todo o domínio

    Google Admin console API controls page under Security > Access and data control

  42. Clique em Adicionar novo

    Google Admin Domain-wide Delegation page with API clients list and Add new option

  43. Use o ID exclusivo anotado anteriormente como valor deste ID do cliente

    Google Admin Domain-wide Delegation dialog for adding a new client ID and OAuth scopes

  44. Para os escopos OAuth, consulte os valores de escopos de autenticação delimitados por vírgula a seguir, que você precisará copiar e colar:

https://www.googleapis.com/auth/admin.directory.group.readonly, https://www.googleapis.com/auth/admin.directory.group.member.readonly, https://www.googleapis.com/auth/admin.directory.user.readonly, https://www.googleapis.com/auth/admin.directory.user.alias.readonly, https://www.googleapis.com/auth/drive.activity.readonly, https://www.googleapis.com/auth/drive.metadata.readonly, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/userinfo.profile, https://www.googleapis.com/auth/userinfo.email
EscopoRaciocínio
admin.directory.group.readonlyaplicar permissões baseadas em grupo
admin.directory.group.member.readonlyaplicar permissões baseadas em grupo
admin.directory.user.alias.readonlylidar com casos em que o usuário recebe permissão por meio de um alias
drive.activity.readonlyser notificado quando ocorrerem alterações nos arquivos
drive.metadata.readonlysincronizar o conteúdo do arquivo e os metadados associados (ex.: data da última modificação)
drive.readonlysincronizar o conteúdo do arquivo e os metadados associados (ex.: data da última modificação)
userinfo.profiledeterminar os usuários para os quais estamos sincronizando arquivos
userinfo.emaildeterminar os usuários para os quais estamos sincronizando arquivos
Google Admin Domain-wide Delegation dialog for adding a new client ID and OAuth scopes

45. Clique em Autorizar

Image

46. Sucesso!

Image

Configurando a conta de admin

  1. Expanda Diretório

    Google Admin Domain-wide Delegation page with a ChatGPT API client and scopes listed

  2. Clique em Usuários

    Google Admin domain-wide delegation page listing a ChatGPT Google Connector API client and scopes
    Google Admin console Users page listing workspace accounts for setup and management

  3. Forneça um nome, sobrenome e endereço de e-mail principal de sua escolha

    Google Admin console Add new user form for creating a Workspace user at dolores-lab.com

  4. Clique em Adicionar novo usuário

    Google Admin console Add new user form filled for a ChatGPT Connector account

  5. (Opcional) Registre essas credenciais. O ChatGPT não precisa delas.

    Google Admin Console New user added page for ChatGPT Connector with Copy Password and Done actions

  6. Clique em Concluído.

    Google Admin console Copy password dialog for a newly created user account

  7. Clique na conta que você acabou de criar. Se ela não aparecer na lista, atualize a página ou limpe o cache e os cookies e tente novamente.

    Google Admin console Users page listing accounts including ChatGPT Connector

  8. Clique em atribuir funções.

    Google Admin user details page for the ChatGPT Connector service account

  9. Ative as funções Groups Reader, User Management Admin, e Storage Admin.

    Google Admin ChatGPT Connector user page with Admin roles and privileges open and no roles assigned

  10. Role para baixo e clique em Salvar. A conta de admin foi criada e configurada com sucesso.

Image

Concluindo a configuração no Console de Admin do ChatGPT

  1. Navegue até o ChatGPT e clique no ícone de perfil no canto superior direito da página.

    Image

  2. Clique em Gerenciar workspace

    ChatGPT workspace menu with Manage workspace selected under the organization switcher

  3. Clique em Connections e depois, em ‘Conectores sincronizados’ → Ativar sincronização

    Connectors page with Google Drive sync prompt and Enable Sync button highlighted

  4. Verifique se Gerenciado pelo admin está selecionado e clique em Avançar

    Google Drive connection setup with Admin-managed setup selected over Self-service setup

  5. Digite um nome de exibição. Recomendamos usar o nome do seu Google Workspace.

    Observe que, no momento, não é possível alterar o nome da conexão.

    Google Workspace connector setup dialog with display name Dolores Labs entered

  6. Clique em Salvar rascunho e continuar

  7. Clique em Fazer upload da chave. Escolha o arquivo JSON, que é a chave baixada durante a configuração da conta de serviço acima. Verifique se essa chave está correta

    Google Workspace connection setup step prompting upload of a service account key and admin email address

  8. Digite o endereço de e-mail do admin. Esta é a conta de admin criada anteriormente.

    Image

  9. Clique em Salvar.

    ChatGPT Connections credentials dialog with service account key and Google Workspace admin email entered

  10. Escolha se deseja incluir os arquivos em todos os My Drives dos seus usuários.

    ChatGPT Connections modal for User files with Include user My Drives enabled at step 2 of 5

  11. Clique em Avançar

    ChatGPT admin Connections modal for User files with Include user My Drives enabled in step 2 of 5

  12. Escolha como gerenciar drives compartilhados. Oferecemos suporte aos três cenários a seguir:

    1. Se quiser incluir todos os drives compartilhados, escolha Incluir por padrão e não adicione IDs de drives compartilhados a serem excluídos

    2. Se quiser incluir a maioria dos drives compartilhados, escolha Incluir por padrão e adicione os IDs dos drives compartilhados que deseja excluir

    3. Se quiser excluir a maioria dos drives compartilhados, escolha Excluir por padrão e adicione os IDs dos drives compartilhados que deseja incluir

    ChatGPT admin Shared drives setup with Include by default selected and an Excluded Shared drives field

  13. Para localizar o ID de um drive compartilhado, abra-o em um navegador. A última parte da URL é o ID do drive compartilhado.
    No exemplo a seguir, é `0ADvY03uUbEcQUk9PVA`'

    Google Drive shared drive with Manage members visible for Example Shared Drive

  14. Clique em Avançar

    ChatGPT admin Connections modal for Shared drives with Include by default selected at step 3 of 5

  15. Escolha quem deve ter acesso à conexão do Google Drive. Você pode selecionar apenas Admins do workspace do ChatGPT ou habilitar para todos. Se habilitado para todos, novos usuários adicionados ao workspace serão incluídos automaticamente.

    Google Drive connector permission set to Admins only for workspace members

  16. Clique em Iniciar sincronização

    Image

  17. Sua conexão com o Google Drive foi criada com sucesso!
    Observe que, embora a sincronização comece imediatamente, a conclusão pode levar de horas a dias, dependendo de quantos arquivos foram incluídos com base nas suas configurações.
    Quando os arquivos adicionados/editados nos últimos 30 dias terminarem de sincronizar, o conector ficará disponível para os usuários para os quais você o habilitou.

    Image

Habilitando a criação de chaves de conta de serviço

Se você receber o erro a seguir, precisará habilitar a criação de conta de serviço para este projeto específico:

> A restrição da política da organização ‘iam.disableServiceAccountKeyCreation’ é aplicada na sua organização.

Google Cloud service account Keys tab with error that service account key creation is disabled

  1. Abra uma nova guia e navegue até console.cloud.google.com. Certifique-se de que o projeto selecionado é o mesmo que você já escolheu.
    Clique no ícone de menu no canto superior esquerdo.

    Google Cloud Console welcome page for the ChatGPT Google Connector project

  2. Passe o cursor sobre IAM e Admin

    Google Cloud Console navigation with IAM & Admin open and Organization Policies selected

  3. Clique em Políticas organizacionais

    Google Cloud Console IAM & Admin menu opened to Organization Policies

  4. Pesquise por iam.disableServiceAccountKeyCreation

    Google Cloud organization policies for the ChatGPT Google Connector project

  5. Clique no resultado de constraints/iam.disableServiceAccountKeyCreation

    Image

  6. Clique nos … da linha com o ID iam.disableServiceAccountKeyCreation

    Organization policies filtered to Disable service account key creation for the ChatGPT Google Connector project

  7. Clique em Editar política. Se Editar política estiver desabilitado, você precisará se tornar um Administrador de Políticas da Organização.

    Google Cloud Organization Policies filtered to Disable service account key creation with Edit policy menu open

  8. Clique em Substituir a política principal

    Image

  9. Clique em Adicionar uma regra

    Edit policy page for Disable service account key creation with Override parent's policy selected

  10. Clique em Definir política

    Google Cloud Edit policy page with Override parent's policy selected and enforcement set to Off

  11. Agora você pode criar uma chave de conta de serviço. Essa habilitação pode levar vários minutos para entrar em vigor.

Google Cloud policy details with Disable service account key creation set to Not enforced

Tornando-se um Administrador de Políticas da Organização

  1. Navegue até console.cloud.google.com e clique no seletor de projeto/organização

    Google Cloud welcome page for the ChatGPT Google Connector project

  2. Clique em sua organização

    Image

  3. Clique no ícone de menu no canto superior esquerdo

    Image

  4. Passe o cursor sobre IAM e Admin

    Google Cloud console navigation menu open with Google Cloud Setup pinned

  5. Clique em IAM

    Image

  6. Clique no lápis da sua conta

    Google Cloud IAM page for dolores-lab.com showing organization permissions and the Grant Access action

  7. Clique em Adicionar outra função

    Google Cloud IAM dialog assigning the Organization Administrator role for dolores-lab.com

  8. Pesquise por Administrador de Políticas da Organização

    Google Cloud IAM edit access dialog assigning the Organization Administrator role to a user

  9. Clique em Administrador de Políticas da Organização

    Google Cloud IAM role picker with Organization Policy Administrator selected while editing access

  10. Clique em Salvar

    Google Cloud IAM access editor assigning Organization Administrator and Organization Policy Administrator roles

  11. Sua conta agora tem permissão para habilitar a criação de chaves de conta de serviço. Isso pode levar vários minutos para entrar em vigor.

Usando um alias de e-mail do Google para manter contas de e-mail diferentes no Google Workspace e no ChatGPT

Se você é um admin conectando o Google Workspace ao seu workspace do ChatGPT usando a configuração gerenciada pelo admin para conectores sincronizados do Google Drive, e sua organização usa domínios de e-mail diferentes para ChatGPT e Google Workspace, será necessário seguir etapas adicionais para garantir que os usuários possam acessar os conectores sincronizados do Google Drive com sucesso.

Recomendação: Sempre que possível, use os mesmos endereços de e-mail principais para contas do Google Workspace e do ChatGPT.

Se isso não for viável, siga as instruções abaixo para configurar um alias de e-mail do Google Workspace que corresponda ao e-mail de login do ChatGPT.

Etapas para adicionar um alias do Google Workspace

Siga estas etapas no Console de Admin do Google para garantir que o e-mail do ChatGPT de cada usuário possa ser vinculado à conta do Google Workspace correspondente:

  1. Acesse o Console de Admin. Navegue até: Diretório > Usuários

Image

2. Selecione um usuário e depois “ADICIONAR E-MAILS ALTERNATIVOS”.

Google Admin user details page with Add alternate emails action highlighted

3. Adicione um e-mail alternativo. Verifique se ele corresponde à conta ChatGPT do usuário.

Google Workspace Admin alternate email alias form with alias-testing-alt-email on bytesheaven.com

4. Selecione Salvar

Limitações conhecidas

Endereços de e-mail pessoais não são compatíveis

Usuários que se registram no ChatGPT usando endereços pessoais (ex.: example@gmail.com) não podem se conectar ao Google Workspace. Essa configuração não é compatível e apresenta um risco de segurança, pois permite acesso a dados internos de fora da organização.

Aliases Gmail com "+" não são compatíveis

O Gmail permite que usuários criem aliases adicionando um "+" ao endereço (ex.: user+alias@gmail.com). Esse tipo de alias não funciona com conectores sincronizados do Google Drive. O alias deve ser configurado explicitamente no Google Workspace.

Mensagem de erro comum

Se os endereços de e-mail não estiverem vinculados corretamente, os usuários poderão encontrar esta mensagem: "Não foi possível conectar sua conta ao Google Drive. Clique para saber mais."

Se os usuários receberem essa mensagem, revise as etapas deste documento e verifique se estão sendo seguidas corretamente. Se precisar de assistência adicional, entre em contato com nossa equipe de suporte.

Este artigo foi útil?