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. Itens ingeridos por meio de conexões criadas com as APIs consomem sua cota de item. Para saber mais sobre como determinar a cota de item que você tem e a compra de cota adicional, confira requisitos e preços de licenciamento.

Você pode usar a API de conectores do Microsoft Graph para:

1. Criar e gerenciar conexões de dados externos.
2. Defina e registre o esquema dos tipos de dados externos.
3. Ingerir itens de dados externos no Microsoft Graph.
4. 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 saber mais, consulte Criar, atualizar e excluir conexõ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 saber mais, consulte Registrar e atualizar o esquema para a conexã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 saber mais, consulte Criar, atualizar e excluir itens adicionados por seu aplicativo por meio de conectores do Microsoft Graph.

Sincronizar grupos externos

Itens no serviço externo podem ser concedidos ou negados acesso via 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 um constructo em grupo (como unidades de negócios, equipes e assim por diante) e determina permissões sobre o conteúdo em sua fonte de dados externa.

Para saber mais, consulte Usar grupos externos para gerenciar permissões para fontes de dados de conectores do Microsoft Graph.

Próxima etapa

Criar um conector personalizado