Utilizar a API de conectores do Microsoft Graph

Pode utilizar conectores do Microsoft Graph para transferir dados de serviços externos para o Microsoft Graph. A API de conectores do Microsoft Graph permite-lhe indexar dados externos para poder utilizar experiências inteligentes no Microsoft 365, como o Copilot e o Microsoft Search.

Os pedidos para indexar dados são realizados em nome de uma aplicação sem a presença de um utilizador com sessão iniciada através de um token de acesso com permissão de aplicação.

Criar um conector personalizado do Microsoft Graph

Criar um conector personalizado do Microsoft Graph envolve quatro passos:

1. Crie um registo de aplicação do Entra ID (anteriormente conhecido como Azure Active Directory). Juntamente com o pedido ao Microsoft Graph, submeta o nome do registo de aplicações e as permissões da API de que a sua aplicação precisa. O Microsoft Graph responde com informações sobre o registo de aplicações recentemente criado.
2. Crie uma ligação externa. Cada ligação requer um ID, um nome e uma descrição exclusivos.
3. Crie o esquema para a ligação externa. O esquema define a forma de conteúdo externo que irá ingerir através desta ligação do Microsoft Graph. A criação do esquema é uma operação de execução prolongada. Depois de submeter o esquema para criar a ligação, o Microsoft Graph responde com um URL que pode utilizar para marcar o status da operação. O esquema está a ser aprovisionado desde que a operação status seja inprogress. Quando o aprovisionamento estiver concluído, a operação devolverá uma completed status.
4. Ingerir conteúdo externo. Para cada item externo, extraia-o do repositório de conteúdo de origem, transforme-o para que corresponda ao esquema da sua ligação externa e submeta-o no Microsoft Graph como um item externo. Juntamente com o item, inclua informações sobre quem tem permissão para aceder ao mesmo, também conhecida como lista de controlo de acesso (ACL).

Segue-se um diagrama de sequência que ilustra os quatro passos para criar um conector do Microsoft Graph.

Casos de uso comuns

A tabela seguinte lista os casos de utilização comuns da API de conectores do Microsoft Graph.

Casos de uso	Recursos REST	Confira também
Ações de configuração
Criar, atualizar ou excluir uma conexão	externalConnection	Métodos de externalConnection
Registrar um esquema para os dados externos	schema	métodos de esquema
Ações de indexação
Adicionar, atualizar ou excluir um item personalizado no índice	externalItem	métodos de externalItem

Limitações conhecidas

A seguir estão as limitações conhecidas atuais:

• As organizações estão limitadas a um máximo de 30 ligações. (Se precisar de mais ligações, preencha o Formulário de pedido.)
• Pode criar até 25 externalItem itens de recursos por segundo.
• Uma aplicação está limitada a 25 operações simultâneas numa ligação.
• As conexões têm um limite de capacidade de 5.000.000 itens ou ~350 GB de dados.
• O tamanho máximo de uma entidade externalItem é 4 MB.

Próximas etapas

• Confira a Visão geral da API de Pesquisa da Microsoft.
• Faça uma busca detalhada sobre os métodos, propriedades e relações dos recursos externalConnection, schemae externalItem.
• Confira a coleção Microsoft Graph postman (saiba mais)
• Confira o exemplo de conector de pesquisa no GitHub.