Visão geral da API de contatos pessoais do OutlookOutlook personal contacts API overview

Os contatos do Outlook permitem que você armazene dados de contatos pessoais e fazem parte de um hub de mensagens do Outlook no Microsoft 365.Outlook contacts lets you store personal contacts' data, and is part of the Outlook messaging hub in Microsoft 365. Pelo Outlook, você pode gerenciar emails, agendar reuniões, saber mais sobre os usuários de uma organização, iniciar conversas online, compartilhar arquivos e colaborar em grupos.Through Outlook, you can manage emails, schedule meetings, find information about users in an organization, initiate online conversations, share files, and collaborate in groups.

Por que se integrar aos contatos pessoais do Outlook?Why integrate with Outlook personal contacts?

Complemente os cenários de envio de mensagens e criação de calendário para centenas de milhões de clientesComplement messaging and calendaring scenarios for hundreds of millions of customers

Centenas de milhões de clientes e dezenas de milhões de clientes organizacionais escolhem o Outlook como serviço de email.Hundreds of millions of consumers and tens of millions of organization customers choose Outlook as their email client. Os contatos oferecem uma função complementar para mensagens e calendários ao permitirem que os clientes mantenham um armazenamento conveniente e integrado dos dados dos contatos no Outlook.Contacts provide a complementary function for messaging and calendaring by letting customers maintain a convenient, integrated store of contacts data within Outlook. Para os desenvolvedores, poder aproveitar a funcionalidade avançada de email ou de calendário significa ter acesso a cenários mais amplos com os dados dos contatos do usuário.For developers, tapping into the rich functionality of mail or calendar means opening up richer scenarios with the user's contacts data.

Automatizar a organização dos contatosAutomate contact organization

A API de contatos permite manter os seus clientes organizados, muito parecido com o que os clientes fazem por conta própria no Outlook:The contacts API lets you keep your customers organized, in close parity as the customers do it themselves through Outlook:

  • De forma parecida com a experiência do cliente, você pode criar instâncias de contact e atribuí-las aos objetos de contactFolder.Similarly to the customer experience, you can create contact instances and assign them to contactFolder objects.
  • A API de contatos permite atribuir contatos de categorias, bem como eventos, mensagens, tarefas e postagens de grupo de maneira consistente para aprimorar a organização e a descoberta.The contacts API lets you assign categories contacts, as well as events, messages, tasks, and group posts in a consistent way to enhance organization and discovery. Além disso, você pode definir a lista mestra de categorias de um usuário, que possibilita outros cenários de criação.In addition, you can define a user's master list of categories, which can open up additional creative scenarios.
  • Você pode definir um sinalizador em um contact para fins de acompanhamento.You can set a flag on a contact for follow-up. (No momento, a sinalização está no modo de visualização no Microsoft Graph).(Flagging is currently in preview in Microsoft Graph.)

Compartilhar informações de contatoShare contact information

A API de contatos permite que você obtenha os itens de contato do usuário conectado ou dos usuários que compartilharam ou delegaram seus contatos ao usuário conectado.The contacts API lets you get contact items of the signed-in user, or of the users who have shared or delegated their contacts to the signed-in user. Por exemplo, se Henrique tiver compartilhado uma pasta de contato com Paulo ou tiver delegado acesso a Paulo, as permissões delegadas de Paulo também concederão acesso de leitura ao calendário e ao conteúdo que Henrique compartilhou.For example, if Garth has shared a contact folder with John, or if Garth has delegated access to John, then delegated permissions from John would give you read access to Garth's shared calendar and contents as well.

Utilize a API de pessoas no Microsoft Graph para fazer melhor uso de todos os dados de pessoasLeverage people API in Microsoft Graph to make better use of all people data

Você pode usar as operações CRUD típicas de um contact do Outlook para criar e gerenciar contatos.You can use the typical CRUD operations for an Outlook contact to create and manage contacts. Como parte do Microsoft Graph, você também pode usar a API de pessoas, que analisa os contatos do Outlook e as redes sociais de um usuário, o diretório da organização e as pessoas envolvidas em comunicações recentes e retornar informações sobre pessoas de todas essas fontes que são mais relevantes para o usuário.As part of Microsoft Graph, you can also use the people API that looks at a user's Outlook contacts, as well as social networks, organization directory, and people from recent communication, and return information about people from all these sources that are most relevant to the user. Utilize essa inteligência adicional em cenários do seletor de pessoas.Take advantage of this additional intelligence in people picker scenarios.

Utilizar outros recursos compartilhados e conveniências no Microsoft GraphTake advantage of other shared features and conveniences in Microsoft Graph

  • A entidade contact é compatível com uma foto de contato que é implementada como a mesma entidade profilePhoto da foto de usuário armazenada no Exchange Online ou no Azure Active Directory.The contact entity supports a contact photo which is implemented as the same profilePhoto entity as a user photo stored in Exchange Online or Azure Active Directory. Isso elimina a sobrecarga na conversão entre as fotos de perfil de usuário e de contato.This eliminates the overhead in converting between contact and user profile photos.
  • Mantenha a loja de aplicativos local sincronizada inscrevendo-se em alterar notificações e controlar as alterações nos contatos e pastas de contato.You can keep the app local store synchronized by subscribing to change notifications and tracking changes to contacts and contact folders.
  • Você pode ampliar o armazenamento de aplicativos em uma instância de contato como uma extensão aberta ou adicionar dados personalizados fortemente tipados ao esquema de contatos como uma extensão de esquema.You can extend app storage in a contact instance as an open extension, or add strongly typed custom data to the contact schema as a schema extension.

Onde estão os dados?Where is the data?

A API do Microsoft Graph é compatível com o acesso aos dados nas caixas de correio principais e em caixas de correio compartilhadas do usuário.The Microsoft Graph API supports accessing data in users' primary mailboxes and in shared mailboxes. Os dados podem ser calendário, email ou contatos pessoais na nuvem no Exchange Online como parte do Microsoft 365, ou no Exchange no local em uma implantação híbrida.The data can be calendar, mail, or personal contacts stored in a mailbox in the cloud on Exchange Online as part of Microsoft 365, or on Exchange on-premises in a hybrid deployment.

A API não é compatível com o acesso às caixas de correio de arquivo morto no local, não no Exchange Online, nem no Exchange Server.The API does not support accessing in-place archive mailboxes, not on Exchange Online nor on Exchange Server.

Referência da APIAPI reference

Está procurando a referência de API para esse serviço?Looking for the API reference for this service?

Próximas etapasNext steps