Placer le type de ressource

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Représente différents types d’espace au sein d’un client. Pour plus d’informations, consultez Utilisation de l’API Places dans Microsoft Graph.

Type de base de bâtiment, bureau, étage, salle, roomList, section et espace de travail.

Méthodes

Méthode Type de retour Description
Liste des lieux Placer une collection Obtenez une collection du type spécifié d’objets de lieu définis dans un client.
Créer un lieu lieu Créez un objet place .
Obtenir un emplacement lieu Lire les propriétés d’un objet place . Renvoie le type de lieu dérivé demandé.
Emplacement de mise à jour lieu Mettez à jour les propriétés de l’objet de lieu qui peut être un bâtiment, un étage, une section, un bureau, une salle, un espace de travail ou une liste de salles.
Supprimer un emplacement Aucun Supprimer un objet place .
Liste des descendants Placer une collection Obtenez tous les descendants d’un type spécifique sous un lieu.
Créer une revendication de case activée checkInClaim Créez un objet checkInClaim pour enregistrer le status de case activée pour un endroit spécifique, tel qu’un bureau, une salle ou un espace de travail, associé à une réservation de calendrier spécifique.
Insérer des lieux En-tête Location Upsert un ou plusieurs objets de lieu en mode asynchrone.
Obtenir l’opération placeOperation Obtenir une opération placeOperation par ID.
Répertorier les opérations collection placeOperation Répertorier tous les objets placeOperation existants.

Propriétés

Propriété Type Description
address physicalAddress Adresse physique du lieu, y compris la rue, la ville, l’état, le pays ou la région et le code postal.
propriétés personnalisées stringDictionary Propriétés personnalisées pour le lieu. Chaque propriété possède une clé et une valeur de chaîne. Pouvant accepter la valeur Null.
displayName String Nom associé au lieu.
geoCoordinates outlookGeoCoordinates Spécifie l’emplacement du lieu en coordonnées de latitude, de longitude et (éventuellement) d’altitude.
id String Identifiant unique du lieu. En lecture seule. Cet identificateur n’est pas immuable et peut changer si la boîte aux lettres ou la configuration du locataire change.
isWheelChairAccessible Booléen Indique si l’endroit est accessible aux fauteuils roulants.
étiquette String Description du lieu définie par l’utilisateur.
lastUpdatedTime DateTimeOffset Date et heure de la dernière mise à jour du lieu . L’horodatage est au format ISO 8601 et toujours au format UTC. En lecture seule. Pouvant accepter la valeur Null.
parentId String ID d’un emplacement parent.
phone String Numéro de téléphone de l’endroit.
id de lieu String Identificateur de niveau de service stable pour l’objet de lieu utilisé par les charges de travail Places.
étiquettes String collection Étiquettes personnalisées associées à l’emplacement pour la catégorisation ou le filtrage.

Relations

Relation Type Description
Enregistrements checkInClaim collection Sous-ressource d’un objet de lieu qui indique le status de case activée d’un événement de calendrier Outlook réservé à l’endroit.
children Placer une collection Collection de lieux enfants utilisée uniquement dans l’API Upsert places .

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "@odata.type": "#microsoft.graph.place",
  "address": {"@odata.type": "microsoft.graph.physicalAddress"},
  "customProperties": {"@odata.type": "microsoft.graph.stringDictionary"},
  "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"]
}

Utilisation de l’API Places dans Microsoft Graph