Insérer des lieux

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 .

Upsert un ou plusieurs objets de lieu en mode asynchrone. Cette API vous permet de créer et de mettre à jour efficacement plusieurs endroits dans une seule requête.

Pour plus d’informations sur l’utilisation de cette API, notamment les scénarios, les meilleures pratiques et les limites de simultanéité, consultez Utilisation de l’API Upsert Places dans Microsoft Graph.

Remarque

  • Les opérations sont conservées pendant 15 jours à compter de leur création.
  • Cette API a une limite de limitation de trois appels par seconde. Pour plus d’informations, voir Limites spécifiques au service Microsoft Graph.
  • Toutes les demandes nécessitent l’en-tête OData-Version: 4.01 .
  • Actuellement, cette API ne prend pas en charge le mode d’affectation pour les bureaux ou la propriété pour les isTeamsEnabled salles.
  • Pour l’instant, l’opération de lieu ne peut pas gérer un grand nombre d’endroits à la fois, en particulier les salles, les bureaux et les espaces de travail. La limite actuelle est d’environ 20 à 30 salles, bureaux ou espaces de travail.

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme étant les moins privilégiées pour cette API. Utilisez une ou plusieurs autorisations privilégiées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, voir Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez la référence des autorisations.

Type d’autorisation Autorisations les moins privilégiées Autorisations à privilèges plus élevés
Déléguée (compte professionnel ou scolaire) Place.ReadWrite.All Non disponible.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application Place.ReadWrite.All Non disponible.

Importante

Pour l’accès délégué à l’aide de comptes professionnels ou scolaires, l’utilisateur connecté doit disposer d’un rôle Microsoft Entra pris en charge ou d’un rôle personnalisé qui accorde les autorisations requises pour cette opération. Administrateur Exchange est le rôle le moins privilégié pris en charge pour cette opération.

Lorsque vous utilisez des autorisations d’application, vous devez configurer le rôle requis TenantPlacesManagement (pour gérer les Places) et le rôle (pour gérer les utilisateurs et les MailRecipient boîtes aux lettres). Pour plus d’informations sur la configuration de ces rôles, consultez Access Control basées sur les rôles pour les applications dans Exchange Online.

Requête HTTP

PATCH /places

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et les autorisations.
Content-Type application/json. Obligatoire.
OData-Version 4.01. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON de l’ensemble delta place .

Les mêmes propriétés peuvent être spécifiées que lorsque vous créez ou mettez à jour un objet place .

Réponse

En cas de réussite, cette méthode renvoie un 202 Accepted code de réponse et une URL d’opération dans l’en-tête de réponse Location que vous pouvez utiliser pour obtenir l’opération.

Exemple

Demande

L’exemple suivant illustre une requête qui combine plusieurs opérations, notamment la mise à jour d’un bâtiment existant, la création de nouveaux emplacements avec une hiérarchie et la mise à jour des propriétés :

  • Mettez à jour un bâtiment existant pour définir le nom d’affichage sur Demo Building A, activer le Wi-Fi et créer un nouvel étage Demo Floor 1 en tant qu’enfant du bâtiment mis à jour.
  • Créez un bâtiment Demo Building B avec un étage Demo Floor 1 enfant qui contient une nouvelle section Demo Section A avec un bureau existant et une nouvelle salle Demo Room 1.
  • Créez un espace de travail en mode réservable sous un parent existant.
  • Mettre à jour le nom complet d’une section existante.
PATCH https://graph.microsoft.com/beta/places
Content-Type: application/json
OData-Version: 4.01

{
  "@context": "#$delta",
  "value": [
    {
      "@odata.type": "microsoft.graph.building",
      "id": "25e5905a-7fee-4f36-ba31-29e85c14bf18",
      "displayName": "Demo Building A",
      "hasWifi": true,
      "children@delta": [
        {
          "@odata.type": "microsoft.graph.floor",
          "displayName": "Demo Floor 1"
        }
      ]
    },
    {
      "@odata.type": "microsoft.graph.building",
      "displayName": "Demo Building B",
      "children@delta": [
        {
          "@odata.type": "microsoft.graph.floor",
          "displayName": "Demo Floor 1",
          "children@delta": [
            {
              "@odata.type": "microsoft.graph.section",
              "displayName": "Demo Section A",
              "children@delta": [
                {
                  "@odata.type": "#microsoft.graph.desk",
                  "id": "211ffb37-e880-475a-b73a-43f484609536"
                },
                {
                  "@odata.type": "#microsoft.graph.room",
                  "displayName": "Demo Room 1"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "@odata.type": "microsoft.graph.workspace",
      "parentId": "2cb2701d-0896-4c69-91bb-582d82d7c68c",
      "displayName": "Demo Workspace 1",
      "mode": {
        "@odata.type": "#microsoft.graph.reservablePlaceMode"
      }
    },
    {
      "@odata.type": "#microsoft.graph.section",
      "id": "2cb2701d-0896-4c69-91bb-582d82d7c68c",
      "displayName": "HR"
    }
  ]
}

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/beta/places/getOperation(id='0f5d3cc5-d1bd-4cba-9b0e-e9ad68527ab5')
  • Dernière mise à jour :