Partager via


Créer un profilCardProperty

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 .

Créez un profilCardProperty pour un organization. La nouvelle propriété est identifiée par sa propriété directoryPropertyName .

Pour plus d’informations sur l’ajout de propriétés au carte de profil pour un organization, consultez Ajouter ou supprimer des attributs personnalisés sur un profil carte à l’aide de l’API de carte de profil.

Remarque

Les propriétés de carte de profil correspondent aux attributs dans Microsoft Entra ID. L’ajout d’un attribut en tant que profileCardProperty à la collection profileCardProperties pour un organization configure les cartes de profil pour afficher la valeur de l’attribut. La suppression de profileCardProperty de la collection ne supprime pas l’attribut de Microsoft Entra ID ; elle supprime la configuration afin que les cartes de profil n’affichent plus la valeur de l’attribut.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet

Autorisations

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

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

Note: L’utilisation d’autorisations déléguées pour cette opération nécessite que l’utilisateur connecté ait un rôle Administrateur de locataire.

Requête HTTP

POST /admin/people/profileCardProperties

Remarque : le chemin d’accès /organization/{organizationId}/settings est obsolète. À l’avenir, utilisez le chemin d’accès /admin/people.

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Content-Type application/json. Obligatoire.

Note: Pour éviter les problèmes d’encodage qui malforment la charge utile, utilisez Content-Type: application/json; charset=utf-8.

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON d’un objet profileCardProperty .

Vous pouvez spécifier les propriétés suivantes lorsque vous créez un profileCardProperty pour un organization.

Propriété Type Description
Annotations collection profileCardAnnotation Toutes les étiquettes alternatives ou localisées qu’un administrateur a choisi de spécifier.
directoryPropertyName Chaîne Nom de la propriété de répertoire destinée à apparaître sur le profil carte.

Réponse

Si elle réussit, cette méthode renvoie un 201 Created code de réponse et un nouvel objet profileCardProperty dans le corps de la réponse.

Exemples

Demande

L’exemple suivant illustre une demande.

POST https://graph.microsoft.com/beta/admin/people/profileCardProperties
Content-type: application/json; charset=utf-8

{
  "directoryPropertyName": "CustomAttribute1",
  "annotations": [
    {
      "displayName": "Cost Center",
      "localizations": [
        {
          "languageTag": "ru",
          "displayName": "центр затрат"
        }
      ]
    }
  ]
}

Réponse

L’exemple suivant illustre la réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 201 Created
Content-type: application/json; charset=utf-8

{
  "directoryPropertyName": "CustomAttribute1",
  "annotations": [
    {
      "displayName": "Cost Center",
      "localizations": [
        {
          "languageTag": "ru",
          "displayName": "центр затрат"
        }
      ]
    }
  ]
}