Groups - Add Group User

Belirtilen kullanıcıya belirtilen çalışma alanı için belirtilen izinleri verir.

İzinler

Bu API çağrısı bir hizmet sorumlusu profili tarafından çağrılabilir. Daha fazla bilgi için bkz. Power BI Embeddedhizmet sorumlusu profilleri.

Workspace.ReadWrite.All

Çalışma alanlarının kullanıcı izinlerinin güncelleştirilmesi zaman alır ve API çağrıları kullanılırken hemen kullanılamayabilir. Kullanıcı izinlerini yenilemek için Kullanıcı İzinlerini Yenile API çağrısını kullanın.
Her çalışma alanı, çalışma alanı rollerindeki (Yönetici, Üye, Katkıda Bulunan, Görüntüleyici) en fazla 1.000 kullanıcı veya grupla sınırlıdır. Bir grup içindeki kullanıcı sayısı sınırlı değildir. Sınırlama, dış konukları da kapsar.

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/users

Name	İçinde	Gerekli	Tür	Description
groupId	path	True	string (uuid)	Çalışma alanı kimliği

Name	Gerekli	Tür	Description
groupUserAccessRight	True	GroupUserAccessRight	Kullanıcının çalışma alanında sahip olduğu erişim hakkı (izin düzeyi)
identifier	True	string	Sorumlunun tanımlayıcısı
principalType	True	PrincipalType	Asıl tür
displayName		string	Sorumlunun görünen adı
emailAddress		string	Kullanıcının e-posta adresi
graphId		string	Microsoft Graph'ta sorumlunun tanımlayıcısı. Yalnızca yönetici API'leri için kullanılabilir.
profile		ServicePrincipalProfile	Power BI hizmet sorumlusu profili. Yalnızca Power BI Embedded çok kiracılı çözümüiçin geçerlidir.
userType		string	Kullanıcının türü.

Name	Tür	Description
200 OK		Tamam

Example

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

{
  "identifier": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "groupUserAccessRight": "Admin",
  "principalType": "App"
}

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

{
  "emailAddress": "john@contoso.com",
  "groupUserAccessRight": "Admin"
}

Name	Description
GroupUser	Çalışma alanına erişimi olan bir Power BI kullanıcısı
GroupUserAccessRight	Kullanıcının çalışma alanında sahip olduğu erişim hakkı (izin düzeyi)
PrincipalType	Asıl tür
ServicePrincipalProfile	Power BI hizmet sorumlusu profili. Yalnızca Power BI Embedded çok kiracılı çözümüiçin geçerlidir.

Object

Çalışma alanına erişimi olan bir Power BI kullanıcısı

Name	Tür	Description
displayName	string	Sorumlunun görünen adı
emailAddress	string	Kullanıcının e-posta adresi
graphId	string	Microsoft Graph'ta sorumlunun tanımlayıcısı. Yalnızca yönetici API'leri için kullanılabilir.
groupUserAccessRight	GroupUserAccessRight	Kullanıcının çalışma alanında sahip olduğu erişim hakkı (izin düzeyi)
identifier	string	Sorumlunun tanımlayıcısı
principalType	PrincipalType	Asıl tür
profile	ServicePrincipalProfile	Power BI hizmet sorumlusu profili. Yalnızca Power BI Embedded çok kiracılı çözümüiçin geçerlidir.
userType	string	Kullanıcının türü.

Listeleme

Kullanıcının çalışma alanında sahip olduğu erişim hakkı (izin düzeyi)

Değer	Description
None	Çalışma alanı içeriğine erişim yok
Member	Çalışma alanı içeriğine erişim haklarını okuma, yeniden paylaşma ve keşfetme (ReadReshareExplore)
Admin	Çalışma alanı içeriği için yönetici hakları
Contributor	Çalışma alanı içeriğine erişimi okuma ve keşfetme (ReadExplore)
Viewer	Çalışma alanı içeriğine salt okunur (Okuma) erişimi

Listeleme

Asıl tür

Değer	Description
None	Sorumlu türü yok. Kuruluş düzeyinde erişimin tamamı için kullanın.
User	Kullanıcı asıl türü
Group	Grup sorumlusu türü
App	Hizmet sorumlusu türü

Object

Power BI hizmet sorumlusu profili. Yalnızca Power BI Embedded çok kiracılı çözümüiçin geçerlidir.

Name	Tür	Description
displayName	string	Hizmet sorumlusu profil adı
id	string (uuid)	Hizmet sorumlusu profil kimliği