Ajout de données personnalisées à des utilisateurs à l’aide des extensions d’ouverture

Cet article explique comment utiliser des extensions ouvertes.

Imaginez que vous créez une application qui est disponible sur plusieurs plateformes clientes, telles que les ordinateurs de bureau et les appareils mobiles. Vous souhaitez permettre aux utilisateurs de configurer leur expérience d’interface utilisateur pour qu’elle soit cohérente quel que soit le périphérique utilisé pour se connecter à votre application.

Pour ce scénario, cet article vous explique comment procéder aux opérations suivantes :

  1. Ajouter une extension d’ouverture représentant certaines informations de profil d’itinérance sur l’utilisateur.
  2. Interroger l’utilisateur et renvoyer le profil d’itinérance.
  3. Modifier les informations de profil d’itinérance de l’utilisateur (la valeur de l’extension d’ouverture).
  4. Supprimer les informations de profil d’itinérance de l’utilisateur.

Remarque

Outre les utilisateurs, les extensions ouvertes sont également prises en charge et peuvent être gérées pour d’autres types de ressources.

1. Ajout d’informations de profil d’itinérance

L’utilisateur se connecte à l’application et configure l’apparence de l’application. Ces paramètres d’application doivent être itinérants afin de garantir la même expérience à l’utilisateur sur n’importe quel appareil utilisé pour se connecter à l’application. L’application appelle Microsoft Graph en exécutant la requête suivante pour ajouter les informations de profil d’itinérance à une ressource utilisateur.

Demande

POST https://graph.microsoft.com/v1.0/me/extensions
Content-type: application/json

{
    "@odata.type":"microsoft.graph.openTypeExtension",
    "extensionName":"com.contoso.roamingSettings",
    "theme":"dark",
    "color":"purple",
    "lang":"Japanese"
}

Réponse

HTTP/1.1 201 Created
Content-Type: application/json

{
    "@odata.type": "#microsoft.graph.openTypeExtension",
    "extensionName": "com.contoso.roamingSettings",
    "id": "com.contoso.roamingSettings",
    "theme": "dark",
    "color": "purple",
    "lang": "Japanese"
}

2. Récupération des informations de profil d’itinérance

Lorsque l’utilisateur se connecte à l’application à partir d’un autre appareil, l’application appelle Microsoft Graph pour récupérer les détails du profil de l’utilisateur et développer la propriété de navigation des extensions pour obtenir ses paramètres d’itinérance.

Demande

GET https://graph.microsoft.com/v1.0/me?$select=id,displayName,mail,mobilePhone&$expand=extensions

Réponse

HTTP/1.1 200 OK
Content-Type: application/json

{
    "id": "84b80893-8749-40a3-97b7-68513b600544",
    "displayName": "John Smith",
    "mail": "john@contoso.com",
    "mobilePhone": "1-555-6589",
    "extensions": [
        {
            "@odata.type": "#microsoft.graph.openTypeExtension",
            "extensionName": "com.contoso.roamingSettings",
            "id": "com.contoso.roamingSettings",
            "theme": "dark",
            "color": "purple",
            "lang": "Japanese"
        }
    ]
}

3. Modification des informations de profil d’itinérance

L’utilisateur peut choisir de modifier ses informations de profil d’itinérance. L’application appelle Microsoft Graph en exécutant la requête suivante.

Demande

PATCH https://graph.microsoft.com/v1.0/me/extensions/com.contoso.roamingSettings
Content-type: application/json

{
    "theme":"light",
    "color":"yellow",
    "lang":"Swahili"
}

Réponse

HTTP/1.1 204 No content

4. Suppression du profil d’itinérance d’un utilisateur

L’utilisateur décide qu’il ne veut plus d’un profil itinérant. Il le supprime et l’application appelle Microsoft Graph en exécutant la requête suivante.

Demande

DELETE https://graph.microsoft.com/v1.0/me/extensions/com.contoso.roamingSettings

Réponse

HTTP/1.1 204 No content

Voir aussi