Trabalhar com a API de conectores do Microsoft Graph
Os conectores do Microsoft Graph trazem dados externos para o Microsoft Graph e aprimoram as experiências inteligentes do Microsoft 365. Você pode criar um conector personalizado para integração com serviços que não estão disponíveis como conectores desenvolvidos pela Microsoft. Para criar conectores personalizados, use as APIs REST de conectores do Microsoft Graph. Os itens ingeridos através de ligações criadas com as APIs consomem a quota de itens. Para obter mais informações sobre como determinar a quantidade de quota de itens que tem e como comprar quota adicional, veja Requisitos de licenciamento e preços.
Você pode usar a API de conectores do Microsoft Graph para:
- Criar e gerenciar conexões de dados externos.
- Defina e registre o esquema dos tipos de dados externos.
- Ingerir itens de dados externos no Microsoft Graph.
- Sincronizar grupos externos.
Criar e gerenciar conexões de dados externos.
O recurso externalConnection (API de conexão externa) é um contêiner lógico para seus dados externos que você pode gerenciar como uma única unidade.
Para obter mais informações, consulte Criar, atualizar e eliminar ligações no Microsoft Graph.
Definir e registrar o esquema dos tipos de dados externos
O esquema de conexão (API de esquema) determina como seu conteúdo é usado em várias experiências do Microsoft 365. O esquema é uma lista simples de todas as propriedades que você planeja adicionar à conexão junto com seus atributos, rótulos e aliases. Você deve registrar o esquema antes de ingerir itens no Microsoft Graph.
Para obter mais informações, consulte Registar e atualizar o esquema para a ligação do Microsoft Graph.
Ingerir itens de dados externos no Microsoft Graph.
Os itens adicionados por seu aplicativo ao serviço Pesquisa da Microsoft são representados pelo recurso externalItem (API de item externo) no Microsoft Graph.
Para obter mais informações, consulte Criar, atualizar e eliminar itens adicionados pela sua aplicação através dos conectores do Microsoft Graph.
Sincronizar grupos externos
Os itens no serviço externo podem ser concedidos ou negados acesso através da ACL a diferentes tipos de grupos não Microsoft Entra. Por exemplo, os itens do Salesforce podem ter conjuntos de permissões e perfis, enquanto os itens do ServiceNow podem ter grupos locais. Ao ingerir esses itens no Microsoft Graph, você precisará respeitar essas ACLs.
Você pode usar a API de grupo externo para definir permissões em itens externos ingeridos no Microsoft Graph. Um externalGroup representa um grupo não Microsoft Entra ou uma construção semelhante a um grupo e determina as permissões no conteúdo na sua origem de dados externa.
Para obter mais informações, veja Utilizar grupos externos para gerir permissões para origens de dados de conectores do Microsoft Graph.