Visão geral

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.All
User.ReadBasic.All
Listar proprietários de grupos Somente leitura Lista os proprietários de um grupo no diretório. GroupMember.Read.All
User.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.All
Files.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.All
Files.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.ReadWrite
Calendars.ReadWrite
Criar agenda Gravação Cria uma agenda na caixa de correio do usuário. Calendars.ReadWrite
Calendars.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.ReadWrite
Mail.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.ReadWrite
Mail.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.ReadWrite
Calendars.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.All
Group.ReadBasic.All
Listar canais Somente leitura Lista os canais em uma equipe do Microsoft Teams. Channel.ReadBasic.All
Group.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.Read
ChannelMessage.Read.All
Group.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.Read
ChannelMessage.Read.All
Group.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, us e eu.

  • 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