Aracılığıyla paylaş


Profiles - Get

Bir kullanıcı profili alır.

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

URI Parametreleri

Name İçinde Gerekli Tür Description
id
path True

string

Aynı kuruluştaki hedef kullanıcı profilinin kimliği veya geçerli kimliği doğrulanmış kullanıcının profilini almak için 'ben'.

api-version
query True

string

Kullanılacak API sürümü. Api'nin bu sürümünü kullanmak için bu değer '7.1-preview.3' olarak ayarlanmalıdır.

coreAttributes
query

string

Döndürülecek çekirdek profil özniteliklerinin virgülle ayrılmış listesi. Geçerli değerler Email, Avatar, DisplayName ve ContactWithOffers'tır.

details
query

boolean

Görünen ad, e-posta adresi, ülke gibi genel profil bilgilerini iade edin. false ise, withAttributes parametresi yoksayılır.

forceRefresh
query

boolean

API'nin bu sürümünde kullanılmaz.

partition
query

string

Döndürülecek özniteliklerin bölümü (adlandırılmış grup).

withAttributes
query

boolean

True ise, profille ilişkili öznitelikleri (rastgele verilerin anahtar-değer çiftleri olarak adlandırılır) alır. Bölüm parametresinin de bir değeri olmalıdır.

Yanıtlar

Name Tür Description
200 OK

Profile

başarılı işlem

Güvenlik

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

Name Description
vso.profile Profilinizi, hesaplarınızı, koleksiyonlarınızı, projelerinizi, ekiplerinizi ve diğer üst düzey kuruluş yapıtlarınızı okuma olanağı sağlar.

Örnekler

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
}

Tanımlar

Name Description
AttributeDescriptor

Adı ve kapsayıcısı olan bir özniteliği tanımlar.

AttributesContainer

Adlandırılmış profil öznitelikleri kümesini depolar.

CoreProfileAttribute

Her profil için her zaman bir değere sahip olan profil özniteliği.

Profile

Bir kullanıcı profili.

ProfileAttribute

Profille ilişkilendirilmiş adlandırılmış nesne.

ProfileState

Profilin geçerli durumu.

AttributeDescriptor

Adı ve kapsayıcısı olan bir özniteliği tanımlar.

Name Tür Description
attributeName

string

Özniteliğin adı.

containerName

string

Özniteliğin bulunduğu kapsayıcı.

AttributesContainer

Adlandırılmış profil öznitelikleri kümesini depolar.

Name Tür Description
attributes

<string,  ProfileAttribute>

Kapsayıcı tarafından depolanan öznitelikler.

containerName

string

Kapsayıcının adı.

revision

integer

Kapsayıcı içindeki herhangi bir özniteliğin en yüksek düzeltme sayısı.

CoreProfileAttribute

Her profil için her zaman bir değere sahip olan profil özniteliği.

Name Tür Description
descriptor

AttributeDescriptor

özniteliğinin tanımlayıcısı.

revision

integer

Özniteliğin düzeltme numarası.

timeStamp

string

Özniteliğin son değiştirilme zamanı.

value

string

özniteliğinin değeri.

Profile

Bir kullanıcı profili.

Name Tür Description
applicationContainer

AttributesContainer

Bu profilin öznitelikleri.

coreAttributes

<string,  CoreProfileAttribute>

Bu profilin temel öznitelikleri.

coreRevision

integer

Herhangi bir özniteliğin en fazla düzeltme sayısı.

id

string

Profilin benzersiz tanımlayıcısı.

profileState

ProfileState

Profilin geçerli durumu.

revision

integer

Herhangi bir özniteliğin en fazla düzeltme sayısı.

timeStamp

string

Bu profilin en son değiştirildiği saat.

ProfileAttribute

Profille ilişkilendirilmiş adlandırılmış nesne.

Name Tür Description
descriptor

AttributeDescriptor

özniteliğinin tanımlayıcısı.

revision

integer

Özniteliğin düzeltme numarası.

timeStamp

string

Özniteliğin son değiştirilme zamanı.

value

string

özniteliğinin değeri.

ProfileState

Profilin geçerli durumu.

Name Tür Description
custom

string

Profil kullanımda.

customReadOnly

string

Profil kullanımda ancak yalnızca okunabilir.

readOnly

string

Profil yalnızca okunabilir.