Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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"]
}