Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Espace de noms: microsoft.graph
Créez un objet userAccountInformation dans le profil d’un utilisateur.
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) | User.ReadWrite | AgentIdUser.ReadWrite.All, AgentIdUser.ReadWrite.IdentityParentedBy, User.ReadWrite.All |
| Déléguée (compte Microsoft personnel) | User.ReadWrite | Non disponible. |
| Application | Non prise en charge. | Non prise en charge. |
Requête HTTP
POST /me/profile/account
POST /users/{id | userPrincipalName}/profile/account
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. |
Corps de la demande
Dans le corps de la demande, fournissez une représentation JSON de l’objet userAccountInformation .
Le tableau suivant indique les propriétés requises lorsque vous créez un objet userAccountInformation .
| Propriété | Type | Description |
|---|---|---|
| allowedAudiences | String | Audiences qui peuvent voir les valeurs contenues dans l’entité. Hérité de itemFacet. Les valeurs possibles sont : me, family, contacts, groupMembers, organization, federatedOrganizations, everyone, , . unknownFutureValue |
| countryCode | String | Contient le code de pays à deux caractères associé au compte d’utilisateur. |
| Inférence | inferenceData | Contient les détails de l’inférence si l’entité est déduite par l’application de création ou de modification. Hérité de itemFacet. |
| preferredLanguageTag | localeInfo | Contient la langue que l’utilisateur a associée comme langue préférée pour le compte. |
| source | personDataSource | D’où proviennent les valeurs si elles sont synchronisées à partir d’un autre service. Hérité de itemFacet. |
Réponse
Si elle réussit, cette méthode renvoie un 201 Created code de réponse et un objet userAccountInformation dans le corps de la réponse.
Exemples
POST https://graph.microsoft.com/beta/me/profile/account
Content-Type: application/json
{
"allowedAudiences": "organization",
"countryCode": "NO",
}
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
{
"id": "0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f",
"allowedAudiences": "organization",
"inference": null,
"createdDateTime": "2020-07-06T06:34:12.2294868Z",
"createdBy": {
"application": null,
"device": null,
"user": {
"displayName": "Innocenty Popov",
"id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
}
},
"lastModifiedDateTime": "2020-07-06T06:34:12.2294868Z",
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"displayName": "Innocenty Popov",
"id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
}
},
"source": null,
"ageGroup": "adult",
"countryCode": "NO",
"preferredLanguageTag": null,
"userPrincipalName": "innocenty.popov@adventureworks.com",
"originTenantInfo": null,
"userPersona": null
}