다음을 통해 공유


Profiles - Get

사용자 프로필을 가져옵니다.

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 매개 변수

Name In(다음 안에) 필수 형식 Description
id
path True

string

동일한 organization 내의 대상 사용자 프로필 ID 또는 현재 인증된 사용자의 프로필을 가져오는 'me'입니다.

api-version
query True

string

사용할 API의 버전입니다. 이 버전의 api를 사용하려면 '7.1-preview.3'으로 설정해야 합니다.

coreAttributes
query

string

반환할 핵심 프로필 특성의 쉼표로 구분된 목록입니다. 유효한 값은 Email, 아바타, DisplayName 및 ContactWithOffers입니다.

details
query

boolean

표시 이름, 전자 메일 주소, 국가 등과 같은 공개 프로필 정보를 반환합니다. false이면 withAttributes 매개 변수가 무시됩니다.

forceRefresh
query

boolean

이 버전의 API에서는 사용되지 않습니다.

partition
query

string

반환할 특성의 파티션(명명된 그룹)입니다.

withAttributes
query

boolean

true이면 프로필과 연결된 특성(임의 데이터의 명명된 키-값 쌍)을 가져옵니다. 파티션 매개 변수에도 값이 있어야 합니다.

응답

Name 형식 Description
200 OK

Profile

성공한 작업

보안

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 프로필, 계정, 컬렉션, 프로젝트, 팀 및 기타 최상위 조직 아티팩트 읽기 기능을 부여합니다.

예제

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
}

정의

Name Description
AttributeDescriptor

이름 및 컨테이너를 사용하여 특성을 식별합니다.

AttributesContainer

명명된 프로필 특성 집합을 저장합니다.

CoreProfileAttribute

항상 각 프로필에 대한 값이 있는 프로필 특성입니다.

Profile

사용자 프로필입니다.

ProfileAttribute

프로필과 연결된 명명된 개체입니다.

ProfileState

프로필의 현재 상태입니다.

AttributeDescriptor

이름 및 컨테이너를 사용하여 특성을 식별합니다.

Name 형식 Description
attributeName

string

특성 이름입니다.

containerName

string

특성이 있는 컨테이너입니다.

AttributesContainer

명명된 프로필 특성 집합을 저장합니다.

Name 형식 Description
attributes

<string,  ProfileAttribute>

컨테이너에 의해 저장된 특성입니다.

containerName

string

컨테이너의 이름입니다.

revision

integer

컨테이너 내의 모든 특성의 최대 수정 번호입니다.

CoreProfileAttribute

항상 각 프로필에 대한 값이 있는 프로필 특성입니다.

Name 형식 Description
descriptor

AttributeDescriptor

특성의 설명자입니다.

revision

integer

특성의 수정 번호입니다.

timeStamp

string

특성이 마지막으로 변경된 시간입니다.

value

string

특성 값

Profile

사용자 프로필입니다.

Name 형식 Description
applicationContainer

AttributesContainer

이 프로필의 특성입니다.

coreAttributes

<string,  CoreProfileAttribute>

이 프로필의 핵심 특성입니다.

coreRevision

integer

모든 특성의 최대 수정 버전 수입니다.

id

string

프로필의 고유 식별자입니다.

profileState

ProfileState

프로필의 현재 상태입니다.

revision

integer

모든 특성의 최대 수정 버전 수입니다.

timeStamp

string

이 프로필이 마지막으로 변경된 시간입니다.

ProfileAttribute

프로필과 연결된 명명된 개체입니다.

Name 형식 Description
descriptor

AttributeDescriptor

특성의 설명자입니다.

revision

integer

특성의 수정 번호입니다.

timeStamp

string

특성이 마지막으로 변경된 시간입니다.

value

string

특성 값

ProfileState

프로필의 현재 상태입니다.

Name 형식 Description
custom

string

프로필이 사용 중입니다.

customReadOnly

string

프로필이 사용 중이지만 읽기만 가능합니다.

readOnly

string

프로필은 읽기 전용일 수 있습니다.