Profiles - Get

Referensi

Service:: Profile

API Version:: 7.1-preview.3

Mendapatkan profil pengguna.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
id	path	True	string	ID profil pengguna target dalam organisasi yang sama, atau 'saya' untuk mendapatkan profil pengguna yang diautentikasi saat ini.
api-version	query	True	string	Versi API yang akan digunakan. Ini harus diatur ke '7.1-preview.3' untuk menggunakan versi api ini.
coreAttributes	query		string	Daftar atribut profil inti yang dibatasi koma untuk dikembalikan. Nilai yang valid adalah Email, Avatar, DisplayName, dan ContactWithOffers.
details	query		boolean	Mengembalikan informasi profil publik seperti nama tampilan, alamat email, negara, dll. Jika false, parameter withAttributes diabaikan.
forceRefresh	query		boolean	Tidak digunakan dalam versi API ini.
partition	query		string	Partisi (grup bernama) atribut yang akan dikembalikan.
withAttributes	query		boolean	Jika true, mendapatkan atribut (bernama pasangan kunci-nilai data arbitrer) yang terkait dengan profil. Parameter partisi juga harus memiliki nilai.

Respons

Nama	Jenis	Deskripsi
200 OK	Profile	operasi berhasil

Keamanan

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

Nama	Deskripsi
vso.profile	Memberikan kemampuan untuk membaca profil, akun, koleksi, proyek, tim, dan artefak organisasi tingkat atas lainnya.

Contoh

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
}

Definisi

Nama	Deskripsi
AttributeDescriptor	Mengidentifikasi atribut dengan nama dan kontainer.
AttributesContainer	Menyimpan sekumpulan atribut profil bernama.
CoreProfileAttribute	Atribut profil yang selalu memiliki nilai untuk setiap profil.
Profile	Profil pengguna.
ProfileAttribute	Objek bernama yang terkait dengan profil.
ProfileState	Status profil saat ini.

AttributeDescriptor

Mengidentifikasi atribut dengan nama dan kontainer.

Nama	Jenis	Deskripsi
attributeName	string	Nama atribut .
containerName	string	Kontainer tempat atribut berada.

AttributesContainer

Menyimpan sekumpulan atribut profil bernama.

Nama	Jenis	Deskripsi
attributes	<string, ProfileAttribute>	Atribut yang disimpan oleh kontainer.
containerName	string	Nama kontainer.
revision	integer	Jumlah revisi maksimum atribut apa pun dalam kontainer.

CoreProfileAttribute

Atribut profil yang selalu memiliki nilai untuk setiap profil.

Nama	Jenis	Deskripsi
descriptor	AttributeDescriptor	Pendeskripsi atribut .
revision	integer	Nomor revisi atribut.
timeStamp	string	Waktu atribut terakhir diubah.
value	string	Nilai atribut

Profile

Profil pengguna.

Nama	Jenis	Deskripsi
applicationContainer	AttributesContainer	Atribut profil ini.
coreAttributes	<string, CoreProfileAttribute>	Atribut inti profil ini.
coreRevision	integer	Jumlah revisi maksimum dari atribut apa pun.
id	string	Pengidentifikasi unik profil.
profileState	ProfileState	Status profil saat ini.
revision	integer	Jumlah revisi maksimum dari atribut apa pun.
timeStamp	string	Waktu di mana profil ini terakhir diubah.

ProfileAttribute

Objek bernama yang terkait dengan profil.

Nama	Jenis	Deskripsi
descriptor	AttributeDescriptor	Pendeskripsi atribut .
revision	integer	Nomor revisi atribut.
timeStamp	string	Waktu atribut terakhir diubah.
value	string	Nilai atribut

ProfileState

Status profil saat ini.

Nama	Jenis	Deskripsi
custom	string	Profil sedang digunakan.
customReadOnly	string	Profil sedang digunakan, tetapi hanya dapat dibaca.
readOnly	string	Profil hanya dapat dibaca.

Share via