contactFolder: delta

Namespace: microsoft.graph

Obtenha um conjunto de pastas de contatos que foram adicionadas, excluídas ou removidas da caixa de correio do usuário.

Uma chamada de função delta para pastas de contactos numa caixa de correio é semelhante a um pedido GET, exceto que ao aplicar adequadamente tokens de estado numa ou mais destas chamadas, pode consultar alterações incrementais nas pastas de contactos. Isto permite-lhe manter e sincronizar um arquivo local das pastas de contactos de um utilizador sem ter de obter sempre todas as pastas de contactos dessa caixa de correio do servidor.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Solicitação HTTP

GET /me/contactFolders/delta
GET /users/{id}/contactFolders/delta

Parâmetros de consulta

O registo de alterações nas pastas de contactos implica uma ronda de uma ou mais chamadas de função delta . Se você usar qualquer parâmetro de consulta (diferente de $deltatoken e $skiptoken), especifique-o na primeira solicitação delta. O Microsoft Graph codifica automaticamente todos os parâmetros especificados na parte do token (skiptoken ou ) do @odata.nextLink URL ou @odata.deltaLink$deltatokenfornecido na resposta. Você só precisa especificar uma vez os parâmetros de consulta desejados antecipadamente. Nos pedidos subsequentes, basta copiar e aplicar o @odata.nextLink URL ou @odata.deltaLink da resposta anterior, uma vez que esse URL já inclui os parâmetros codificados e pretendidos.

Parâmetros de consulta OData

Você pode usar um parâmetro de consulta $select como em qualquer solicitação GET para especificar somente as propriedades necessárias para obter melhor desempenho. A propriedade id sempre será retornada.

Cabeçalhos de solicitação

Resposta

Se bem-sucedido, este método retorna o código de resposta 200 OK e uma coleção de objetos contactFolder no corpo da resposta.

Exemplo

Solicitação

O exemplo a seguir mostra como fazer uma única chamada de função delta e limitar o número máximo de pastas de contato no corpo da resposta a 2.

Para controlar as alterações nas pastas de contato de uma caixa de correio, faça uma ou mais chamadas de função delta, com os tokens de estado apropriados, para obter o conjunto de alterações incrementais desde a última consulta delta.

Pode encontrar um exemplo semelhante que mostra como utilizar os tokens de estado para controlar as alterações nas mensagens de uma pasta de correio: Obter alterações incrementais às mensagens numa pasta. As principais diferenças entre controlar pastas de contactos e controlar mensagens numa pasta estão nos URLs do pedido de consulta delta e nas respostas de consulta que devolvem contactFolderem vez de coleções de mensagens.

GET https://graph.microsoft.com/beta/me/contactFolders/delta

Prefer: odata.maxpagesize=2

mgc-beta users contact-folders delta get --user-id {user-id}

const options = {
	authProvider,
};

const client = Client.init(options);

let delta = await client.api('/me/contactFolders/delta')
	.version('beta')
	.get();

Resposta

Se a solicitação for bem-sucedida, a resposta incluiria um token de estado que é um skipToken
(num cabeçalho de resposta @odata.nextLink ) ou num deltaToken (num cabeçalho de resposta @odata.deltaLink ). Respetivamente, indicam se deve continuar com a ronda ou se concluiu a obtenção de todas as alterações para essa ronda.

A resposta abaixo mostra um skipToken em um cabeçalho de resposta @odata.nextLink.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 200 OK
Content-type: application/json

{
  "@odata.nextLink":"https://graph.microsoft.com/beta/me/contactfolders/delta?$skiptoken={_skipToken_}",
  "value": [
    {
     "parentFolderId": "parentFolderId-value",
      "displayName": "displayName-value",
      "wellKnownName": "wellKnownName-value",
      "id": "id-value"
    }
  ]
}

Conteúdo relacionado

• Consulta delta do Microsoft Graph
• Obter as alterações incrementais para as mensagens em uma pasta