Upsert de locais

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Executar upsert de um ou mais objetos de colocação no modo assíncrono. Essa API permite que você crie e atualize vários locais com eficiência em uma única solicitação.

Para obter mais informações sobre como usar essa API, incluindo cenários, práticas recomendadas e limites de simultaneidade, consulte Trabalhar com a API do Places com upsert no Microsoft Graph.

Observação

  • As operações são mantidas por 15 dias a partir da criação.
  • Essa API tem um limite de limitação de três chamadas por segundo. Para obter mais informações, consulte Limites de limitação específicos do serviço do Microsoft Graph.
  • Todas as solicitações exigem o OData-Version: 4.01 cabeçalho.
  • Atualmente, essa API não dá suporte ao modo atribuído para mesas ou à isTeamsEnabled propriedade para salas.
  • Por enquanto, a operação de local não pode lidar com um grande número de lugares ao mesmo tempo, especialmente salas, mesas e espaços de trabalho. O limite atual é de aproximadamente 20 a 30 salas, mesas ou espaços de trabalho.

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante) Place.ReadWrite.All Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application Place.ReadWrite.All Indisponível.

Importante

Para acesso delegado usando contas corporativas ou de estudante, o usuário conectado deve receber uma função do Microsoft Entra com suporte ou uma função personalizada que conceda as permissões necessárias para esta operação. Administrador do Exchange é a função com menos privilégios com suporte para esta operação.

Ao usar permissões de aplicativo, você deve configurar a função necessária TenantPlacesManagement (para gerenciar o Places) e a MailRecipient função (para gerenciar usuários e caixas de correio). Para obter mais informações sobre como configurar essas funções, consulte Controle de Controle de Acesso Baseado em Função para Aplicativos no Exchange Online.

Solicitação HTTP

PATCH /places

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.
OData-Version 4.01. Obrigatório.

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON do conjunto delta do local .

As mesmas propriedades podem ser especificadas como quando você cria ou atualiza um objeto de lugar .

Resposta

Se for bem-sucedido, esse método retornará um código de 202 Accepted resposta e uma URL de operação no cabeçalho de Location resposta que você pode usar para obter a operação.

Exemplo

Solicitação

O exemplo a seguir mostra uma solicitação que combina várias operações, incluindo a atualização de um edifício existente, a criação de novos locais com uma hierarquia e a atualização de propriedades:

  • Atualize um edifício existente para definir o nome de exibição como Demo Building A, habilite o Wi-Fi e crie um novo andar Demo Floor 1 como filho do edifício atualizado.
  • Crie um novo edifício Demo Building B com um andar Demo Floor 1 filho que contenha uma nova seção Demo Section A com uma mesa existente e uma nova sala Demo Room 1.
  • Crie um novo espaço de trabalho no modo reservável com um pai existente.
  • Atualize o nome de exibição de uma seção existente.
PATCH https://graph.microsoft.com/beta/places
Content-Type: application/json
OData-Version: 4.01

{
  "@context": "#$delta",
  "value": [
    {
      "@odata.type": "microsoft.graph.building",
      "id": "25e5905a-7fee-4f36-ba31-29e85c14bf18",
      "displayName": "Demo Building A",
      "hasWifi": true,
      "children@delta": [
        {
          "@odata.type": "microsoft.graph.floor",
          "displayName": "Demo Floor 1"
        }
      ]
    },
    {
      "@odata.type": "microsoft.graph.building",
      "displayName": "Demo Building B",
      "children@delta": [
        {
          "@odata.type": "microsoft.graph.floor",
          "displayName": "Demo Floor 1",
          "children@delta": [
            {
              "@odata.type": "microsoft.graph.section",
              "displayName": "Demo Section A",
              "children@delta": [
                {
                  "@odata.type": "#microsoft.graph.desk",
                  "id": "211ffb37-e880-475a-b73a-43f484609536"
                },
                {
                  "@odata.type": "#microsoft.graph.room",
                  "displayName": "Demo Room 1"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "@odata.type": "microsoft.graph.workspace",
      "parentId": "2cb2701d-0896-4c69-91bb-582d82d7c68c",
      "displayName": "Demo Workspace 1",
      "mode": {
        "@odata.type": "#microsoft.graph.reservablePlaceMode"
      }
    },
    {
      "@odata.type": "#microsoft.graph.section",
      "id": "2cb2701d-0896-4c69-91bb-582d82d7c68c",
      "displayName": "HR"
    }
  ]
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/beta/places/getOperation(id='0f5d3cc5-d1bd-4cba-9b0e-e9ad68527ab5')
  • Última atualização em