Profiles - Get

Başvuru

Service:: Profile

API Version:: 7.1-preview.3

Bir kullanıcı profili alır.

GET https://app.vssps.visualstudio.com/_apis/profile/profiles/{id}?api-version=7.1-preview.3

With optional parameters:

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

HTTP

GET https://app.vssps.visualstudio.com/_apis/profile/profiles/{id}?api-version=7.1-preview.3

Sample Response

Status code:: 200

{
  "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.