Tipo de recurso de ubicación

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Representa diferentes tipos de espacio dentro de un espacio empresarial. Para obtener más información, consulte Trabajar con la API de Places en Microsoft Graph.

Tipo base de edificio, escritorio, suelo, sala, roomList, sección y área de trabajo.

Métodos

Método Tipo devuelto Description
Enumerar lugares colección de lugares Obtener una colección del tipo especificado de objetos de lugar definidos en un inquilino.
Crear lugar lugar Crear un nuevo objeto de posición .
Obtener lugar lugar Leer las propiedades de un objeto de posición . Devuelve el tipo de lugar derivado solicitado.
Lugar de actualización lugar Actualice las propiedades del objeto de lugar que puede ser un edificio, un suelo, una sección, un escritorio, una sala, un área de trabajo o un roomList.
Eliminar lugar Ninguno Eliminar un objeto de sitio .
Enumerar descendientes colección de lugares Reúne a todos los descendientes de un tipo específico en un lugar.
Crear notificación de registro checkInClaim Cree un nuevo objeto checkInClaim para registrar el estado de registro de un lugar específico, como un escritorio, una sala o un área de trabajo, asociado a una reserva de calendario específica.
Lugares de Upsert Encabezado de ubicación Actualizar/insertar (upsert) uno o varios objetos de lugar en modo asincrónico.
Operación Get placeOperation Obtener una placeOperation por id.
Operaciones de lista Colección placeOperation Enumerar todos los objetos placeOperation existentes.

Propiedades

Propiedad Tipo Descripción
address physicalAddress La dirección física del lugar, incluida la calle, la ciudad, el estado, el país o región y el código postal.
customProperties stringDictionary Propiedades personalizadas para el lugar. Cada propiedad tiene una clave de cadena y un valor de cadena. Admite valores NULL.
displayName Cadena El nombre que está asociado con el lugar.
geocoordenadas outlookGeoCoordinates Especifica la ubicación del lugar en coordenadas de latitud, longitud y (opcionalmente) altitud.
id Cadena El identificador único del lugar. Solo lectura. Este identificador no es inmutable y puede cambiar si cambia la configuración del buzón o del inquilino.
isWheelChairAccessible Booleano Indica si el lugar es accesible en silla de ruedas.
etiqueta Cadena Descripción del lugar definida por el usuario.
lastUpdatedTime DateTimeOffset La fecha y hora en que se actualizó por última vez el lugar . La marca de tiempo tiene el formato ISO 8601 y siempre está en UTC. Solo lectura. Admite valores NULL.
parentId Cadena El identificador de una ubicación principal.
phone Cadena El número de teléfono del lugar.
placeId Cadena Identificador de nivel de servicio estable para el objeto de lugar que usan las cargas de trabajo de Places.
tags Colección string Etiquetas personalizadas que están asociadas al lugar para la categorización o el filtrado.

Relaciones

Relación Tipo Description
checkIns Colección checkInClaim Subrecurso de un objeto place que indica el estado de comprobación de un evento de calendario de Outlook reservado en el lugar.
secundario colección de lugares Una colección de lugares secundarios que solo se usa en la API de lugares de Upsert.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "@odata.type": "#microsoft.graph.place",
  "address": {"@odata.type": "microsoft.graph.physicalAddress"},
  "customProperties": {"String": "String"},
  "displayName": "String",
  "geoCoordinates": {"@odata.type": "microsoft.graph.outlookGeoCoordinates"},
  "id": "String (identifier)",
  "isWheelChairAccessible": "Boolean",
  "label": "String",
  "lastUpdatedTime": "String (timestamp)",
  "parentId": "String",
  "phone": "String",
  "placeId": "String (alternative identifier)",
  "tags": ["String"]
}

Trabajar con la API de Places en Microsoft Graph