Profiles - Get
Obtient un profil utilisateur.
GET https://app.vssps.visualstudio.com/_apis/profile/profiles/{id}?api-version=7.1-preview.3
GET https://app.vssps.visualstudio.com/_apis/profile/profiles/{id}?details={details}&withAttributes={withAttributes}&partition={partition}&coreAttributes={coreAttributes}&forceRefresh={forceRefresh}&api-version=7.1-preview.3
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
id
|
path | True |
string |
ID du profil utilisateur cible dans le même organization, ou « moi » pour obtenir le profil de l’utilisateur authentifié actuel. |
api-version
|
query | True |
string |
Version de l’API à utiliser. Cette valeur doit être définie sur « 7.1-preview.3 » pour utiliser cette version de l’API. |
core
|
query |
string |
Liste délimitée par des virgules des attributs de profil principaux à retourner. Les valeurs valides sont Email, Avatar, DisplayName et ContactWithOffers. |
|
details
|
query |
boolean |
Retourner des informations de profil public telles que le nom d’affichage, l’adresse e-mail, le pays, etc. Si la valeur est false, le paramètre withAttributes est ignoré. |
|
force
|
query |
boolean |
Non utilisé dans cette version de l’API. |
|
partition
|
query |
string |
Partition (groupe nommé) des attributs à retourner. |
|
with
|
query |
boolean |
Si la valeur est true, obtient les attributs (des paires clé-valeur nommées de données arbitraires) associés au profil. Le paramètre de partition doit également avoir une valeur. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
opération réussie |
Sécurité
oauth2
Type:
oauth2
Flow:
accessCode
Authorization URL:
https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL:
https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer
Scopes
Nom | Description |
---|---|
vso.profile | Permet de lire votre profil, comptes, collections, projets, équipes et autres artefacts organisationnels de niveau supérieur. |
Exemples
Sample Request
GET https://app.vssps.visualstudio.com/_apis/profile/profiles/{id}?api-version=7.1-preview.3
Sample Response
{
"displayName": "Normal Paulk",
"publicAlias": "d6245f20-2af8-44f4-9451-8107cb2767db",
"emailAddress": "fabrikamfiber16@hotmail.com",
"coreRevision": 1647,
"timeStamp": "2014-05-12T22:23:07.727+00:00",
"id": "d6245f20-2af8-44f4-9451-8107cb2767db",
"revision": 1647
}
Définitions
Nom | Description |
---|---|
Attribute |
Identifie un attribut avec un nom et un conteneur. |
Attributes |
Stocke un ensemble d’attributs de profil nommés. |
Core |
Attribut de profil qui a toujours une valeur pour chaque profil. |
Profile |
Profil utilisateur. |
Profile |
Objet nommé associé à un profil. |
Profile |
État actuel du profil. |
AttributeDescriptor
Identifie un attribut avec un nom et un conteneur.
Nom | Type | Description |
---|---|---|
attributeName |
string |
Nom de l'attribut. |
containerName |
string |
Conteneur dans lequel réside l’attribut. |
AttributesContainer
Stocke un ensemble d’attributs de profil nommés.
Nom | Type | Description |
---|---|---|
attributes |
<string,
Profile |
Attributs stockés par le conteneur. |
containerName |
string |
nom du conteneur. |
revision |
integer |
Nombre maximal de révision d’un attribut dans le conteneur. |
CoreProfileAttribute
Attribut de profil qui a toujours une valeur pour chaque profil.
Nom | Type | Description |
---|---|---|
descriptor |
Descripteur de l’attribut. |
|
revision |
integer |
Numéro de révision de l’attribut. |
timeStamp |
string |
Heure de la dernière modification de l’attribut. |
value |
string |
Valeur de l'attribut. |
Profile
Profil utilisateur.
Nom | Type | Description |
---|---|---|
applicationContainer |
Attributs de ce profil. |
|
coreAttributes |
<string,
Core |
Attributs principaux de ce profil. |
coreRevision |
integer |
Nombre maximal de révision d’un attribut. |
id |
string |
Identificateur unique du profil. |
profileState |
État actuel du profil. |
|
revision |
integer |
Nombre maximal de révision d’un attribut. |
timeStamp |
string |
Heure à laquelle ce profil a été modifié pour la dernière fois. |
ProfileAttribute
Objet nommé associé à un profil.
Nom | Type | Description |
---|---|---|
descriptor |
Descripteur de l’attribut. |
|
revision |
integer |
Numéro de révision de l’attribut. |
timeStamp |
string |
Heure de la dernière modification de l’attribut. |
value |
string |
Valeur de l'attribut. |
ProfileState
État actuel du profil.
Nom | Type | Description |
---|---|---|
custom |
string |
Le profil est en cours d’utilisation. |
customReadOnly |
string |
Le profil est en cours d’utilisation, mais ne peut être lu qu’en lecture. |
readOnly |
string |
Le profil peut uniquement être lu. |
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour