Usar a API de Pesquisa da Microsoft para indexar dadosUse the Microsoft Search API to index data

Importante

APIs na /beta versão no Microsoft Graph estão sujeitas a alterações.APIs under the /beta version in Microsoft Graph are subject to change. Não há suporte para o uso dessas APIs em aplicativos de produção.Use of these APIs in production applications is not supported. Para determinar se uma API está disponível em v1.0, use o seletor De versão.To determine whether an API is available in v1.0, use the Version selector.

Você pode usar o Microsoft Graph para adicionar itens personalizados aos resultados da pesquisa na experiência de Pesquisa da Microsoft.You can use Microsoft Graph to add custom items to search results in the Microsoft Search experience.

As solicitações de indexação de dados são realizadas em nome de um aplicativo sem a presença de um usuário conectado, identificado usando um token de acesso com permissão de aplicativo.Requests to index data are performed on behalf of an application without the presence of a signed-in user, identified using an access token with application permission.

Importante

Conectores do Microsoft Graph e estão no status de visualização pública no momento.Microsoft Graph connectors and are currently in public preview status. Para obter acesso às funcionalidades dos conectores, você deve ativar a opção Lançamento direcionado em seu locatário.To gain access to connectors functionality, you must turn on the Targeted release option in your tenant. Para ver mais detalhes, confira oprograma de visualização de conectores.See more details on the connectors preview program.

Casos de uso comunsCommon use cases

Os casos de uso das APIs nesta seção tratam da criação de conectores do Microsoft Graph, o que envolve as principais etapas para:The use cases for the APIs in this section involve building Microsoft Graph connectors, which involves the following primary steps:

  1. Criar uma conexão para uma fonte de dados externa.Create a connection to an external data source.
  2. Criar e registrar um esquema que descreve o tipo e como indexar os dados externos.Create and register a schema that describes the type and how to index the external data.
  3. Indexar os dados como um item externo.Index the data as an external item.
Casos de usoUse cases Recursos RESTREST resources Confira tambémSee also
Ações de configuraçãoConfiguration actions
Criar, atualizar ou excluir uma conexãoCreate, update, or delete a connection externalConnectionexternalConnection Métodos de externalConnectionexternalConnection methods
Registrar um esquema para os dados externosRegister a schema for the external data schemaschema métodos de esquemaschema methods
Ações de indexaçãoIndexing actions
Adicionar, atualizar ou excluir um item personalizado no índiceAdd, update or delete a custom item in the index externalItemexternalItem métodos de externalItemexternalItem methods

Limitações conhecidasKnown limitations

A seguir estão as limitações conhecidas atuais:The following are current known limitations:

  • As organizações estão limitadas a um máximo de 10 conexões.Organizations are limited to a maximum of 10 connections.
  • Somente as identidades do Azure Active Directory são compatíveis.Only Azure Active Directory identities are supported.
  • Você só pode criar quatro itens de recursos externalItem por segundo.You can create only four externalItem resources items per second.
  • Um aplicativo está limitado a quatro operações simultâneas em uma conexão.An application is limited to four concurrent operations on a connection.
  • As conexões têm um limite de capacidade de 700 mil itens ou aproximadamente 70 GB de dados.Connections have a capacity limit of 700,000 items or ~70 GB of data.
  • O tamanho máximo de uma entidade externalItem é 4 MB.Maximum size of an externalItem entity is 4 MB.
  • A classificação de resultados não é compatível.Sorting results is not supported.
  • A classificação de resultados é pelo melhor esforço.Result ranking is best effort.

O que há de novoWhat's new

Saiba mais sobre os novos recursos e atualizações mais recentes para este conjunto de APIs.Find out about the latest new features and updates for this API set.

Próximas etapasNext steps