Comentários Editar

Atualizar local

  • Artigo
  • 11 minutos para o fim da leitura

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 de versão.

Atualize as propriedades do objeto place , que pode ser uma room ou roomList. Você pode identificar a sala ou roomList especificando a id ou a propriedade emailAddress .

Permissões

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegada (conta corporativa ou de estudante) Place.ReadWrite.All
Delegada (conta pessoal da Microsoft) Sem suporte.
Aplicativo Sem suporte

Solicitação HTTP

PATCH /places/{id | emailAddress}

Cabeçalhos de solicitação

Nome Valor
Autorização {token} de portador. Obrigatório.
Content-Type application/json. Obrigatório.

Corpo da solicitação

No corpo da solicitação, forneça os valores para os campos relevantes que devem ser atualizados. Apenas uma instância de um recurso de local (room ou roomList) pode ser atualizada por vez. No corpo da solicitação, use @odata.type para especificar o tipo de local e inclua as propriedades desse tipo a serem atualizadas. Propriedades existentes que não estão incluídas no corpo da solicitação terão seus valores anteriores mantidos ou serão recalculadas com base nas alterações a outros valores de propriedade. Para alcançar o melhor desempenho, não inclua valores existentes que não foram alterados.

Propriedade Tipo Descrição
address physicalAddress O endereço da sala ou da lista de sala.
audioDeviceName String Especifica o nome do dispositivo de áudio na sala.
bookingType bookingType Tipo de sala. Os valores possíveis são: Standard e Reserved.
Edifício String Especifica o nome do prédio ou o número de construção em que a sala está.
Capacidade Int32 Especifica a capacidade da sala.
displayDeviceName String Especifica o nome do dispositivo de exibição na sala.
floorLabel Cadeia de caracteres Especifica a letra do chão em que a sala está.
floorNumber Int32 Especifica o número do andar em que a sala está.
geoCoordinates outlookGeoCoordinates Especifica o local da sala ou da lista de quarto em coordenadas de latitude, longitude e, opcionalmente, altitude.
isWheelChairAccessible Booleano Especifica se a sala é acessível para cadeira de rodas.
rótulo Cadeia de caracteres Especifica um rótulo descritivo para a sala, por exemplo, um número ou nome.
Alcunha String Especifica um apelido para a sala, por exemplo, "sala de conf".
phone Cadeia de caracteres O número de telefone da sala ou da lista de quarto.
categorias Coleção de cadeias de caracteres Especifica recursos adicionais da sala, por exemplo, detalhes como o tipo de exibição ou tipo de móveis.
videoDeviceName Cadeia de caracteres Especifica o nome do dispositivo de vídeo na sala.

Resposta

Se tiver êxito, este método retornará um código 200 OK de resposta e um objeto de local atualizado no corpo da resposta.

Exemplos

Exemplo 1: Atualizar uma sala

Solicitação

Este é um exemplo de solicitação.

PATCH https://graph.microsoft.com/beta/places/cf100@contoso.com
Content-type: application/json

{
  "@odata.type": "microsoft.graph.room",
  "nickname": "Conf Room",
  "building": "1",
  "label": "100",
  "capacity": 50,
  "isWheelChairAccessible": false
}

Resposta

Este é um exemplo de resposta.

Observação

O objeto de resposta mostrado aqui pode ser reduzido para facilitar a leitura.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#places/$entity",
    "@odata.type": "#microsoft.graph.room",
    "id": "3162F1E1-C4C0-604B-51D8-91DA78989EB1",
    "emailAddress": "cf100@contoso.com",
    "displayName": "Conf Room 100",
    "address": {
      "street": "4567 Main Street",
      "city": "Buffalo",
      "state": "NY",
      "postalCode": "98052",
      "countryOrRegion": "USA"
    },
    "geoCoordinates": {
      "latitude": 47.0,
      "longitude": -122.0
    },
    "phone": "555-555-0100",
    "nickname": "Conf Room",
    "label": "100",
    "capacity": 50,
    "building": "1",
    "floorLabel": "1P",
    "floorNumber": 1,
    "isManaged": true,
    "isWheelChairAccessible": false,
    "bookingType": "standard",
    "tags": [
      "bean bags"
    ],
    "audioDeviceName": null,
    "videoDeviceName": null,
    "displayDevice": "surface hub"
}

Exemplo 2: atualizar uma lista de quarto

Solicitação

Este é um exemplo de solicitação.

PATCH https://graph.microsoft.com/beta/places/Building1RroomList@contoso.onmicrosoft.com
Content-type: application/json

{
  "@odata.type": "microsoft.graph.roomList",
  "displayName": "Building 1",
  "phone":"555-555-0100",
  "address": {
    "street": "4567 Main Street",
    "city": "Buffalo",
    "state": "NY",
    "postalCode": "98052",
    "countryOrRegion": "USA"
  },
  "geoCoordinates": {
    "altitude": null,
    "latitude": 47.0,
    "longitude": -122.0,
    "accuracy": null,
    "altitudeAccuracy": null
 }
}

Resposta

Este é um exemplo de resposta.

Observação

O objeto de resposta mostrado aqui pode ser reduzido para facilitar a leitura.

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#places/$entity",
  "@odata.type": "#microsoft.graph.roomList",
  "id": "DC404124-302A-92AA-F98D-7B4DEB0C1705",
  "displayName": "Building 1",
  "address": {
    "street": "4567 Main Street",
    "city": "Buffalo",
    "state": "NY",
    "postalCode": "98052",
    "countryOrRegion": "USA"
  },
  "geoCoordinates": {
    "altitude": null,
    "latitude": 47.0,
    "longitude": -122.0,
    "accuracy": null,
    "altitudeAccuracy": null
 },
  "phone": "555-555-0100",
  "emailAddress": "bldg1@contoso.com"
}