O conector do Microsoft 365 para o Gemini Enterprise permite pesquisar e agir em dados do Microsoft 365 em um único conector: sites do SharePoint, arquivos do OneDrive, e-mails do Outlook, agendas do Outlook, contatos e Microsoft Teams. O conector alcança todas essas plataformas pela API Microsoft Graph.
Como um conector abrange todas as plataformas do Microsoft 365, não é necessário criar um repositório de dados separado para o SharePoint, o OneDrive, o Outlook e o Teams.
O conector é compatível com dois métodos de autenticação do OAuth 2.0:
- OAuth gerenciado peloGoogle(padrão): o conector usa um aplicativo do Microsoft Entra gerenciado pelo Google . Você não registra seu próprio aplicativo nem fornece um ID do cliente e uma chave secreta do cliente.
- Traga seu próprio app: registre seu próprio aplicativo do Microsoft Entra e forneça o ID do locatário, o ID do cliente e a chave secreta do cliente ao configurar o repositório de dados.
Para mais informações, consulte Configuração do Microsoft 365.
Ações permitidas
Quando o conector do Microsoft 365 está ativado, os usuários finais podem usar comandos de linguagem natural no Gemini Enterprise para realizar as ações a seguir. As ações são agrupadas pelo produto do Microsoft 365 em que atuam, o que corresponde à forma como são agrupadas quando você seleciona ações no console doGoogle Cloud . Para cada ação, as tabelas mostram se ela apenas lê dados ou também faz alterações, além das permissões delegadas do Microsoft Graph de que ela precisa. Para saber como as permissões são solicitadas e concedidas, consulte Permissões.
Usuários e grupos
| Ação | Tipo | Descrição | Permissões necessárias |
|---|---|---|---|
| Adicionar participante ao grupo | Gravação | Adiciona um usuário como membro de um grupo. | GroupMember.ReadWrite.All |
| Adicionar proprietário do grupo | Gravação | Adiciona um usuário como proprietário de um grupo. | Group.ReadWrite.All |
| Criar grupo | Gravação | Cria um novo grupo do Microsoft 365. | Group.ReadWrite.All |
| Acessar meu perfil | Somente leitura | Recupera o perfil do usuário conectado, incluindo o endereço de e-mail em que a conta da Microsoft está registrada. | User.Read |
| Acessar o perfil de usuário | Somente leitura | Recupera o perfil de um usuário no diretório. | User.ReadBasic.All |
| Acessar o perfil de trabalho do usuário | Somente leitura | Recupera o cargo, o departamento, o escritório, os números de telefone, o gerente e os subordinados diretos de um usuário. | User.Read.All |
| Listar membros do grupo | Somente leitura | Lista os participantes diretos de um grupo no diretório. | Group.ReadBasic.AllUser.ReadBasic.All |
| Listar proprietários de grupos | Somente leitura | Lista os proprietários de um grupo no diretório. | GroupMember.Read.AllUser.ReadBasic.All |
| Listar grupos | Somente leitura | Encontra grupos no diretório por nome e retorna o ID de cada um. | Group.ReadBasic.All |
| Encontrar pessoas no diretório | Somente leitura | Encontra pessoas no diretório da organização por nome ou endereço de e-mail. | User.ReadBasic.All |
| Atualizar grupo | Gravação | Atualiza o nome, a descrição ou a visibilidade de um grupo. | Group.ReadWrite.All |
SharePoint e OneDrive
| Ação | Tipo | Descrição | Permissões necessárias |
|---|---|---|---|
| Receber intervalo do Excel | Somente leitura | Lê os valores das células em um bloco de células em uma planilha, incluindo células fora de uma tabela. | Files.Read.All |
| Receber linha da tabela do Excel | Somente leitura | Lê uma linha de uma tabela em uma pasta de trabalho do Excel, com os cabeçalhos de coluna da tabela. | Files.Read.All |
| Receber linhas da tabela do Excel | Somente leitura | Lê as linhas de dados de uma tabela em uma pasta de trabalho do Excel, com os cabeçalhos de coluna da tabela. | Files.Read.All |
| Listar tabelas do Excel | Somente leitura | Lista as tabelas formatadas em uma pasta de trabalho do Excel e a planilha em que cada uma está. | Files.Read.All |
| Ver propriedades da pasta de trabalho do Excel | Somente leitura | Lê as propriedades de arquivo de uma pasta de trabalho do Excel: nome, tamanho, URL e quem fez a última alteração. | Files.Read.All |
| Acessar planilha do Excel | Somente leitura | Lê uma planilha de uma pasta de trabalho do Excel e a extensão dos dados nela. | Files.Read.All |
| Listar planilhas do Excel | Somente leitura | Lista as planilhas em uma pasta de trabalho do Excel, em ordem de guia. | Files.Read.All |
| Listar pastas de trabalho do Excel | Somente leitura | Encontra pastas de trabalho do Excel em sites do OneDrive e do SharePoint que o usuário pode acessar. | Sites.Read.AllFiles.Read.All |
| Fazer check-in do documento | Gravação | Faz check-in de um documento, liberando o bloqueio de edição e disponibilizando-o para outras pessoas. | Files.ReadWrite.All |
| Confira o documento | Gravação | Faz check-out de um documento, bloqueando-o para edição exclusiva. | Files.ReadWrite.All |
| Copiar arquivo | Gravação | Copia um arquivo para um novo local. | Files.ReadWrite.All |
| Copiar pasta | Gravação | Copia uma pasta para um novo local. | Files.ReadWrite.All |
| Criar arquivo | Gravação | Cria um novo arquivo com um determinado nome dentro de uma pasta. Nunca substitui um arquivo atual. Use Substituir conteúdo do arquivo para isso. | Files.ReadWrite.All |
| Criar pasta | Gravação | Cria uma nova pasta dentro de uma pasta atual. | Files.ReadWrite.All |
| Criar link de compartilhamento | Gravação | Cria um link compartilhável para um arquivo ou uma pasta. | Files.ReadWrite.All |
| Descartar finalização de compra | Gravação | Cancela o check-out de um documento e descarta as alterações pendentes. | Files.ReadWrite.All |
| Acessar arquivo ou pasta por URL | Somente leitura | Encontra o arquivo ou a pasta para que um link do SharePoint ou do OneDrive aponta, para que possa ser lido ou usado. | Files.Read.All |
| Baixar o conteúdo do arquivo | Somente leitura | Faz o download do conteúdo bruto de um arquivo armazenado em um drive. | Files.Read.All |
| Acessar meu OneDrive | Somente leitura | Acessa o OneDrive do usuário conectado para que os arquivos possam ser salvos ou listados no nível superior e informa a cota de armazenamento. | Files.Read.All |
| Listar conteúdo da pasta | Somente leitura | Lista os arquivos e as pastas dentro de uma pasta em um drive. | Files.Read.All |
| Listar permissões do arquivo | Somente leitura | Lista as permissões de compartilhamento definidas em um arquivo ou uma pasta. | Files.Read.All |
| Mover arquivo | Gravação | Move um arquivo para outra pasta. | Files.ReadWrite.All |
| Mover pasta | Gravação | Move uma pasta para outra pasta pai. | Files.ReadWrite.All |
| Renomear arquivo | Gravação | Renomeia um arquivo. | Files.ReadWrite.All |
| Renomear pasta | Gravação | Renomeia uma pasta. | Files.ReadWrite.All |
| Substituir conteúdo do arquivo | Gravação | Substitui todo o conteúdo de um arquivo que já existe. Para criar um novo arquivo, use Criar arquivo. | Files.ReadWrite.All |
| Enviar convite de compartilhamento | Gravação | Envia um convite de compartilhamento para um arquivo ou uma pasta. | Files.ReadWrite.All |
| Atualizar propriedades de arquivos ou pastas | Gravação | Atualiza as propriedades de um arquivo ou uma pasta (nome, descrição, pasta pai). | Files.ReadWrite.All |
| Criar lista do SharePoint | Gravação | Cria uma lista em um site do SharePoint. | Sites.Manage.All |
| Criar item da lista | Gravação | Cria um novo item em uma lista do SharePoint. | Sites.ReadWrite.All |
| Criar página do SharePoint | Gravação | Cria uma página em um site do SharePoint. | Sites.ReadWrite.All |
| Receber item da lista | Somente leitura | Recupera uma única linha de uma lista do SharePoint, com os valores das colunas. | Sites.Read.All |
| Acessar o conteúdo da página do SharePoint | Somente leitura | Recupera o corpo HTML de uma página do SharePoint. | Sites.Read.All |
| Listar itens da lista | Somente leitura | Lê as linhas de uma lista do SharePoint, com os valores de coluna de cada linha. | Sites.Read.All |
| Listar listas do SharePoint | Somente leitura | Lista as listas do SharePoint em um site, incluindo o ID e o modelo de cada uma. | Sites.Read.All |
| Listar páginas do SharePoint | Somente leitura | Lista as páginas em um site do SharePoint, com o título, o URL e o estado de publicação de cada uma. | Sites.Read.All |
| Pesquisar no SharePoint e no OneDrive | Somente leitura | Pesquisa sites, páginas, itens de lista do SharePoint e arquivos do OneDrive que o usuário pode acessar. | Sites.Read.AllFiles.Read.All |
| Atualizar lista do SharePoint | Gravação | Atualiza as propriedades de uma lista do SharePoint (nome, descrição). | Sites.Manage.All |
| Atualizar item da lista | Gravação | Atualiza campos em um item de lista do SharePoint. | Sites.ReadWrite.All |
| Atualizar página do SharePoint | Gravação | Atualiza o título ou o nome de arquivo de uma página do SharePoint. | Sites.ReadWrite.All |
Outlook
| Ação | Tipo | Descrição | Permissões necessárias |
|---|---|---|---|
| Adicionar anexo | Gravação | Adiciona um anexo de arquivo a uma mensagem de e-mail ou evento da agenda. | Mail.ReadWriteCalendars.ReadWrite |
| Criar agenda | Gravação | Cria uma agenda na caixa de correio do usuário. | Calendars.ReadWriteCalendars.ReadWrite.Shared |
| Criar contato | Gravação | Cria um novo contato na pasta "Contatos" do usuário. | Contacts.ReadWrite |
| Criar rascunho de mensagem | Gravação | Cria um rascunho de mensagem de e-mail na caixa de correio do usuário. | Mail.ReadWriteMail.ReadWrite.Shared |
| Criar um evento da agenda | Gravação | Cria um evento na agenda do usuário. | Calendars.ReadWrite |
| Criar rascunho de resposta | Gravação | Cria um rascunho de resposta ao remetente de uma mensagem de e-mail. | Mail.ReadWriteMail.ReadWrite.Shared |
| Encontrar horários de reunião | Somente leitura | Sugere horários de reunião com base na disponibilidade dos participantes. | Calendars.Read.Shared |
| Encaminhar mensagem | Gravação | Encaminha uma mensagem de e-mail para destinatários específicos. | Mail.Send |
| Acessar anexo da mensagem de e-mail | Somente leitura | Recupera os bytes de um anexo de arquivo de uma mensagem na caixa de correio do usuário. | Mail.Read |
| Receber respostas automáticas | Somente leitura | Recupera a configuração de resposta automática (fora do escritório) do Outlook do usuário. | MailboxSettings.Read |
| Receber evento da agenda | Somente leitura | Recupera um evento da agenda do Outlook do usuário, incluindo respostas de participantes e IDs de anexos. | Calendars.Read |
| Acessar anexo do evento da agenda | Somente leitura | Recupera os bytes de um anexo de arquivo de um evento na agenda do usuário. | Calendars.Read |
| Receber mensagem de e-mail | Somente leitura | Recupera uma única mensagem da caixa de correio do usuário. | Mail.Read |
| Acessar disponibilidade da programação | Somente leitura | Recupera a disponibilidade de usuários, salas ou equipamentos em um período. | Calendars.Read |
| Listar eventos da agenda | Somente leitura | Lista os eventos na agenda do usuário em um período. | Calendars.Read |
| Listar agendas | Somente leitura | Lista as agendas na caixa de correio do usuário. | Calendars.Read |
| Listar categorias do Outlook | Somente leitura | Lista as categorias (marcadores) na lista de categorias do Outlook do usuário. | MailboxSettings.Read |
| Listar contatos | Somente leitura | Lista ou pesquisa os contatos na lista de endereços do Outlook do usuário. | Contacts.Read |
| Listar regras da caixa de entrada | Somente leitura | Lista as regras da caixa de entrada do Outlook do usuário. | MailboxSettings.Read |
| Listar pastas de e-mail | Somente leitura | Lista as pastas de e-mail na caixa de correio do usuário. | Mail.ReadBasic |
| Listar mensagens em uma pasta | Somente leitura | Lista as mensagens em uma das pastas de e-mail do usuário, como a caixa de entrada ou os itens enviados. | Mail.Read |
| Listar ou pesquisar uma caixa de e-mails compartilhada | Somente leitura | Lista ou pesquisa as mensagens em uma caixa de correio compartilhada ou delegada que o usuário pode acessar. | Mail.Read.Shared |
| Mover mensagem | Gravação | Move uma mensagem de e-mail para outra pasta. | Mail.ReadWrite |
| Responder a todos na mensagem | Gravação | Responde a uma mensagem de e-mail, ao remetente e a todos os outros destinatários, mantendo a resposta na conversa original. | Mail.Send |
| Responder à mensagem | Gravação | Responde a uma mensagem de e-mail atual para o remetente, mantendo a resposta na conversa original. | Mail.Send |
| Confirmar presença no evento | Gravação | Responde a um convite de reunião (aceita, aceita provisoriamente ou recusa). | Calendars.ReadWrite |
| Pesquisar e-mail | Somente leitura | Pesquisa o e-mail do Outlook do usuário por palavra-chave. | Mail.Read |
| Pesquisar e-mails em uma pasta | Somente leitura | Pesquisa as mensagens em uma das pastas de e-mail do usuário, incluindo subpastas como Caixa de entrada/Faturas, por palavra-chave, remetente ou assunto. | Mail.Read |
| Pesquisar eventos da agenda | Somente leitura | Pesquisa os eventos da agenda do Outlook do usuário por palavra-chave. | Calendars.Read |
| Enviar rascunho de mensagem | Gravação | Envia um rascunho de e-mail. | Mail.Send |
| Enviar e-mail | Gravação | Escreve e envia uma nova mensagem de e-mail. | Mail.Send |
| Atualizar agenda | Gravação | Atualiza as propriedades de uma agenda (nome, cor ou status padrão). | Calendars.ReadWriteCalendars.ReadWrite.Shared |
| Atualizar contato | Gravação | Atualiza as propriedades de um contato. | Contacts.ReadWrite |
| Atualizar evento | Gravação | Atualiza as propriedades de um evento da agenda. | Calendars.ReadWrite |
| Atualizar mensagem | Gravação | Atualiza as propriedades de uma mensagem de e-mail (por exemplo, marcar como lida, mudar sinalizações ou importância). | Mail.ReadWrite |
| Listar listas de tarefas | Somente leitura | Lista as listas de tarefas do Microsoft To Do (Tarefas do Outlook) do usuário. | Tasks.Read |
| Listar tarefas | Somente leitura | Lista as tarefas em uma das listas do Microsoft To Do (Tarefas do Outlook) do usuário. | Tasks.Read |
Equipes
| Ação | Tipo | Descrição | Permissões necessárias |
|---|---|---|---|
| Adicionar participante ao canal | Gravação | Adiciona um usuário a um canal particular ou compartilhado do Teams. | ChannelMember.ReadWrite.All |
| Criar canal | Gravação | Cria um canal em uma equipe do Teams. | Channel.Create |
| Criar chat | Gravação | Cria um novo chat do Teams (individual, em grupo ou de reunião). | Chat.Create |
| Criar reunião | Gravação | Cria uma nova reunião on-line do Teams. | OnlineMeetings.ReadWrite |
| Criar grupo de agendamento | Gravação | Cria um grupo de agendamento em uma programação do Teams. | Schedule.ReadWrite.All |
| Criar entrada de folga | Gravação | Cria uma entrada de folga para um usuário em uma escala do Teams. | Schedule.ReadWrite.All |
| Criar motivo de folga | Gravação | Cria um novo motivo de folga (por exemplo, férias, licença médica) para uma programação do Teams. | Schedule.ReadWrite.All |
| Acessar programação | Somente leitura | Lê as configurações de programação e o estado de provisionamento do recurso Turnos de uma equipe. | Schedule.Read.All |
| Listar membros do canal | Somente leitura | Lista os membros de um canal do Teams e as funções deles. | ChannelMember.Read.All |
| Listar mensagens do canal | Somente leitura | Lista as mensagens em um canal do Teams. | ChannelMessage.Read.AllGroup.ReadBasic.All |
| Listar canais | Somente leitura | Lista os canais em uma equipe do Microsoft Teams. | Channel.ReadBasic.AllGroup.ReadBasic.All |
| Listar mensagens de chat | Somente leitura | Lista as mensagens em um chat do Teams. | Chat.Read |
| Listar chats | Somente leitura | Lista os chats do Teams de que o usuário participa. | Chat.ReadBasic |
| Listar equipes que você participa | Somente leitura | Lista as equipes do Microsoft Teams de que o usuário é membro. | Team.ReadBasic.All |
| Listar respostas a mensagens de canais | Somente leitura | Lê uma conversa de canal do Teams: a primeira postagem e as respostas abaixo dela. | Chat.ReadChannelMessage.Read.AllGroup.ReadBasic.All |
| Listar grupos de programação | Somente leitura | Lista os grupos de agendamento em uma escala de turnos de uma equipe. | Schedule.Read.All |
| Listar entradas de folga | Somente leitura | Lista as folgas reservadas na programação de turnos de uma equipe. | Schedule.Read.All |
| Listar motivos de folga | Somente leitura | Lista os motivos de folga selecionáveis na escala de turnos de uma equipe. | Schedule.Read.All |
| Responder a uma mensagem do canal | Gravação | Responde a uma mensagem em um canal do Teams. | ChannelMessage.Send |
| Pesquisar mensagens de bate-papo | Somente leitura | Pesquisa mensagens de chat e canal do Teams que o usuário pode acessar. | Chat.ReadChannelMessage.Read.AllGroup.ReadBasic.All |
| Enviar mensagem do canal | Gravação | Posta uma mensagem em um canal do Teams. | ChannelMessage.Send |
| Enviar mensagem de chat | Gravação | Envia uma mensagem em um chat do Teams. | ChatMessage.Send |
| Canal de atualizações | Gravação | Atualiza o nome ou a descrição de um canal do Teams. | ChannelSettings.ReadWrite.All |
| Mensagem de atualização de canal | Gravação | Edita uma mensagem de canal postada anteriormente. | ChannelMessage.ReadWrite |
| Atualizar chat | Gravação | Atualiza o tema de um grupo de chat do Teams. | Chat.ReadWrite |
| Atualizar mensagem de chat | Gravação | Edita uma mensagem de chat enviada anteriormente. | Chat.ReadWrite |
| Atualizar grupo de programação | Gravação | Atualiza o nome, o status ativo ou os participantes de um grupo de agendamento. | Schedule.ReadWrite.All |
| Atualizar equipe | Gravação | Atualiza o nome, a descrição ou a visibilidade de uma equipe do Teams. | TeamSettings.ReadWrite.All |
| Atualizar entrada de folga | Gravação | Atualiza uma entrada de folga. | Schedule.ReadWrite.All |
Permissões
A coluna Permissões necessárias nas tabelas anteriores lista as permissões delegadas do Microsoft Graph que cada ação precisa. O Gemini Enterprise solicita apenas as permissões para as ações que você ativa, além das seguintes, que são solicitadas por todas as conexões:
User.Read: lê o perfil do usuário conectado, que identifica a conta em que o conector atua.offline_access: permite que o conector atualize o token de acesso sem pedir que o usuário faça login novamente.
Todas as permissões são delegadas: o conector age como o usuário conectado e só pode acessar os dados que o usuário já pode acessar.
Com o OAuth gerenciado pelo Google, os usuários consentem com essas permissões ao autorizar o conector. Algumas permissões exigem que um administrador do Microsoft Entra consinta em nome da organização. Com seu próprio app, você concede essas permissões no registro do app. Para mais detalhes, consulte Configurar permissões da API da Microsoft.
Limitações
Nesta seção, descrevemos problemas e limitações conhecidos que podem afetar o uso do repositório de dados do Microsoft 365.
- Ao criar um app ou adicionar um repositório de dados a um app, recomendamos associar apenas um repositório de dados a ações que pertencem a um único tipo de conector.
- Não é possível aplicar um perímetro do VPC Service Controls em repositórios de dados do Microsoft 365. Para aplicar o VPC Service Controls, é necessário excluir e recriar os repositórios de dados. Para mais informações sobre o VPC Service Controls e como usar ações depois de ativar o VPC Service Controls, consulte Proteger seu app com o VPC Service Controls.
- O repositório de dados do Microsoft 365 é compatível apenas com os locais
global,useeu.
O repositório de dados do Microsoft 365 é mapeado individualmente com um único locatário do Microsoft 365. Ele não pode abranger vários locatários isolados em uma organização multilocatária (MTO, na sigla em inglês). É preciso criar um repositório de dados dedicado para cada locatário.
O OAuth gerenciado peloGoogleé compatível apenas com locatários na nuvem comercial da Microsoft (incluindo GCC) e não é compatível com saída de IP estático. Para locatários do GCC High ou do DoD, ou para usar a saída de IP estático, use seu próprio aplicativo do Microsoft Entra.
As caixas de correio precisam ser totalmente migradas para o Exchange Online. As caixas de correio hospedadas no local em um ambiente híbrido do Exchange não podem ser acessadas pela API Microsoft Graph, e as consultas feitas nelas podem retornar um erro
MailboxNotEnabledForRESTAPI.
A seguir
Para criar e configurar um repositório de dados com o Microsoft 365, consulte Configurar um repositório de dados do Microsoft 365.
Para configurar o aplicativo do Microsoft Entra com que o conector se autentica, consulte Configuração do Microsoft 365.
Para conferir e gerenciar as ações ativadas, consulte Gerenciar ações.