Compartir a través de

tipo de recurso place

  • Artículo

Espacio de nombres: microsoft.graph

Representa atributos de ubicación básicos, como el nombre, la dirección física y las coordenadas geográficas. Este recurso es el tipo base para tipos de ubicación más completos, como room y roomList.

Uso de la API places

Exchange Online los administradores pueden organizar las salas de reuniones de un inquilino en listas de salas. Con la API de lugares, puede obtener todas las listas de habitaciones o salas del inquilino, o obtener todas las habitaciones de una lista de salas específica.

Places como room y roomList contienen el identificador básico, el nombre para mostrar y la dirección de correo electrónico. Además, contienen información de navegación, como la dirección física y las coordenadas geográficas, y en el caso de las salas, otra información relevante, como las capacidades av, el número de piso y la capacidad.

Las funciones findRooms y findRoomLists admiten búsquedas similares para las listas de salas y salas de un inquilino. En la tabla siguiente se comparan la API places y estas funciones.

Nota: Las funciones findRooms y findRoomLists están en desuso .

API de Places Funciones findRooms y findRoomLists (en desuso)
Obtiene todas las salas o listas de habitaciones de un inquilino y todas las habitaciones de una lista de habitaciones. Obtiene todas las salas o listas de habitaciones de un inquilino y todas las habitaciones de una lista de habitaciones.
Los lugares de lista pueden devolver más de 100 habitaciones en un inquilino. findRooms vuelve a las primeras 100 habitaciones de un inquilino.
Admite la obtención de una lista individual de habitaciones o habitaciones en un inquilino. No admite la obtención de una lista de habitaciones individuales en un inquilino.
Define las entidades específicas de room y roomList que especifican un conjunto de propiedades más completo, además del nombre para mostrar y la dirección SMTP. Cada sala y lista de salas es de un tipo emailAddress de peso más ligero que especifica solo el nombre para mostrar y la dirección SMTP.
Solo admite escenarios organizativos con permisos delegados (cuentas profesionales o educativas) o permisos de aplicación. Solo admite escenarios organizativos con permisos delegados o de aplicación.
Admite la actualización de una lista de salas o habitaciones individuales en un inquilino. No admite la actualización de una lista de habitaciones individuales en un inquilino.

Métodos

Método Tipo de valor devuelto Descripción
Lugares de lista Colección del tipo de lugar solicitado y derivado Obtenga una colección del tipo especificado de objetos place definidos en el inquilino.
Obtener lugar Tipo de lugar solicitado y derivado Obtenga las propiedades y las relaciones de un objeto place especificado.
Lugar de actualización Tipo de lugar solicitado y derivado Actualice las propiedades y relaciones de un objeto place especificado.

Propiedades

Propiedad Tipo Descripción
address physicalAddress La dirección de la calle del lugar.
displayName Cadena Nombre asociado al lugar.
geoCoordinates outlookGeoCoordinates Especifica la ubicación del lugar en coordenadas de latitud, longitud y altitud (opcionalmente).
id Cadena Identificador único del lugar. Solo lectura. Este identificador no es inmutable y puede cambiar si hay cambios en el buzón o en la configuración del inquilino. La versión beta de esta API tiene una nueva propiedad agregada denominada placeId, que proporciona un identificador inmutable.
phone Cadena El número de teléfono del lugar.

Relaciones

Ninguna.

Representación JSON

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

{
  "address": {"@odata.type": "microsoft.graph.physicalAddress"},
  "displayName": "String",
  "id": "String (identifier)",
  "geoCoordinates": {"@odata.type": "microsoft.graph.outlookGeoCoordinates"},
  "phone": "String"
}

Contenido relacionado