Trabalhar com o upsert da API Places no Microsoft Graph

A API de upsert places permite que você crie e atualize com eficiência vários locais em uma única operação assíncrona.

Cenários com suporte

Há suporte para os seguintes cenários ao usar a API de upsert places :

  • Crie vários locais independentes.
  • Crie locais com hierarquia, incluindo novos lugares filho em um local existente.
  • Atualize vários locais independentes.
  • Atualize a hierarquia dos lugares, incluindo mover um local existente para um novo local.

Entender o conteúdo da solicitação

As seguintes considerações se aplicam ao executar operações de criação ou atualização em massa em locais:

  • Criar vs. atualizar: Places sem uma propriedade id são criados e locais com uma propriedade id são atualizados por ID.
  • Hierarquia de lugares: use a propriedade children@delta para criar ou atualizar locais filhos em um local pai. A propriedade parentId é definida automaticamente para lugares filhos.
  • O modo atribuído ainda não é compatível com locais de upsert .
  • Não há suporte para atualizar um local filho existente em um local pai existente usando children@delta propriedade. Eles devem ser atualizados separadamente.

Simultaneidade no nível do trabalho

A simultaneidade no nível do trabalho limita o número de operações de upsert places que podem ser executadas simultaneamente em um locatário.

  • Apenas três operações simultâneas de locais de upsert são permitidas no nível do locatário.
  • Se três operações já tiverem sido criadas ou estiverem em andamento, outra PATCH chamada à API será rejeitada com um código de 429 Too Many Requests resposta.

Conteúdo relacionado

  • Última atualização em